Ga naar hoofdinhoud
PERSONA 2 VARIANT - API-PROVIDERS

Verkoop je API aan AI-agenten.

AI agents kunnen geen creditcardformulier invullen. Ze kunnen je betalen in USDC. Blockchain0x maakt die ene API-aanroep.

DE PIJN

Je API is ontworpen voor mensen. Je aanroepers zijn nu agents.

Het komende decennium van API-inkomsten zal niet komen van menselijke aanmeldingen. Het zal komen van AI-agenten die API's aanroepen namens hun gebruikers, vaak programmatisch en zonder enige mens in de lus. Die agenten kunnen je bestaande checkout niet gebruiken. Ze kunnen geen creditcardformulier invullen, geen account aanmaken, geen bevestigingsmail klikken, geen wachtwoord onthouden.

Wat ze kunnen doen is een 402 Payment Required-respons lezen, het USDC-bedrag en de ontvanger uit de JSON-body parseren, betalen op Base, en de oproep opnieuw uitgeven met bewijs van betaling. Dat is de gehele vorm van agent-gedreven API-handel. Het kostenmodel (per-oproep facturering in stablecoin) past ook veel beter bij het gebruik van agents dan kaartgebaseerde abonnementen: kaarten falen bij transacties onder de $1; USDC op Base kost centen aan gas; terugboekingen komen niet voor tussen machines.

Blockchain0x is de brug. Lijst de routes waarvoor u kosten wilt in rekening brengen in een prijzentabel en monteer de x402-adapter. Wanneer een onbetaalde oproep een geprijsde route raakt, retourneert de adapter een 402 die precies beschrijft wat te betalen. De agent betaalt op Base en probeert het opnieuw met een X-Payment-header; de adapter verifieert het en uw handler draait. U verzamelt USDC en draait uw API zoals voorheen. Niets aan uw bedrijfslogica verandert; de factureringslaag rijdt mee.

402 BETALING VEREIST

De HTTP-statuscode heeft eindelijk een gebruik.

HTTP 402 was reserved in the original spec for "future use" and never standardized. For thirty years it sat unused while the internet built per-account subscription billing on top of 200/401/403. With Coinbase's x402 protocol, 402 finally has a standard implementation: any API that needs payment-before-it-runs can return a structured 402, and any client that understands the spec can pay and retry.

JE API RETOURNEERT DEZE 402 BODY WANNEER EEN AANROEP NIET IS BETAALD
HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "resource": "POST /api/expensive-operation",
  "accepts": [
    {
      "scheme": "exact-usdc",
      "network": "mainnet",
      "chainId": "eip155:8453",
      "payToAddress": "0xYourAgentWalletAddress",
      "amountWeiUsdc": "500000",
      "paymentRequestId": "pr_demo",
      "maxAgeSeconds": 60
    }
  ]
}

Wat de accepts[] vereiste betekent

  • schema - het betalingsschema. exact-usdc betekent een exact USDC-bedrag op een EVM-keten. De klant matcht hierop voordat hij betaalt.
  • netwerk / chainId - de keten waarop moet worden verrekend (mainnet is Base, CAIP-2 eip155:8453). Een migratie kan beide netwerken citeren door twee vereisten in accepts op te sommen.
  • payToAddress / amountWeiUsdc - de ontvanger wallet en het exacte bedrag in USDC basis eenheden (500000 = 0.50 USDC, 6 decimalen). De klant verifieert beide voordat hij betaalt.
  • paymentRequestId - koppelt de betaling aan deze offerte. De adapter weigert een X-Payment die naar een andere paymentRequestId verwijst dan de route die geciteerd is.
  • maxAgeSeconds - hoe vers de betaling moet zijn. Een betaling ouder dan dit venster wordt afgewezen en de beller moet opnieuw betalen.

x402 is machine-to-machine: een x402-bewuste client leest accepts, betaalt de gekozen vereiste on-chain, en heruitgeeft dan de aanvraag met een X-Payment header die de adapter verifieert. Een client die geen x402 spreekt, ontvangt eenvoudig de 402 en krijgt geen resultaat, wat de juiste uitkomst is (de oproep was niet betaald). Er is geen gehoste checkout-pagina in deze stroom; de betaling wordt programmatisch geregeld door de wallet van de beller.

ADAPTERPATROON

Eén prijstabel. Drie talen. Zelfde vorm.

Je monteert één adapter en geeft het een prijstabel die is gecodeerd door METHOD plus pad. Het poort alleen de routes die je vermeldt; je handler ziet nooit een onbetaalde oproep, omdat wanneer het draait de X-Payment-header al is geverifieerd. De vorm is identiek in Python, TypeScript en Go - het X-Payment draadformaat is hetzelfde, zodat een Go-server headers accepteert die zijn gebouwd door een Python-client.

PYTHON (FLASK)
from flask import Flask
from blockchain0x import Client
from blockchain0x_x402.server import x402_before_request_factory, PricingEntry

sdk = Client()  # reads BLOCKCHAIN0X_API_KEY
app = Flask(__name__)

# Only routes named in the pricing table are gated.
app.before_request(x402_before_request_factory(
    sdk=sdk,
    pricing={
        "POST /api/expensive-operation": PricingEntry(
            amount_usdc="0.50",
            pay_to_address="0xYourAgentWalletAddress",
            payment_request_id="pr_demo",
        ),
    },
))

@app.route("/api/expensive-operation", methods=["POST"])
def expensive_operation():
    return run_the_work()  # only runs after X-Payment verifies
TYPESCRIPT (EXPRESS)
import express from "express";
import { createClient } from "@blockchain0x/node";
import { createX402Middleware } from "@blockchain0x/x402/server/express";

const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });
const app = express();

// Only routes named in the pricing table are gated.
app.use(createX402Middleware({
  sdk,
  pricing: {
    "POST /api/expensive-operation": {
      amountUsdc: "0.50",
      payToAddress: "0xYourAgentWalletAddress",
      paymentRequestId: "pr_demo",
    },
  },
}));

app.post("/api/expensive-operation", async (req, res) => {
  res.json(await runTheWork());  // req.x402Payment holds the verified payment
});
GA (NET/HTTP)
import (
  "net/http"
  x402 "tosh-labs/blockchain0x-x402-go"
)

func main() {
  pricing := map[string]x402.PricingEntry{
    "POST /api/expensive-operation": {
      AmountUSDC:       "0.50",
      PayToAddress:     "0xYourAgentWalletAddress",
      PaymentRequestID: "pr_demo",
    },
  }

  // serverSdk is your Blockchain0x Go SDK client.
  h := x402.Middleware(x402.ServerOptions{Sdk: serverSdk, Pricing: pricing})(
    http.HandlerFunc(expensiveOperation))
  http.Handle("/api/expensive-operation", h)
  http.ListenAndServe(":8080", nil)
}

We leveren serveradapters voor Express en Fastify (Node), ASGI (Starlette en FastAPI) en Flask (Python), en Go's net/http. Voor andere frameworks zijn de 402-body en de X-Payment-header gewone HTTP die de wire helpers in @blockchain0x/x402 bouwen en parseren - schrijf de controle met de hand in de idiom van jouw stack. Ruby en JVM x402-pakketten zijn gepubliceerd voor de clientzijde.

VS STRIPE CHECKOUT

Wanneer je elk gereedschap moet gebruiken.

Stripe is het juiste hulpmiddel voor menselijke checkout. Blockchain0x is het juiste hulpmiddel voor agent checkout. Ze lossen verschillende problemen op en zitten vaak zij aan zij op dezelfde API.

DimensieBlockchain0xStripe Checkout
KoperElke HTTP-client (mens of AI-agent)Mens aan een browser
Authenticatie vereist voor betalingNee - de eerste oproep retourneert 402 met de betalingsvereistenJa - e-mail + kaartformulier
Verwerkingsnelheid5 seconden (USDC op Base)2-7 dagen (kaartnetwerken)
Chargeback risicoGeen (USDC is definitief)Tot 120 dagen terugboekingvenster
Per-transactie kostenstructuurWerkt voor $0.01-$0.10 per oproep (Base gas + onze vergoeding)Kaartkosten maken transacties onder de $1 onrendabel
TerugbetalingenHandmatig - je code stuurt USDC terug naar het betaaladresGeautomatiseerd via het Stripe-dashboard
Internationale ondersteuningZelfde portemonnee, elk land, geen extra configuratiePer-land licenties, valutaconversie, regionale regels
Het beste voorProgrammaticale agent-gedreven API-consumptieMens-gedreven checkout (SaaS aanmelding, e-commerce)

Het patroon waar de meeste API-providers op uitkomen: houd Stripe voor de menselijke aanmeldflow (jouw dashboard, jouw abonnementsproductpagina); voeg Blockchain0x toe aan de API-rand voor programmatische agenttoegang. De x402-adapter beperkt alleen de routes die je in zijn prijstabel plaatst, zodat jouw menselijke, Stripe-geauthenticeerde routes onaangetast blijven. Richt agents op de geprijsde routes en mensen op de rest, en beide doelgroepen worden bediend door dezelfde API-code.

WELKE PLANNEN PASSEN

Pro voor vroege traffic. Business wanneer auditlogs een vereiste worden.

API-providers beginnen bijna altijd op Pro vanaf dag één: Gratis is alleen-lezen, en de x402-adapter heeft de API-toegang nodig om betalingen te verifiëren en af te handelen, plus webhooks om ze te volgen. API's met veel verkeer komen in het Business-territorium naarmate het maandelijkse volume stijgt. Zie de prijs pagina voor de exacte kosten per agent en waar de niveaus zich bevinden.

  • Gratis: alleen nuttig voor het dashboard en metadata-verkenning. Alleen lezen, dus de adapter kan geen betalingen afhandelen.
  • Pro: de standaard voor live API-monetisatie. Volledige API-toegang, webhooks, exports.
  • Business: wanneer je audit logs nodig hebt voor compliance, of hogere API rate limits.
Bekijk volledige prijsstelling
VAKANT VRAAG

Vijf vragen van API-providers.

Kan ik Stripe naast Blockchain0x draaien voor dezelfde API?

Ja, en veel API-providers doen dat. Het patroon: houd je bestaande Stripe-gebaseerde menselijke aanmeldflow, en lijst alleen de agentgerichte routes in de x402-prijstabel. De adapter poort precies die routes; alles wat niet in de tabel staat (inclusief de routes die je Stripe-geauthenticeerde klanten aanroepen) gaat recht door, onaangetast. Als je een enkele route wilt die beide bedient, controleer dan je eigen API-sleutel in de handler en sla het geprijsde pad over voor geauthenticeerde bellers. Beide doelgroepen krijgen wat ze willen zonder dat één pad het andere blokkeert.

Wat als een AI-agent betaalt en dan verlaat voordat hij de oproep opnieuw probeert?

De betaling is nog steeds geldig op-chain; het wordt gewoon niet gebruikt. De wallet van de agent toont een succesvolle USDC-overdracht naar jouw adres. Vanuit het perspectief van de agent heeft het de USDC verloren; vanuit jouw perspectief ben je betaald voor een oproep die nooit is uitgevoerd. Dit is zeldzaam in de praktijk (de x402-client probeert onmiddellijk opnieuw na betaling), maar als je defensief wilt zijn, kun je geverifieerde betalingen volgen die nooit een voltooide oproep hebben opgeleverd en de USDC zelf terugsturen met payments.create, waarbij je het oorspronkelijke betaaladres betaalt. Er is geen aparte terugbetalings-eindpunt - een terugbetaling is gewoon een betaling in de andere richting.

Hoe versie ik mijn API en prijswijzigingen?

Elke invoer in de prijstabel is per-route, zodat verschillende routes verschillende prijzen kunnen vragen. Voor versiebeheer is het aanbevolen patroon om v2-eindpunten naast v1 bloot te stellen met de nieuwe prijzen als nieuwe invoeren in de prijstabel; klanten zien het nieuwe bedrag in hun eerste 402-respons op de v2-route en betalen dienovereenkomstig. Plotselinge prijsstijgingen op stabiele routes zijn slecht protocol-burgerschap; we raden aan de oude route af te schrijven en een 410 Gone te serveren die naar de nieuwe route wijst tegen de nieuwe prijs.

Hoe ziet observability eruit - logs, metrics, alerts?

Elke betaling verschijnt in het Blockchain0x-dashboard met de wallet van de betaler, het bedrag en de tijdstempel, en dezelfde gegevens komen aan op je payment.received webhook zodat je het kunt streamen naar Datadog, Splunk of je eigen loggingstack. De adapter draait binnen je server, dus de signalen op aanvraagniveau (welke route werd geciteerd, elke 402 die je terugstuurde, elke X-Payment die je verifieerde) zijn jouw om te loggen en uit te zenden als metrics in welk formaat je stack ook gebruikt. Stel waarschuwingen in voor de voor de hand liggende: een plotselinge piek in 402-responses, of een daling in het percentage geverifieerde betalingen.

Wat te doen met regelgevende vragen - ben ik een money services business als ik dit doe?

Waarschijnlijk niet, maar dit is jurisdictie-specifiek en wij zijn geen advocaten. De reden: je ontvangt betaling voor de diensten die je levert, niet voor het overmaken van geld tussen derden (wat de trigger is voor MSB-status in de VS). USDC wordt in de meeste jurisdicties erkend als een betalings-stablecoin. Je moet belasting betalen over de USD-equivalente inkomsten; wij genereren de records die je daarvoor nodig hebt. Als je opereert in een B2B-context met hoge volumes of in een jurisdictie met strikte crypto-regels (Duitsland, Singapore voor bepaalde vormen), vraag dan specifiek juridisch advies voordat je productie-verkeer inschakelt. We kunnen je doorverwijzen naar bedrijven die dit werk voor eerdere klanten hebben gedaan.

Laat agents betalen voor uw API.

Voeg een route toe aan de prijsstelling en monteer de adapter. Stripe blijft voor mensen. Beide doelgroepen worden bediend.