API Reference2026-02-19.previewPayments
Get the payment status
GET
header
Api-Key<token>id*stringPayment ID
maxPollMs?|Maximum time to long-poll for payment status, in milliseconds.
Format
int64Range
0 <= valueApi-Key*stringMerchant-Id*stringWCP-Version?string|nullSdk-Name?string|nullSdk-Version?string|nullSdk-Platform?string|nullIdempotency-Key?string|nullPayment status retrieved successfully
application/json- response
failureCode?null|info?null|isFinal*booleanTrue if the payment is in a final state and no longer requires polling
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 GET 'https://api.pay.walletconnect.com/v1/payments/pay_7fa2ecc101ARZ3NDEKTSV4RRFFQ69G5FAV/status' \ -H 'Api-Key: string' \ -H 'Merchant-Id: string'{ "failureCode": null, "info": null, "isFinal": true, "pollInMs": 0, "status": "requires_action"}