Laat AI-agents je facturen betalen
X402 is een open betalingsprotocol dat de HTTP 402-statuscode gebruikt zodat AI-agents autonoom voor resources kunnen betalen. Geen afrekenpagina, geen menselijke klik, geen API-sleuteluitwisseling — alleen USDC op Base dat direct naar jouw wallet gaat.
# No payment header yet
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"error": "payment_required",
"accepts": [{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000000",
"payTo": "0xYourWalletAddress",
"maxTimeoutSeconds": 30
}]
}HTTP/1.1 200 OK
X-Payment-Response: base64(receipt)
{
"success": true,
"onchain_tx": "0xTxHash…",
"payer": "0xAgentWalletAddress",
"amount_usdc": 5.00
}HTTP 402 — de statuscode die altijd bedoeld was voor betalingen
De 402 Payment Required-statuscode was gereserveerd in HTTP/1.1 in 1996 maar nooit gestandaardiseerd. X402 geeft hem eindelijk een echte implementatie: een verzoek, een betalingsvereiste-respons, een ondertekende autorisatie en een afrekening — allemaal in één round trip.
Vier stappen, nul menselijke klikken
Een agent kan je betalingsvereisten ontdekken, een off-chain autorisatie ondertekenen en USDC naar jouw wallet afrekenen in één round trip. PayRequest verzorgt verificatie en broadcast — jij ontvangt gewoon de fondsen.
Agent ontdekt je endpoint
De agent leest je payments.txt-manifest en vindt je x402_payment_endpoint. Of hij roept de discovery-JSON op bij x402_discovery_url voor het volledige betalingsvereisten-object.
Agent ontvangt een 402-respons
De agent POSTt zonder betaalheader. PayRequest antwoordt 402 met een JSON-body: het exacte USDC-bedrag, je walletadres, ondersteund netwerk en een time-outvenster.
Agent ondertekent off-chain
De agent ondertekent een ERC-3009 transferWithAuthorization-bericht met zijn wallet. Geen gas, geen on-chain transactie — alleen een cryptografische autorisatie.
PayRequest verifieert en rekent af
De agent herprobeert met een X-Payment-header. PayRequest verifieert de handtekening, zendt de USDC-overdracht uit op Base en antwoordt 200 met de on-chain transactiehash.
Agents kunnen specifieke facturen autonoom betalen
Elke factuur heeft een eigen X402-endpoint. Een agent die je factuur-e-mail ontvangt, kan de factuur-ID extraheren, betalen via X402 en de factuur sluit — allemaal zonder dat een mens de checkout aanraakt.
De 402-respons bevat het exacte factuurbedrag. Bij succes wordt de factuur automatisch als betaald gemarkeerd in PayRequest.
Fondsen gaan direct naar jouw wallet — PayRequest is alleen een relay
PayRequest verifieert de handtekening van de agent en zendt transferWithAuthorization uit op het USDC-contract. Fondsen gaan direct van de wallet van de agent naar die van jou. Geen tussenpersoon, geen bewaarrisico, geen wachttijden.
Base, Base Sepolia en Solana
| Network | Token | Chain ID | Status |
|---|---|---|---|
| Base (mainnet) | USDC | eip155:8453 | Live |
| Base Sepolia (testnet) | USDC | eip155:84532 | Testnet |
| Solana (mainnet) | USDC | solana:5eykt4... | Live |
Een agent bouwen die PayRequest-gebruikers betaalt?
De volledige protocolspecificatie is compatibel met de open X402-spec gepubliceerd door Coinbase. Elke agent gebouwd tegen die spec werkt out-of-the-box met PayRequest.
X402 open spec on GitHubOntdekken
GET payrequest.me/{handle}/payments.txt of het JSON discovery-endpoint voor volledige betalingsvereisten.
Vereisten ophalen
POST naar het betaal-endpoint, verwacht een 402-respons met bedrag, asset, netwerk en payTo-adres.
Ondertekenen
Gebruik viem, ethers.js of een EIP-712-bibliotheek om TransferWithAuthorization te ondertekenen.
Betalen
Probeer de POST opnieuw met de X-Payment-header die je base64-gecodeerde handtekening bevat.
Bevestigen
200-respons + X-Payment-Response-header = afgerekend. De on-chain TX-hash staat in de respons-body.
Veelgestelde vragen
Is dit hetzelfde X402 als van Coinbase?
Ja. PayRequest implementeert de open X402-spec gepubliceerd door Coinbase. Elke agent gebouwd tegen die spec werkt met PayRequest. Je hebt geen Coinbase-account nodig.
Heeft de agent gas nodig?
Ja — een kleine hoeveelheid ETH op Base (ongeveer $0,001 per afrekening). De wallet van de agent heeft ETH nodig voor gas. Base is extreem goedkoop.
Welke wallets kunnen agents gebruiken?
Elke EVM-compatibele wallet die EIP-712 typed data kan ondertekenen. Smart contract wallets (Safe, Coinbase Smart Wallet) worden ook ondersteund.
Wat als verificatie mislukt?
Als de handtekening ongeldig, verlopen of het bedrag te laag is, retourneert PayRequest een nieuwe 402 met een verification_error-veld dat uitlegt wat er misging.
Kan ik eerst op een testnet testen?
Ja. Gebruik Base Sepolia testnet USDC om X402-betalingen te testen voordat je live gaat. Het testnet-endpoint wordt automatisch gebruikt wanneer je account in testmodus staat.
Moet ik dit inschakelen?
Koppel je EVM-wallet in Provider Instellingen en je X402-endpoints zijn direct live. Geen aparte functievlag om in te schakelen.
Jouw facturen, betaald door agents
Koppel je EVM-wallet om X402-endpoints te activeren. AI-agents kunnen je facturen autonoom betalen — geen checkout, geen achtervolgen, gewoon USDC dat naar jouw wallet gaat.