POST /x402/settle - Execute and confirm payment

This endpoint verifies payment and waits for blockchain confirmation. For Celestia, the transaction is already broadcast by the user (via Keplr), so “settle” means verifying it exists and waiting for confirmation.

POST /x402/settle

POST /x402/settle - Execute and confirm payment

cURL

curl --request POST \
  --url https://api.example.com/x402/settle \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentHeader": "<string>",
  "paymentRequirements": "<unknown>",
  "x402Version": 1
}
'

200

{
  "success": true,
  "error": "<string>",
  "networkId": "<string>",
  "txHash": "<string>"
}

Body

application/json

paymentHeader · string · required

paymentRequirements · any · required

x402Version · integer<int32> · required

Required range: x >= 0

Response

200 - application/json

Payment settlement result

success · boolean · required

error · string | null

networkId · string | null

txHash · string | null