NL

Hoe betaling werkt

De API gebruikt x402 (HTTP 402 Payment Required) met het schema exact. Afrekening is in USDC op Base ({network}). Er is geen account en geen API-sleutel.

Volgorde

  1. Roep GET of POST aan op een betaald pad zonder betalingsheader.
  2. Lees de 402-JSON-body (en de PAYMENT-REQUIRED-header). accepts[].amount is de prijs in atomaire USDC-eenheden (6 decimalen).
  3. Bouw een ondertekende x402-betalingspayload voor payTo {payTo}, asset {asset}.
  4. Herhaal hetzelfde verzoek met header PAYMENT-SIGNATURE of X-PAYMENT.

Voorbeeld van een 402-challenge

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402-gateway.forge-x402.workers.dev/api/iban",
    "description": "IBAN validation (ISO 13616 mod-97 checksum + per-country length), returns normalised IBAN, country and BBAN.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "1000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Betalen met een x402-client

De eenvoudigste weg is @x402/fetch (v2) met @x402/evm, dat de 402 opnieuw probeert met een ondertekende betaling. Zie Probeer het in 1 aanroep. Probeer het in 1 aanroep.

MCP

Dezelfde tools staan op {mcp} (Streamable HTTP, toestandsloos). Betaling gaat via MCP _meta met @x402/mcp. list_endpoints is gratis. Mislukte toolaanroepen worden niet vereffend.

Loyaliteit

Een tegoedregeling (elke 10 vereffende aanroepen van één betaleradres = 1 gratis aanroep) is alleen gepland: het grootboek wordt niet gevoed vanuit de gateway. Zie de loyaliteitstoelichting. Lees de toelichting.