Verify an x402 payment
Verifies the buyer’s signed authorization and the payment payload without creating a payment, consuming keyless trial usage, or submitting anything onchain. Use before Settle an x402 payment to catch problems early.
For upto, amount must equal the maximum the buyer signed.
Example signatures come from a public test key. Never fund it.
Authorizations
Body
x402 v2 payment payload. Includes the payment terms the buyer accepted and the signed authorization for the USDC transfer: an EIP-3009 authorization for exact, or a Permit2 authorization for upto.
For upto, the payload sent to /settle must match the payload sent to /verify. The seller can only vary paymentRequirements.amount between calls.
Response
Verification result
Reason code. Present when isValid is false.
invalid_x402_version, unsupported_scheme, invalid_network, invalid_payment_requirements, invalid_payload, invalid_exact_evm_payload_recipient_mismatch, invalid_exact_evm_payload_authorization_value_mismatch, invalid_exact_evm_payload_authorization_valid_after, invalid_exact_evm_payload_authorization_valid_before, invalid_exact_evm_payload_signature, invalid_transaction_state, insufficient_funds, invalid_permit2_spender, invalid_permit2_recipient_mismatch, permit2_token_mismatch, permit2_amount_mismatch, permit2_not_yet_valid, permit2_deadline_expired, upto_facilitator_mismatch, invalid_permit2_signature, permit2_invalid_nonce, invalid_eip2612_extension_format, eip2612_from_mismatch, eip2612_asset_mismatch, eip2612_spender_not_permit2, eip2612_deadline_expired, permit2_2612_amount_mismatch, permit2_simulation_failed "invalid_exact_evm_payload_signature"