Skip to content

page.mdx

Latest commit

 

History

History
64 lines (49 loc) · 3.06 KB

page.mdx

File metadata and controls

64 lines (49 loc) · 3.06 KB

import { Guides } from '@/components/Guides' import { Widgets } from '@/components/Widgets' import { HeroPattern } from '@/components/HeroPattern'

export const metadata = { title: 'ICPay SDK & Widget Documentation', description: 'Use the ICPay SDK to accept payments from users wallets and manage your account operations. Choose between our Public SDK for frontend payment flows, Private SDK for server-side account management, or Widget Components for quick payment UI integration.', }

export const sections = [ { title: 'Guides', id: 'guides' }, { title: 'Widget Components', id: 'widgets' }, ]

Welcome to ICPay Docs

Use the ICPay SDK to accept payments from users' wallets and manage your account operations. Choose between our Public SDK for frontend payment flows, Private SDK for server-side account management, or Widget Components for quick payment UI integration. ICPay is multichain: Internet Computer, EVM, and Solana. {{ className: 'lead' }}

<>Get Started <>Explore Widgets

Getting started {{ anchor: false }}

The ICPay SDK ships as a single package that supports two usage modes. Use the public SDK on the frontend with your Publishable Key; use the private SDK on the server with your Secret Key. {{ className: 'lead' }}

Public SDK (frontend): Initialize with publishableKey for typical tasks like getting verified ledgers, resolving canister IDs, price calculation, and initiating payments from the user's wallet via createPayment/createPaymentUsd.

Private SDK (server): Initialize with secretKey for account details, payment history, transactions, ledgers with prices for your account, webhook event lookups, and other server-side operations.

Widget Components: For quick payment UI integration, use our framework-agnostic Web Components that let you accept payments without building UI flows from scratch. Perfect for tips, premium content, donation thermometers, and shop items.

<>Public SDK Guide <>Private SDK Guide <>Widget Components <>Supported tokens (IC/EVM/Solana)

What’s new

  • Solana chain and tokens are now supported across SDK and Widget.
  • Relay payments: accept and forward funds directly to your per‑chain recipient addresses. See Relay payments.
  • X402 v2: ICPay includes its own facilitator for X402 flows (IC and EVM). See X402 payments.
  • Agentic X402 up-to payments: usage-based and long-running jobs with capped authorizations and deferred settlement. See Agentic X402 up-to payments.