x402 · IMPLEMENTATION GUIDE
x402 atomic-asset verification before payment
Verify an exact, normalized x402 pre-payment projection with atomic-unit caps, substitution-resistant bindings and durable replay controls.
What the protocol establishes
The hosted bridge maps a selected x402 v2 PAYMENT-REQUIRED offer into a non-executable verification projection and never handles a payment credential. The optional first-party customer-side exact/EIP-3009 Gate can create one payload through the customer's compatible client, verify its signer locally, submit the bound HTTP request once and reconcile canonical chain evidence. It is not a facilitator or hosted settlement service.
Official Coinbase x402 documentation ↗Five checks before execution
- Normalize the selected payment requirement into the final verification envelope.
- Send atomic_units as a canonical decimal string and compare it with the registered cap using exact integer semantics.
- Match asset_id, network, resource and asset_decimals exactly to the registered mandate.
- Bind the payee and consume a stable payment-attempt identifier once.
- Require the complete live authorization invariant before constructing or submitting payment.
- For the optional exact/EIP-3009 Gate, persist the signed payload before transmission and commit only from fully bound canonical chain proof.
The gap MandateShield closes
A numerically rounded amount or a substituted asset, network, resource or decimal exponent can change what the user buys. A valid x402 flow is not by itself user authorization.
MandateShield normalizes execution facts and returns a deterministic decision with exact findings. Strict v2 verifies supported evidence and returns an ES256-signed receipt with public transparency; it complements the protocol's wider trust and settlement chain.
Test the normalized payment boundary
No account and no payment credentials required. Change the amount, merchant or consent and inspect the machine-readable result.
Open free validator →