# WalletConnect Pay Docs

> Documentation for WalletConnect Pay. Integrate secure crypto payments into your app with step-by-step guides, APIs, and best practices.

## Docs

- [WalletConnect Agents SDK](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/agents/overview.md)
- [Delete a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/delete-v1-merchants-merchantid.md): Soft-delete a merchant. The merchant is hidden from listings and can no longer accept new payments. Already-deleted merchants return `deleted: true` so the call is idempotent.
- [Delete a crypto settlement](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/delete-v1-merchants-merchantid-settlements-crypto-id.md): Remove a crypto settlement. Future payments in the deleted asset will no longer be auto-settled.
- [Get a payment](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-gateway-payment-id.md): This endpoint returns only basic information to display to the user to begin the payment flow.
- [Get the payment status](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-gateway-payment-id-status.md): Retrieves the status of a payment by its ID. Returns a polling delay to wait before checking the status again.
- [List merchants](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-merchants.md): List the partner's merchants. Supports filtering by `status`, free-text `search` over name and ID, and cursor-based pagination via `cursor` and `limit`.
- [Get payments for a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-merchants-merchant-id-payments.md): **Deprecated:** Use `GET /v1/merchants/payments` with partner `api-key` and `merchant-id` headers instead.
- [Get a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-merchants-merchantid.md): Fetch a merchant's profile along with its configured `settlements` (crypto and fiat). Crypto settlements use [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) asset IDs and [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) destination accounts.
- [List settlements](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-merchants-merchantid-settlements.md): List the merchant's configured fiat and crypto settlement destinations.
- [List payments for a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-merchants-payments.md): Retrieve paginated payments with optional filters.
- [List payments](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-payments.md): Retrieve paginated payments with optional filters.
- [Get payment details](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-payments-id.md): Retrieves the full details of a payment by its ID, including settlement information when available.
- [Get the payment status](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/get-v1-payments-id-status.md): Retrieves the status of a payment by its ID. Returns a polling delay to wait before checking the status again.
- [Update a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/patch-v1-merchants-merchantid.md): Update a merchant's profile. At least one of `merchantName`, `merchantEmail`, or `iconUrl` must be provided. Pass `iconUrl: null` to unset the existing logo.
- [POST /v1/gateway/payment/{id}/cancel](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-gateway-payment-id-cancel.md)
- [Confirm a payment](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-gateway-payment-id-confirm.md): This endpoint confirms a payment and submits it to the blockchain for processing.
- [Fetches an action](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-gateway-payment-id-fetch.md): This endpoint fetches an action for a payment.
- [Get payment options](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-gateway-payment-id-options.md): This endpoint takes a list of accounts and returns a list of options that can be used to complete the payment.
- [Create a merchant](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-merchants.md): Create a new merchant under the authenticated partner. Requires an `Idempotency-Key` header so retries safely return the originally-created merchant rather than creating duplicates.
- [Create crypto settlements](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-merchants-merchantid-settlements-crypto.md): Register one or more crypto settlement destinations for the merchant. Each entry pairs a [CAIP-19](https://chainagnostic.org/CAIPs/caip-19) `asset` with a [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) `destination` wallet on the same chain. Each `(merchant, asset)` pair must be unique — registe…
- [Create a new payment](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-payments.md): Creates a new payment with the provided payment details.
- [POST /v1/payments/{id}/cancel](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-payments-id-cancel.md)
- [Mark a payment as refunded](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/post-v1-refunds.md): Request a full refund for a payment. Calling a second time on the same payment returns 409.
- [Update a crypto settlement destination](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/2026-02-18/put-v1-merchants-merchantid-settlements-crypto-id.md): Change the destination wallet for an existing crypto settlement. The new `destination` must be a [CAIP-10](https://chainagnostic.org/CAIPs/caip-10) account on the same chain as the settlement's `asset`.
- [API Reference](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/index.md): Reference for the WalletConnect Pay API.
- [API Versioning](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api-reference/versioning.md): How the WalletConnect Pay API is versioned using date-based versions, account pinning, and preview releases.
- [WalletConnect Pay for Ecommerce and Online Checkout](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/ecommerce/overview.md)
- [How to Pay with WalletConnect Pay](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/for-users.md)
- [Merchant Onboarding](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/merchant/onboarding.md)
- [WalletConnect Pay](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/overview.md)
- [Token and Chain Coverage](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/token-and-chain-coverage.md): Tokens and blockchains supported in General Availability within WalletConnect Pay, including acceptance and settlement options.
- [API-first integration (Non-SDK wallets)](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/api-first.md): Integrate WalletConnect Pay in a wallet without an SDK, using the Gateway API.
- [WalletConnect Pay - Wallet Integration](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/overview.md)
- [WalletConnect Pay SDK - Flutter](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/standalone/flutter.md): Integrate WalletConnect Pay into your Flutter wallet to enable seamless crypto payments for your users.
- [WalletConnect Pay SDK - Kotlin](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/standalone/kotlin.md): Integrate WalletConnect Pay into your Android wallet to enable seamless crypto payments for your users.
- [WalletConnect Pay SDK - React Native](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/standalone/react-native.md): Integrate WalletConnect Pay into your React Native wallet to enable seamless crypto payments for your users.
- [WalletConnect Pay SDK - Swift](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/standalone/swift.md): Integrate WalletConnect Pay into your iOS wallet to enable seamless crypto payments for your users.
- [WalletConnect Pay SDK - Web/Node.js](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/standalone/web.md): Integrate WalletConnect Pay into your Web/Node.js wallet to enable seamless crypto payments for your users.
- [USDT support](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/usdt-support.md): Implement the two-action Permit2 flow your wallet needs to accept USDT and other ERC-20s without native typed-data authorization.
- [WalletConnect Pay via WalletKit - Flutter](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/walletkit/flutter.md): Integrate WalletConnect Pay through WalletKit for a unified payment experience in your Flutter wallet.
- [WalletConnect Pay via WalletKit - Kotlin](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/walletkit/kotlin.md): Integrate WalletConnect Pay through WalletKit for a unified payment experience in your Android wallet.
- [WalletConnect Pay via WalletKit - React Native](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/walletkit/react-native.md): Integrate WalletConnect Pay through WalletKit for a unified payment experience in your React Native wallet.
- [WalletConnect Pay via WalletKit - Swift](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/walletkit/swift.md): Integrate WalletConnect Pay through WalletKit for a unified payment experience in your iOS wallet.
- [WalletConnect Pay via WalletKit - Web/Node.js](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/payments/wallets/walletkit/web.md): Integrate WalletConnect Pay through WalletKit for a unified payment experience in your Web/Node.js wallet.

## OpenAPI Specs

- [2026-02-19.preview](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api/2026-02-19.preview.json)
- [2026-02-18](https://walletconnect-pay-docs-docs-add-ai-agent-sdk-section.mintlify.app/api/2026-02-18.json)

## Optional

- [WalletConnect Pay](https://walletconnect.com)
- [Blog](https://walletconnect.network/blog)