Before integrating, complete merchant onboarding to obtain your API Key and Merchant ID.
How It Works
Your backend creates a payment via a single API call and redirects the buyer to the WalletConnect Pay checkout portal. The buyer connects their wallet, selects a payment option, and completes the transaction. After payment, the buyer is redirected back to your site and you verify the result server-side.- Your backend calls
POST /v1/merchant/paymentwith the order amount and redirect URLs - You redirect the buyer to the checkout portal using the
gatewayUrlfrom the response - The buyer connects their wallet, picks a token and network, and signs the transaction
- The checkout portal redirects the buyer back to your
successUrlorerrorUrl - Your backend verifies the payment status via
GET /v1/merchant/payment/{id}/status
What does WalletConnect Pay offer for ecommerce?
Any wallet. Any asset. One checkout flow.
Let customers pay online using the wallets and assets they already use, all through a single, consistent checkout experience.
A checkout flow that fits existing stacks
WalletConnect Pay is designed to fit cleanly into existing checkout and operations workflows. It can align with PSP compliance requirements (like required information capture and screening steps) and follows payment patterns customers already recognize and trust.
Built-in incentives to encourage usage
WalletConnect Pay can provide rewards that give customers a reason to choose WalletConnect Pay at checkout—supporting adoption with no added effort from merchants or PSPs.
Smarter economics for online payments
Support higher-value online transactions, reduce acceptance costs, and settle faster with flexible crypto or fiat payouts.
Get Started
Integration Guide
Step-by-step guide to integrate WalletConnect Pay checkout into your site.
API Reference
Merchant API endpoint reference for creating and verifying payments.
Merchant Onboarding
Set up your merchant account and obtain your API credentials.
Example Implementation
Full-stack Next.js reference implementation.