Skip to main content
POST
/
v1
/
gateway
/
payment
/
{id}
/
confirm
Confirm a payment
curl --request POST \
  --url https://api.pay.walletconnect.com/v1/gateway/payment/{id}/confirm \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Sdk-Name: <sdk-name>' \
  --header 'Sdk-Platform: <sdk-platform>' \
  --header 'Sdk-Version: <sdk-version>' \
  --data '
{
  "collectedData": {
    "fields": [
      {
        "id": "fullName",
        "value": "John Smith"
      },
      {
        "id": "dob",
        "value": "1990-01-01"
      }
    ]
  },
  "optionId": "opt_123",
  "results": [
    {
      "data": [
        "0x123"
      ],
      "type": "walletRpc"
    }
  ]
}
'
{
  "isFinal": true,
  "pollInMs": null,
  "status": "succeeded"
}

Authorizations

Api-Key
string
header
required

Headers

Api-Key
string
required
Sdk-Name
string
required
Sdk-Version
string
required
Sdk-Platform
string
required

Path Parameters

id
string
required

Payment ID

Query Parameters

maxPollMs
integer<int64> | null

Maximum time to long-poll for payment status, in milliseconds.

Required range: x >= 0

Body

application/json
optionId
string
required

ID of the option to confirm

results
object[]
required
collectedData
object

Response

Payment confirmed successfully

isFinal
boolean
required

True if the payment is in a final state and no longer requires polling

status
enum<string>
required

Payment status

Available options:
requires_action,
processing,
succeeded,
failed,
expired
pollInMs
integer<int64> | null

Time to poll for payment status, in milliseconds. Not present if the payment is in a final state.

Required range: x >= 0