Verify an x402 payment payload

Verifies that an x402 payment payload can be processed by running all read-only validation checks (scheme, network, token, signature, temporal constraints, address/amount matching). A valid result does not guarantee settlement — balance and nonce checks only happen at settle time.

POST /v1/x402/verify

Verify an x402 payment payload

cURL

curl --request POST \
  --url https://gateway-api-testnet.circle.com/v1/x402/verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "paymentPayload": {
    "x402Version": 1,
    "accepted": {
      "scheme": "exact",
      "network": "base-sepolia",
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "amount": "1000000",
      "payTo": "0x1234567890abcdef1234567890abcdef12345678",
      "maxTimeoutSeconds": 3600,
      "extra": {}
    },
    "payload": {},
    "extensions": {}
  },
  "paymentRequirements": {
    "scheme": "exact",
    "network": "base-sepolia",
    "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "amount": "1000000",
    "payTo": "0x1234567890abcdef1234567890abcdef12345678",
    "maxTimeoutSeconds": 3600,
    "extra": {}
  }
}
'

200

{
  "isValid": true,
  "invalidReason": "<string>",
  "payer": "<string>"
}

Body

application/json

paymentPayload · object · required

x402 payment payload containing the payment authorization and metadata.

Show child attributes

paymentRequirements · object · required

Defines an acceptable way to pay for a resource using the x402 protocol.

Show child attributes

Response

200

application/json

Verification result

isValid · boolean

Whether the payment payload passed all validation checks.

invalidReason · string

Reason for validation failure. Present when isValid is false.

payer · string

The payer address extracted from the payment payload.