API Reference2026-02-19.previewPayments
Create a new payment
POST
header
Api-Key<token>Api-Key*stringMerchant-Id*stringWCP-Version?string|nullSdk-Name?string|nullSdk-Version?string|nullSdk-Platform?string|nullIdempotency-Key?string|nullapplication/json- body
amount*Amount to be paid
checkout?null|expiresAt?|Optional custom expiration timestamp (Unix seconds since epoch). Must be in the future if provided. If not provided, defaults to 5 minutes from now.
Format
int64referenceId*stringMerchant/PSP order ID
Payment created successfully
application/json- response
expiresAt*integerPayment expiration timestamp, in seconds since epoch
Format
int64Range
0 <= valuegatewayUrl*stringGateway URL to redirect the user to for payment
isFinal*booleanTrue if the payment is in a final state and no longer requires polling
paymentId*PaymentIdPayment ID
pollInMs?|Time to poll for payment status, in milliseconds. Not present if the payment is in a final state.
Format
int64Range
0 <= valuestatus*PaymentStatusPayment status
Value in
"requires_action""processing""succeeded""failed""expired""cancelled"curl -X POST 'https://api.pay.walletconnect.com/v1/payments' \ -H 'Api-Key: string' \ -H 'Merchant-Id: string' \ -H 'Content-Type: application/json' \ -d '{ "amount": { "unit": "string", "value": "string" }, "referenceId": "string"}'{ "expiresAt": 0, "gatewayUrl": "string", "isFinal": true, "paymentId": "pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV", "pollInMs": 0, "status": "requires_action"}