Ana içeriğe atla
KİŞİSEL 2 VARYANT - API SAĞLAYICILARI

API'nizi AI ajanlarına satın.

AI ajanları kredi kartı formunu dolduramaz. Size USDC ile ödeme yapabilirler. Blockchain0x bu tek API çağrısını yapar.

ACI

API'niz insanlar için tasarlandı. Arayanlar artık ajandır.

API gelirinin önümüzdeki on yılı insan kayıtlarından gelmeyecek. Kullanıcıları adına API'leri çağıran AI ajanlarından gelecek, genellikle programatik olarak ve herhangi bir insan döngüde olmadan. Bu ajanlar mevcut ödeme sayfanızı kullanamazlar. Kredi kartı formunu dolduramazlar, hesap oluşturamazlar, onay e-postasına tıklayamazlar, şifreyi hatırlayamazlar.

Yapabilecekleri şey, 402 Ödeme Gereklidir yanıtını okumak, JSON gövdesinden USDC miktarını ve alıcıyı ayrıştırmak, Base'de ödeme yapmak ve ödeme kanıtı ile çağrıyı yeniden yapmak. Bu, ajana dayalı API ticaretinin tüm şeklidir. Maliyet modeli (stabilcoin cinsinden çağrı başına faturalama), ajanın kullanım şekline kart tabanlı aboneliklerden çok daha iyi uyum sağlar: kartlar 1 dolardan düşük işlemlerde başarısız olur; Base'deki USDC, gazda sentler tutar; geri ödemeler makineler arasında gerçekleşmez.

Blockchain0x köprüdür. Fiyatlandırma tablosunda ücretlendirmek istediğiniz rotaları listeleyin ve x402 adaptörünü monte edin. Ödenmemiş bir çağrı fiyatlandırılmış bir rotaya ulaştığında, adaptör ne kadar ödenmesi gerektiğini tanımlayan bir 402 döner. Ajan, Base üzerinde ödeme yapar ve bir X-Payment başlığı ile tekrar dener; adaptör bunu doğrular ve işleyiciniz çalışır. USDC toplarsınız ve API'nizi önceki gibi çalıştırırsınız. İş mantığınızda hiçbir şey değişmez; faturalama katmanı yan yana çalışır.

402 ÖDEME GEREKİYOR

HTTP durum kodunun nihayet bir kullanımı var.

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.

ÇAĞRI ÜCRETİ ÖDENMEDİĞİNDE API'NİZ BU 402 BODY'Yİ DÖNER
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
    }
  ]
}

accepts[] gereksinimi ne anlama geliyor

  • scheme - ödeme şeması. exact-usdc, bir EVM zincirinde tam bir USDC miktarını ifade eder. Müşteri, ödeme yapmadan önce bununla eşleşir.
  • network / chainId - yerleşim yapılacak zincir (ana ağ Base'dir, CAIP-2 eip155:8453). Bir geçiş, accepts içinde iki gereksinim listeleyerek her iki ağı da alıntılayabilir.
  • payToAddress / amountWeiUsdc - alıcı cüzdanı ve USDC temel birimlerinde tam miktar (500000 = 0.50 USDC, 6 ondalık). Müşteri, ödeme yapmadan önce her ikisini de doğrular.
  • paymentRequestId - ödemeyi bu alıntıya bağlar. Adaptör, alıntılanan rotadan farklı bir paymentRequestId'yi referans alan bir X-Payment'i reddeder.
  • maxAgeSeconds - ödemenin ne kadar taze olması gerektiği. Bu pencerenin daha eski bir ödemesi reddedilir ve arayan tekrar ödeme yapmalıdır.

x402, makineden makineye: x402'yi bilen bir istemci accepts'i okur, seçilen gereksinimi zincir üzerinde öder ve ardından adaptörün doğruladığı bir X-Payment başlığı ile isteği yeniden verir. x402 ile konuşmayan bir istemci, yalnızca 402'yi alır ve sonuç almaz, bu da doğru sonuçtur (çağrı ödenmemiştir). Bu akışta barındırılan bir ödeme sayfası yoktur; ödeme, çağrıcının cüzdanı tarafından programlı olarak yerleşir.

ADAPTÖR DESENİ

Bir fiyatlandırma tablosu. Üç dil. Aynı şekil.

Tek bir adapter mount edersiniz ve ona METHOD artı path ile anahtarlanmış bir pricing table verirsiniz. Yalnızca listelediğiniz route'ları gate eder; handler'ınız hiç ödenmemiş bir çağrıyı görmez, çünkü çalıştığında X-Payment header'ı zaten doğrulanmıştır. Yapı Python, TypeScript ve Go arasında aynıdır - X-Payment wire format'ı aynıdır, bu yüzden bir Go server Python client tarafından oluşturulan header'ları kabul eder.

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
});
GO (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)
}

Express ve Fastify (Node), ASGI (Starlette ve FastAPI) ve Flask (Python) için sunucu adaptörleri gönderiyoruz ve Go'nun net/http'si. Diğer çerçeveler için, 402 gövdesi ve X-Payment başlığı, @blockchain0x/x402'deki kablo yardımcıları tarafından oluşturulan ve ayrıştırılan düz HTTP'dir - yığınınızdaki deyimle kontrolü el yazısıyla yazın. Ruby ve JVM x402 paketleri istemci tarafı için yayımlanmıştır.

VS STRIPE CHECKOUT

Her bir araca ne zaman ulaşılacağı.

Stripe, insan ödemeleri için doğru araçtır. Blockchain0x, ajan ödemeleri için doğru araçtır. Farklı sorunları çözerler ve sıklıkla aynı API üzerinde yan yana bulunurlar.

BoyutBlockchain0xStripe Checkout
AlıcıHerhangi bir HTTP istemcisi (insan veya AI ajanı)Bir tarayıcıda insan
Ödeme öncesi kimlik doğrulama gereklidirHayır - ilk çağrı ödeme gereksinimleri ile 402 döndürürEvet - e-posta + kart formu
Ödeme hızı5 saniye (USDC on Base)2-7 gün (kart ağları)
İade riskiYok (USDC kesindir)120 güne kadar geri ödeme süresi
İşlem başına maliyet ekonomisiHer arama başına $0.01-$0.10 (Base gaz + bizim ücretimiz) ile çalışır.Kart ücretleri, $1 altındaki işlemleri ekonomik hale getirmiyor
İadelerManuel - kodunuz USDC'yi ödeyen adresine geri gönderirStripe kontrol paneli üzerinden otomatikleştirildi
Uluslararası destekAynı cüzdan, her ülke, ekstra yapılandırma yokÜlke bazında lisanslama, döviz dönüşümü, bölgesel kurallar
En iyiProgramatik ajan odaklı API tüketimiİnsan tarafından yönlendirilen ödeme (SaaS kaydı, e-ticaret)

Çoğu API sağlayıcısının ulaştığı desen: insan kayıt akışı için Stripe'ı (kontrol paneliniz, abonelik ürün sayfanız) tutun; programatik ajans erişimi için API kenarında Blockchain0x ekleyin. x402 adaptörü yalnızca fiyatlandırma tablosuna koyduğunuz rotaları kapatır, bu nedenle insan, Stripe ile kimlik doğrulaması yapılmış rotalar etkilenmez. Ajansları fiyatlandırılmış rotalara, insanları ise diğerlerine yönlendirin ve her iki kitle de aynı API kodu ile hizmet alır.

HANGİ PLANA UYAR

Erken trafik için Pro. Denetim kayıtları bir gereklilik haline geldiğinde İşletme.

API sağlayıcıları, genellikle ilk günden itibaren Pro'da başlar: Ücretsiz yalnızca okunabilir ve x402 adaptörü, ödemeleri doğrulamak ve yerleştirmek için API erişimine ihtiyaç duyar, ayrıca bunları takip etmek için webhook'lar gereklidir. Yüksek trafikli API'ler, aylık hacim arttıkça İşletme alanına geçer. Tam olarak her ajanın maliyetini ve katmanların nerede olduğunu görmek için fiyatlandırma sayfasına bakın.

  • Free: yalnızca kontrol paneli ve meta veri incelemesi için uygundur. Salt okunur olduğundan adaptör ödemeleri gerçekleştiremez.
  • Pro: canlı API monetizasyonu için varsayılan seçenek. Tam API erişimi, webhooks, dışa aktarımlar.
  • Business: uyumluluk için denetim günlüklerine veya daha yüksek API oran limitlerine ihtiyaç duyduğunuzda.
Tam fiyatlandırmayı görün
SIKÇA SORULAN

Beş API sağlayıcı sorusu.

Aynı API için Blockchain0x ile birlikte Stripe'ı çalıştırabilir miyim?

Evet ve birçok API provider bunu yapar. Model şu: mevcut Stripe tabanlı insan signup akışınızı koruyun ve x402 pricing table içinde yalnızca agent'a yönelik route'ları listeleyin. Adapter tam olarak bu route'ları gate eder; tabloda olmayan her şey (Stripe-authenticated müşterilerinizin çağırdığı route'lar dahil) etkilenmeden doğrudan geçer. Tek bir route'un her ikisine de hizmet etmesini istiyorsanız, handler'da kendi API key'inizi kontrol edin ve authenticated çağıranlar için ücretli yolu atlayın. Her iki kitle de birbirini engellemeden istediklerini alır.

Bir AI ajanı ödeme yapar ve ardından çağrıyı yeniden denemeden önce çıkarsa ne olur?

Ödeme hala zincir üzerinde geçerlidir; sadece kullanılmaz. Ajansın cüzdanı, adresinize başarılı bir USDC transferi gösterir. Ajansın bakış açısından USDC'yi kaybetti; sizin bakış açınızdan, asla gerçekleştirilmemiş bir çağrı için ödeme aldınız. Bu pratikte nadirdir (x402 istemcisi ödedikten hemen sonra yeniden dener), ancak savunmacı olmak istiyorsanız, asla tamamlanmış bir çağrı üretmeyen doğrulanmış ödemeleri takip edebilir ve USDC'yi kendiniz payments.create ile geri gönderebilirsiniz, orijinal ödeme yapan adresi ödeyerek. Ayrı bir iade uç noktası yoktur - bir iade, sadece diğer yönde bir ödemedir.

API'mi ve fiyat değişikliklerimi nasıl sürümlendiririm?

Fiyatlandırma tablosundaki her giriş, rota başına olduğundan, farklı rotalar farklı fiyatlar talep edebilir. Sürümleme için, önerilen model, yeni fiyatların yeni fiyatlandırma tablosu girişleri olarak v1 ile birlikte v2 uç noktalarını açmaktır; istemciler, v2 rotasındaki ilk 402 yanıtında yeni miktarı görür ve buna göre ödeme yapar. Stabil rotalarda ani fiyat artışları kötü bir protokol vatandaşlığıdır; eski rotayı kullanımdan kaldırmayı ve yeni fiyatla yeni rotaya işaret eden bir 410 Gone sunmayı öneriyoruz.

Gözlemlenebilirlik nasıl görünüyor - günlükler, metrikler, uyarılar?

Her ödeme, Blockchain0x kontrol panelinde ödeyen cüzdanı, miktarı ve zaman damgası ile görünür ve aynı veri, Datadog, Splunk veya kendi günlük yığınınıza akıtmak için payment.received webhook'unuza ulaşır. Adaptör, sunucunuzun içinde çalışır, bu nedenle istek düzeyindeki sinyaller (hangi yol alıntılandı, geri döndürdüğünüz her 402, doğruladığınız her X-Payment) günlüğe kaydedilmek ve yığınınızın kullandığı herhangi bir formatta metrik olarak yayımlanmak için sizindir. Belirgin olanlarda uyarılar ayarlayın: 402 yanıtlarında ani bir artış veya doğrulanan ödeme oranında bir düşüş.

Düzenleyici sorular hakkında ne olacak - bunu yaparsam bir para hizmetleri işletmesi miyim?

Muhtemelen değil, ancak bu yargı alanına özgüdür ve biz avukatınız değiliz. Sebep: sağladığınız hizmetler için ödeme alıyorsunuz, üçüncü taraflar arasında para iletimi yapmıyorsunuz (bu, ABD'de MSB statüsü için tetikleyicidir). USDC, çoğu yargı alanında bir ödeme-stablecoin olarak tanınır. USD eşdeğer gelir üzerinden vergi ödemeniz gerekir; bunun için gerekli kayıtları oluşturuyoruz. Yüksek hacimli B2B bağlamında veya belirli şekillerde katı kripto kurallarına sahip bir yargı alanında faaliyet gösteriyorsanız, üretim trafiğini açmadan önce özel hukuki danışmanlık alın. Önceki müşteriler için bu işi yapmış firmalara sizi yönlendirebiliriz.

Ajanların API'niz için ödeme yapmasına izin verin.

Fiyat tablosuna bir yol ekleyin ve adaptörü monte edin. Stripe insanlar için kalır. Her iki kitleye de hizmet verilir.