Skip to main content
POST
Verify an x402 v2 payment payload

Body

application/json
paymentPayload
object
required

x402 v2 structured PaymentPayload object. For backward compatibility, a base64-encoded v1 proof string is also accepted.

paymentRequirements
object
required

The payment requirements issued by the resource server in the 402 response

Response

Verification result — check isValid to determine success

isValid
boolean
required

Whether the payment payload passed verification

Example:

true

invalidReason
string

Machine-readable reason code for invalid payments

Example:

"AMOUNT_MISMATCH"

invalidMessage
string

Human-readable explanation of why verification failed

Example:

"Expected amount 1000000, got 500000"

payer
string

Wallet address of the payer (extracted from transaction)

Example:

"D6j5dis544qzYmSNixwYwBXqcDqgWiFHpi6hebPEQNVu"

extensions
object

Additional extension data (e.g. x84 settlement mode)

Example: