HTTP 402 Payment Required: wat het betekent en hoe x402 het gebruikt
402 is de HTTP-statuscode voor een verzoek dat betaling nodig heeft voordat de server het afhandelt. Het grootste deel van zijn geschiedenis had de code geen standaardformaat. x402 geeft hem er een.
Key takeaways
-
402 Payment Required is een clientfout: het verzoek zelf is geldig, maar de server wil eerst betaling.
-
HTTP/1.1 reserveerde 402 voor toekomstig gebruik en definieerde nooit hoe betaling zou moeten werken, dus elke API gebruikte de code anders.
-
x402 vult de ontbrekende stukken in: een PAYMENT-REQUIRED-header met machineleesbare voorwaarden en een ondertekende betaling bij een nieuwe poging.
Wat 402 Payment Required betekent
Een 402-respons vertelt de client dat het verzoek zelf in orde is, maar pas wordt uitgevoerd na betaling. De code hoort bij de 4xx-familie omdat de client, niet de server, vervolgens actie moet ondernemen.
402 verschilt van 401 Unauthorized en 403 Forbidden. 401 vraagt om credentials, 403 weigert het verzoek volledig, en 402 vraagt om betaling.
Waarom 402 zo lang ongebruikt bleef
De code werd gereserveerd toen HTTP/1.1 werd geschreven, in de verwachting dat er later een vorm van digitaal geld zou komen. De specificatie zei nooit wat een 402-body moest bevatten of hoe een client moest betalen, dus browsers ondernamen er nooit actie op.
Zonder gedeeld formaat gebruikten API's die wel 402 teruggaven de code als gewone foutmelding: een account had geen credits meer, een kaart werd geweigerd, of een pluslimiet was bereikt.
Wanneer API's vandaag 402 teruggeven
Je komt 402 tegen in twee brede situaties.
- Factureringsfouten van het account: de key is geldig, maar het saldo, het quotum of het abonnement dekt het verzoek niet. De oplossing is opwaarderen of upgraden.
- Offertes voor betaling per verzoek: de server geeft betalingsvoorwaarden terug, en de client kan betalen en hetzelfde verzoek opnieuw proberen. Zo werkt x402.
Hoe x402 van 402 een betalingsflow maakt
x402 zet machineleesbare voorwaarden in een PAYMENT-REQUIRED-header: bedrag, betaalmiddel, netwerk en ontvanger. Een client ondertekent een stablecoin-autorisatie voor die voorwaarden, stuurt die terug in een PAYMENT-SIGNATURE-header en ontvangt de respons met een PAYMENT-RESPONSE-bewijs.
Omdat de hele uitwisseling gewoon HTTP is, kan een AI-agent met een wallet een API-aanroep betalen zonder zich te registreren of een API-key op te slaan.
Een 402 afhandelen in je client
Controleer eerst op een PAYMENT-REQUIRED-header. Is die aanwezig, dan is de respons een x402-offerte en kan een x402-client die betalen. Is die er niet, lees dan de foutmelding: meestal betekent het dat het account meer credits of een ander abonnement nodig heeft.
HTTP 402 FAQ
Is 402 Payment Required een fout?
Het is een clientfout in het 4xx-bereik, maar dat betekent niet dat het verzoek onjuist was opgebouwd. Het betekent dat betaling nodig is voordat de server verdergaat.
Wat is het verschil tussen 402 en 401?
401 betekent dat de server geldige credentials nodig heeft. 402 betekent dat de server betaling nodig heeft. Een API kan 401 teruggeven voor een foute key en 402 voor een geldige key zonder saldo.
Handelen browsers 402 automatisch af?
Nee. Browsers tonen een 402 als elke andere foutpagina. Automatische betaling vereist een client die een protocol zoals x402 begrijpt.
Welke API's gebruiken 402 met x402?
Elke server die het x402-protocol implementeert. RunAPI geeft x402-offertes terug op zijn endpoints per aanroep voor AI-modellen, zodat een agent kan betalen voor het genereren van beeld, video, muziek en audio in USDC.
Gerelateerde pagina's
Probeer een 402 die je echt kunt betalen
Stuur een verzoek naar een RunAPI-endpoint per aanroep zonder key en bekijk de x402-offerte die wordt teruggegeven.