मुख्य सामग्रीकडे जा
व्यक्तिमत्व 2 वेरिएंट - API प्रदाते

AI एजंटना तुमचा API विका.

AI एजंट क्रेडिट कार्ड फॉर्म भरू शकत नाहीत. ते तुम्हाला USDC मध्ये पैसे देऊ शकतात. Blockchain0x एक API कॉल करते.

दुख

तुमची API मानवांसाठी डिझाइन केलेली होती. तुमचे कॉल करणारे आता एजंट आहेत.

API महसुलाचा पुढील दशक मानव साइनअपमधून येणार नाही. हे AI एजंट्स त्यांच्या वापरकर्त्यांच्या वतीने API कॉल करणार आहेत, बहुतेक वेळा प्रोग्रामेटिक पद्धतीने आणि कोणत्याही मानवाशिवाय. त्या एजंट्स तुमच्या विद्यमान चेकआउटचा वापर करू शकत नाहीत. ते क्रेडिट कार्ड फॉर्म भरू शकत नाहीत, खाते तयार करू शकत नाहीत, पुष्टीकरण ईमेलवर क्लिक करू शकत नाहीत, पासवर्ड लक्षात ठेवू शकत नाहीत.

ते 402 Payment Required response वाचू शकतात, JSON body मधून USDC amount आणि recipient parse करू शकतात, Base वर pay करू शकतात, आणि payment proof सह call पुन्हा पाठवू शकतात. agent-driven API commerce चे हेच संपूर्ण स्वरूप आहे. Cost model सुद्धा (stablecoin मध्ये per-call billing) card-based subscriptions पेक्षा agent usage pattern ला खूपच चांगले बसते: $1 पेक्षा कमी transactions मध्ये cards अपयशी ठरतात; Base वरील USDC gas मध्ये काही सेंट्स खर्च करतो; आणि machines मध्ये chargebacks होत नाहीत.

Blockchain0x हा पूल आहे. किंमतीच्या टेबलात तुम्हाला चार्ज करायच्या मार्गांची यादी करा आणि x402 अडॅप्टर माउंट करा. जेव्हा एक अनपेड कॉल किंमतीच्या मार्गावर येतो, तेव्हा अडॅप्टर 402 परत करतो जो नेमके काय पैसे द्यायचे ते वर्णन करतो. एजंट Base वर पैसे देतो आणि X-Payment हेडरसह पुन्हा प्रयत्न करतो; अडॅप्टर ते पडताळतो आणि तुमचा हँडलर चालतो. तुम्ही USDC गोळा करता आणि तुमचा API पूर्वीप्रमाणे चालवता. तुमच्या व्यवसायाच्या तर्कात काहीही बदलत नाही; बिलिंग स्तर एकत्रितपणे कार्य करते.

402 PAYMENT REQUIRED

HTTP स्थिती कोड अखेर एक उपयोग आहे.

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.

CALL साठी पैसे न भरल्यास तुमचा API हा 402 body परत करतो
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[] requirement चा अर्थ काय

  • योजना - पेमेंट योजना. exact-usdc म्हणजे EVM चेनवर अचूक USDC रक्कम. क्लायंट पैसे देण्यापूर्वी यावर जुळतो.
  • नेटवर्क / चेनआयडी - सेटल करण्यासाठीची चेन (मुख्य नेटवर्क म्हणजे Base, CAIP-2 eip155:8453). एक स्थलांतर स्वीकारण्यात दोन आवश्यकता सूचीबद्ध करून दोन्ही नेटवर्कचा उल्लेख करू शकते.
  • payToAddress / amountWeiUsdc - प्राप्तकर्ता वॉलेट आणि USDC बेस युनिटमध्ये अचूक रक्कम (500000 = 0.50 USDC, 6 दशांश). क्लायंट पैसे देण्यापूर्वी दोन्हीची पुष्टी करतो.
  • paymentRequestId - या कोटशी पैसे जोडतो. अडॅप्टर एक X-Payment नाकारतो जो मार्ग उद्धृत केलेल्या पेक्षा भिन्न paymentRequestId चा संदर्भ घेतो.
  • maxAgeSeconds - पैसे किती ताजे असावे लागतात. या विंडोपेक्षा जुने पैसे नाकारले जातात आणि कॉलरने पुन्हा पैसे द्यावे लागतात.

x402 मशीन-ते-मशीन आहे: एक x402-जानकार क्लायंट accepts वाचतो, ऑन-चेन निवडलेली आवश्यकता भरणा करतो, मग अडॅप्टर पडताळणारा X-Payment हेडरसह विनंती पुन्हा जारी करतो. एक क्लायंट जो x402 बोलत नाही तो फक्त 402 प्राप्त करतो आणि कोणताही परिणाम मिळवत नाही, जो योग्य परिणाम आहे (कॉल भरणा केलेला नाही). या प्रवाहात कोणतीही होस्ट केलेली चेकआउट पृष्ठ नाही; भरणा कॉलरच्या वॉलेटद्वारे प्रोग्रामेटिकली निपजवला जातो.

ADAPTER PATTERN

एक किंमत टेबल. तीन भाषांमध्ये. एकाच आकारात.

तुम्ही एक adapter mount करता आणि त्याला METHOD plus path नुसार keyed pricing table देता. तो फक्त तुम्ही सूचीबद्ध केलेल्या routes वरच gate लावतो; तुमचा handler कधीही unpaid call पाहत नाही, कारण तो चालतो तेव्हा X-Payment header आधीच verified झालेला असतो. Python, TypeScript, आणि Go मध्ये हा shape एकसारखाच आहे - X-Payment wire format तोच असतो, त्यामुळे Go server Python client ने तयार केलेले headers स्वीकारतो.

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
टाइपस्क्रिप्ट (एक्सप्रेस)
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 आणि Fastify (Node), ASGI (Starlette आणि FastAPI) आणि Flask (Python), तसेच Go च्या net/http साठी server adapters देतो. इतर frameworks साठी, 402 body आणि X-Payment header हे साधे HTTP आहेत ज्यांना @blockchain0x/x402 मधील wire helpers build आणि parse करतात - तुमच्या stack च्या idiom मध्ये तपासणी स्वतः लिहा. Client side साठी Ruby आणि JVM x402 packages प्रकाशित केले आहेत.

VS स्ट्राईप चेकआउट

प्रत्येक टूलसाठी केव्हा पोहचायचे.

Stripe मानव चेकआउटसाठी योग्य साधन आहे. Blockchain0x एजंट चेकआउटसाठी योग्य साधन आहे. ते वेगवेगळ्या समस्यांचे समाधान करतात आणि अनेकदा समान API वर सामोरे सामोरे बसतात.

आयामBlockchain0xStripe Checkout
खरेदीदारकोणताही HTTP क्लायंट (मानव किंवा AI एजंट)ब्राउझरवर मानव
पेमेंटपूर्वी प्रमाणीकरण आवश्यक आहेनाही - पहिला कॉल पेमेंट आवश्यकतांसह 402 परत करतोहोय - ईमेल + कार्ड फॉर्म
निव्वळ गती5 सेकंद (USDC on Base)2-7 दिवस (कार्ड नेटवर्क)
चार्जबॅक जोखमीकाहीही नाही (USDC अंतिम आहे)120 दिवसांच्या चार्जबॅक विंडोपर्यंत
प्रति-व्यवहार खर्च अर्थशास्त्र$0.01-$0.10 प्रति कॉलवर कार्य करते (Base गॅस + आमची फी)कार्ड शुल्क $1 च्या खालील व्यवहारांना आर्थिकदृष्ट्या अशक्य बनवतात.
परतहाताने - तुमचा कोड USDC परत भरणार्‍या पत्त्यावर पाठवतोStripe डॅशबोर्डद्वारे स्वयंचलित.
आंतरराष्ट्रीय समर्थनसमान वॉलेट, कोणतीही देश, अतिरिक्त कॉन्फिग नाहीप्रत्येक देशासाठी परवाना, चलन रूपांतरण, प्रादेशिक नियम
सर्वात चांगलेप्रोग्रामेटिक एजंट-चालित API वापरमानव-चालित चेकआउट (SaaS साइनअप, ई-कॉमर्स)

ज्याच्यावर बहुतेक API प्रदाते उतरतात तो पॅटर्न: मानवी साइनअप प्रवाहासाठी Stripe ठेवा (तुमचा डॅशबोर्ड, तुमचा सदस्यता उत्पादन पृष्ठ); प्रोग्रामेटिक एजंट प्रवेशासाठी API कडेला Blockchain0x जोडा. x402 अडॅप्टर फक्त तुम्ही त्याच्या किंमत टेबलात ठेवलेल्या मार्गांना गेट करतो, त्यामुळे तुमचे मानवी, Stripe-प्रमाणित मार्ग अनछुई राहतात. एजंट्सना किंमत असलेल्या मार्गांकडे आणि इतर सर्वांकडे मानवांकडे निर्देशित करा, आणि दोन्ही प्रेक्षकांना एकाच API कोडने सेवा दिली जाते.

कौनता योजना योग्य आहे

प्रो प्रारंभिक ट्रॅफिकसाठी. ऑडिट लॉग्स आवश्यक झाल्यावर व्यवसाय.

API प्रदाता नेहमीच पहिल्या दिवशी प्रो वर सुरू करतात: फ्री वाचनासाठीच आहे, आणि x402 अडॅप्टरला पेमेंट्सची पडताळणी आणि निपटारा करण्यासाठी API प्रवेश आवश्यक आहे तसेच त्यांना ट्रॅक करण्यासाठी वेबहुक्स आवश्यक आहेत. उच्च-वाहनक्षमता असलेल्या API व्यवसाय क्षेत्रात जातात जेव्हा मासिक प्रमाण वाढते. प्रत्येक एजंटच्या खर्चासाठी आणि स्तर कुठे आहेत हे पाहण्यासाठी किंमतीच्या पानावर पहा.

  • Free: केवळ dashboard आणि metadata exploration साठी उपयुक्त. Read-only असल्यामुळे adapter payments settle करू शकत नाही.
  • Pro: live API monetization साठी default. Full API access, webhooks, exports.
  • Business: जेव्हा compliance साठी audit logs हवे असतात, किंवा जास्त API rate limits आवश्यक असतात.
पूर्ण किंमत पहा
वारंवार विचारले जाते

पाच API-प्रदाता प्रश्न.

मी त्याच API साठी Blockchain0x बरोबर Stripe चालवू शकतो का?

हो, आणि अनेक API providers तसे करतात. नमुना असा: तुमचा विद्यमान Stripe-आधारित human signup flow तसाच ठेवा, आणि x402 pricing table मध्ये फक्त agent-facing routes सूचीबद्ध करा. Adapter नेमके तेच routes gate करतो; table मध्ये नसलेले सर्व काही (Stripe-authenticated ग्राहक वापरतात ते routes सुद्धा) कोणताही परिणाम न होता थेट पुढे जाते. एकच route दोन्हींसाठी हवा असल्यास, handler मध्ये तुमचा स्वतःचा API key तपासा आणि authenticated callers साठी priced path वगळा. दोन्ही प्रेक्षकांना हवे ते मिळते, आणि एक path दुसऱ्याला अडवत नाही.

जर एक AI एजंट पैसे दिले आणि कॉल पुन्हा प्रयत्न करण्यापूर्वी बाहेर पडला तर काय?

देयक अजूनही ऑन-चेन वैध आहे; ते फक्त वापरले जात नाही. एजंटच्या वॉलेटमध्ये तुमच्या पत्त्यावर यशस्वी USDC हस्तांतरण दर्शवते. एजंटच्या दृष्टिकोनातून त्याने USDC गमावले; तुमच्याकडून, तुम्हाला एक कॉलसाठी पैसे मिळाले जे कधीही कार्यान्वित झाले नाही. हे प्रथमतः दुर्मिळ आहे (x402 क्लायंट पैसे भरल्यानंतर तात्काळ पुनःप्रयत्न करतो), परंतु जर तुम्हाला रक्षणात्मक राहायचे असेल तर तुम्ही सत्यापित केलेले देयक ट्रॅक करू शकता जे कधीही पूर्ण कॉल तयार करत नाहीत आणि USDC परत पाठवू शकता payments.create सह, मूळ भरणा पत्त्यावर पैसे देऊन. कोणतीही वेगळी परतफेड एंडपॉइंट नाही - परतफेड म्हणजे दुसऱ्या दिशेने एक देयक आहे.

मी माझ्या API आणि किंमत बदलांचे व्हर्जन कसे करावे?

किमतीच्या तक्त्यातील प्रत्येक नोंद प्रति-मार्ग आहे, त्यामुळे विविध मार्ग वेगवेगळ्या किमती आकारू शकतात. आवृत्तीसाठी, शिफारस केलेला पॅटर्न म्हणजे v1 सह v2 एंडपॉइंट्स उघडणे आणि नवीन किमती नवीन किमतीच्या तक्त्यातील नोंदी म्हणून; क्लायंट त्यांच्या पहिल्या 402 प्रतिसादात v2 मार्गावर नवीन रक्कम पाहतात आणि त्यानुसार पैसे देतात. स्थिर मार्गांवर अचानक किंमत वाढणे वाईट प्रोटोकॉल नागरिकत्व आहे; आम्ही जुन्या मार्गाला कमी करण्याची शिफारस करतो आणि नवीन किमतीवर नवीन मार्गाकडे निर्देशित 410 Gone सेवा देतो.

अवलोकन कसे दिसते - लॉग, मेट्रिक्स, अलर्ट?

प्रत्येक पेमेंट Blockchain0x डॅशबोर्डमध्ये भरणार्‍याचा वॉलेट, रक्कम, आणि टाइमस्टॅम्पसह दिसतो, आणि त्याच डेटा तुमच्या payment.received वेबहुकवर येतो जेणेकरून तुम्ही ते Datadog, Splunk, किंवा तुमच्या स्वतःच्या लॉगिंग स्टॅकमध्ये स्ट्रीम करू शकता. अडॅप्टर तुमच्या सर्व्हरमध्ये चालतो, त्यामुळे विनंती-स्तरीय सिग्नल (कोणता मार्ग उद्धृत केला गेला, प्रत्येक 402 तुम्ही परत केला, प्रत्येक X-Payment तुम्ही सत्यापित केला) तुमच्यासाठी लॉग करणे आणि तुमच्या स्टॅकने वापरलेल्या कोणत्याही स्वरूपात मेट्रिक्स म्हणून उत्सर्जित करणे आहे. स्पष्ट गोष्टींवर वायर अलर्ट: 402 प्रतिसादांमध्ये अचानक वाढ, किंवा सत्यापित-भुगतान दरात घट.

नियामक प्रश्नांबद्दल काय - जर मी हे केले तर मी पैसे सेवा व्यवसाय आहे का?

कदाचित नाही, पण हे अधिकार क्षेत्रानुसार आहे आणि आम्ही तुमचे वकील नाही. कारण: तुम्ही तुम्ही प्रदान केलेल्या सेवांसाठी पैसे घेत आहात, तिसऱ्या पक्षांमध्ये पैसे हस्तांतरित करत नाही (जे यूएसमध्ये MSB स्थितीसाठी ट्रिगर आहे). USDC बहुतेक अधिकार क्षेत्रांमध्ये पेमेंट-स्थिर नाणे म्हणून मान्य आहे. तुम्हाला USD-समान महसूलावर कर द्यावा लागतो; आम्ही त्यासाठी तुम्हाला आवश्यक असलेल्या रेकॉर्ड तयार करतो. जर तुम्ही उच्च-आवृत्ती B2B संदर्भात कार्यरत असाल किंवा कठोर क्रिप्टो नियम असलेल्या अधिकार क्षेत्रात (जर्मनी, सिंगापूर काही आकारांसाठी), उत्पादन ट्रॅफिक चालू करण्यापूर्वी विशिष्ट कायदेशीर सल्ला घ्या. आम्ही तुम्हाला पूर्वीच्या ग्राहकांसाठी हे काम केलेल्या कंपन्यांकडे संदर्भित करू शकतो.

एजंटना तुमच्या API साठी पैसे द्या.

किंमत टेबलात एक मार्ग जोडा आणि अडॅप्टर माउंट करा. Stripe मानवांसाठी राहतो. दोन्ही प्रेक्षकांना सेवा दिली.