મુખ્ય સામગ્રી પર જાઓ
પર્સોના 2 વેરિયન્ટ - API પ્રદાતાઓ

તમારો API AI એજન્ટોને વેચો.

AI એજન્ટો ક્રેડિટ કાર્ડ ફોર્મ ભરી શકતા નથી. તેઓ તમને USDC માં ચૂકવી શકે છે. Blockchain0x એ એક API કૉલ કરે છે.

દર્દ

તમારી API માનવ માટે ડિઝાઇન કરવામાં આવી હતી. તમારા કોલર હવે એજન્ટ છે.

API આવકનો આગામી દાયકાનો સમય માનવ સાઇનઅપ્સમાંથી નહીં આવે. તે AI એજન્ટો દ્વારા તેમના વપરાશકર્તાઓની તરફથી APIને કૉલ કરવામાં આવશે, ઘણીવાર પ્રોગ્રામેટિક રીતે અને કોઈપણ માનવ લૂપ વિના. તે એજન્ટો તમારી અસ્તિત્વમાંની ચેકઆઉટનો ઉપયોગ કરી શકતા નથી. તેઓ ક્રેડિટ કાર્ડ ફોર્મ ભરી શકતા નથી, ખાતું બનાવી શકતા નથી, પુષ્ટિ ઇમેઇલ પર ક્લિક કરી શકતા નથી, પાસવર્ડ યાદ રાખી શકતા નથી.

તેઓ શું કરી શકે છે તે 402 Payment Required પ્રતિસાદ વાંચવું, JSON બોડીમાંથી USDC રકમ અને પ્રાપ્તકર્તાને પાર્સ કરવું, Base પર ચૂકવણી કરવી, અને ચુકવણીનો પુરાવો સાથે કોલને ફરીથી બહાર પાડવું. એજન્ટ-ચાલિત API વાણિજ્યની સંપૂર્ણ આકાર છે. ખર્ચ મોડેલ (સ્થિરકોઇનમાં પ્રતિ-કોલ બિલિંગ) એજન્ટના ઉપયોગના આકારને કાર્ડ આધારિત સબ્સ્ક્રિપ્શન કરતાં વધુ સારી રીતે ફિટ કરે છે: કાર્ડ $1 ની નીચેના વ્યવહારોમાં નિષ્ફળ જાય છે; Base પર USDC ગેસમાં સેન્ટ્સ ખર્ચ કરે છે; મશીન વચ્ચે ચાર્જબેક નથી થાય.

Blockchain0x બ્રિજ છે. એક કિંમતોની કોષ્ટકમાં તમે જે માર્ગો માટે ચાર્જ કરવું માંગો છો તે યાદી બનાવો અને x402 એડેપ્ટર માઉન્ટ કરો. જ્યારે એક ચૂકવેલ કોલ એક કિંમતી માર્ગને હિટ કરે છે, ત્યારે એડેપ્ટર 402 પરત આપે છે જે ચોક્કસપણે શું ચૂકવવું તે વર્ણવે છે. એજન્ટ Base પર ચૂકવે છે અને X-Payment હેડર સાથે ફરીથી પ્રયાસ કરે છે; એડેપ્ટર તેને માન્ય કરે છે અને તમારો હેન્ડલર ચાલે છે. તમે USDC એકત્રિત કરો છો અને તમારા APIને અગાઉની જેમ ચલાવો છો. તમારી વ્યવસાયની તર્કમાં કંઈપણ બદલાતું નથી; બિલિંગ સ્તર બાજુમાં ચાલે છે.

402 ચુકવણી જરૂરી છે

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.

તમારી API આ 402 બોડી પાછું આપે છે જ્યારે કોલની ચુકવણી કરવામાં આવી નથી
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[] આવશ્યકતા શું અર્થ ધરાવે છે

  • યોજનાબદ્ધ - ચુકવણી યોજના. exact-usdc એ EVM ચેઇનમાં ચોક્કસ USDC રકમનો અર્થ છે. ક્લાયન્ટ ચૂકવતા પહેલા આ પર મેળ ખાય છે.
  • નેટવર્ક / ચેઇનઆઈડી - સેટલ કરવા માટેની ચેઇન (મેઇનનેટ બેઝ છે, CAIP-2 eip155:8453). એક માઇગ્રેશન સ્વીકારવામાં બે આવશ્યકતાઓ યાદીબદ્ધ કરીને બંને નેટવર્ક્સને ઉલ્લેખ કરી શકે છે.
  • payToAddress / amountWeiUsdc - પ્રાપ્તકર્તા વૉલેટ અને USDC બેઝ એકમોમાં ચોક્કસ રકમ (500000 = 0.50 USDC, 6 દશાંશ). ક્લાયન્ટ ચૂકવતા પહેલા બંનેને ચકાસે છે.
  • paymentRequestId - આ ચુકવણીને આ ઉલ્લેખ સાથે બાંધે છે. એડેપ્ટર એક X-ચુકવણીને નકારી દે છે જે ઉલ્લેખિત માર્ગ કરતાં અલગ paymentRequestId ને ઉલ્લેખ કરે છે.
  • maxAgeSeconds - ચુકવણી કેટલી તાજી હોવી જોઈએ. આ વિન્ડો કરતાં જૂની ચુકવણી નકારી દેવામાં આવે છે અને કૉલરને ફરીથી ચૂકવવું પડશે.

x402 મશીનથી મશીન છે: એક x402-જાણકાર ક્લાયન્ટ accepts વાંચે છે, પસંદ કરેલી જરૂરિયાત ઓન-ચેઇન ચૂકવે છે, પછી એડેપ્ટર દ્વારા માન્યતા પ્રાપ્ત X-Payment હેડર સાથે વિનંતી ફરીથી જારી કરે છે. એક ક્લાયન્ટ જે x402 નથી બોલતું તે માત્ર 402 પ્રાપ્ત કરે છે અને કોઈ પરિણામ મેળવે છે, જે યોગ્ય પરિણામ છે (કૉલ ચૂકવવામાં આવ્યો નથી). આ પ્રવાહમાં કોઈ હોસ્ટેડ ચેકઆઉટ પેજ નથી; ચુકવણી callerના વોલેટ દ્વારા પ્રોગ્રામેટિક રીતે નિકાળવામાં આવે છે.

એડાપ્ટર પેટર્ન

એક કિંમતોની કોષ્ટક. ત્રણ ભાષાઓ. સમાન આકાર.

તમે એક એડેપ્ટર માઉન્ટ કરો છો અને તેને METHOD અને પાથ દ્વારા કી કરેલી કિંમતોની કોષ્ટક આપો છો. તે ફક્ત routesને ગેટ કરે છે જે તમે યાદીમાં આપો છો; તમારો હેન્ડલર ક્યારેય એક અનપેઇડ કોલને નથી જોતા, કારણ કે જ્યારે તે ચાલે છે ત્યારે X-Payment હેડર પહેલેથી જ માન્ય છે. આકાર પાયથન, TypeScript, અને Goમાં સમાન છે - X-Payment વાયર ફોર્મેટ સમાન છે, તેથી Go સર્વર પાયથન ક્લાયન્ટ દ્વારા બનાવવામાં આવેલા હેડર્સને સ્વીકારે છે.

પાયથન (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
});
જાઓ (નેટ/એચટીએમએલ)
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's net/http. અન્ય ફ્રેમવર્ક માટે, 402 બોડી અને X-Payment હેડર સાદા HTTP છે જે @blockchain0x/x402 માં વાયર હેલ્પર્સ બનાવે છે અને પાર્સ કરે છે - તમારા સ્ટેકની ભાષામાં ચેક હેન્ડ-લખો. Ruby અને JVM x402 પેકેજો ક્લાયન્ટ બાજુ માટે પ્રકાશિત કરવામાં આવ્યા છે.

STRIPE CHECKOUT સામે

પ્રત્યેક ટૂલ માટે ક્યારે પહોંચવું.

સ્ટ્રાઇપ માનવ ચેકઆઉટ માટે યોગ્ય ટૂલ છે. Blockchain0x એજન્ટ ચેકઆઉટ માટે યોગ્ય ટૂલ છે. તેઓ અલગ અલગ સમસ્યાઓને ઉકેલે છે અને ઘણીવાર એક જ API પર બાજુમાં બાજુમાં બેસે છે.

પરિમાણBlockchain0xસ્ટ્રાઇપ ચેકઆઉટ
ખરીદદારકોઈપણ HTTP ક્લાયન્ટ (માનવ અથવા AI એજન્ટ)બ્રાઉઝર પર માનવ
ચુકવણી પહેલાં ઓથેન્ટિકેશન જરૂરી છેના - પ્રથમ કોલ ચુકવણીની જરૂરિયાતો સાથે 402 પાછું આપે છેહા - ઇમેલ + કાર્ડ ફોર્મ
નિબંધન ગતિ5 સેકંડ (USDC on Base)2-7 દિવસ (કાર્ડ નેટવર્ક)
ચાર્જબેક જોખમકોઈ નથી (USDC અંતિમ છે)120 દિવસ સુધીની ચાર્જબેક વિન્ડો
પ્રતિ-ટ્રાન્ઝેક્શન ખર્ચ અર્થશાસ્ત્ર$0.01-$0.10 પ્રતિ કૉલ પર કાર્ય કરે છે (બેઝ ગેસ + અમારી ફી)કાર્ડ ફી $1 ની નીચેના વ્યવહારોને અર્થશાસ્ત્રમાં અસાધ્ય બનાવે છે
ફેરવટહાથથી - તમારું કોડ USDC ચૂકવનારના સરનામે પાછું મોકલે છેસ્ટ્રાઇપ ડેશબોર્ડ દ્વારા સ્વચાલિત
આંતરરાષ્ટ્રીય સપોર્ટએક જ વોલેટ, કોઈપણ દેશ, કોઈ વધારાની રૂપરેખા નથીપ્રતિ-દેશ લાઇસન્સિંગ, ચલણ રૂપાંતરણ, પ્રદેશના નિયમો
શ્રેષ્ઠ માટેપ્રોગ્રામેટિક એજન્ટ-ચાલિત API ઉપભોગમાનવ-ચાલિત ચેકઆઉટ (SaaS સાઇનઅપ, ઇ-કોમર્સ)

તે પેટર્ન જે મોટાભાગના API પ્રદાતાઓ પર પહોંચે છે: માનવ સાઇનઅપ પ્રવાહ માટે સ્ટ્રાઇપ રાખો (તમારા ડેશબોર્ડ, તમારા સબ્સ્ક્રિપ્શન ઉત્પાદન પાનું); પ્રોગ્રામેટિક એજન્ટ ઍક્સેસ માટે API કિનારે Blockchain0x ઉમેરો. x402 એડેપ્ટર ફક્ત તે માર્ગોને ગેટ કરે છે જે તમે તેની કિંમતની કોષ્ટકમાં મૂકો છો, તેથી તમારા માનવ, સ્ટ્રાઇપ-પ્રમાણિત માર્ગો અવિનાશિત છે. એજન્ટોને કિંમતવાળા માર્ગો પર અને માનવને બાકીના પર નિશાન બનાવો, અને બંને પ્રેક્ષકોને સમાન API કોડ દ્વારા સેવા આપવામાં આવે છે.

કયો યોજના યોગ્ય છે

પ્રો વહેલા ટ્રાફિક માટે. જ્યારે ઓડિટ લોગ્સ આવશ્યકતા બને છે ત્યારે વ્યવસાય.

API પ્રદાતાઓ લગભગ હંમેશા પ્રથમ દિવસે પ્રો પર શરૂ કરે છે: મફત વાંચવા માટે જ છે, અને x402 એડેપ્ટરને ચુકવણીઓની પુષ્ટિ અને સમાપ્ત કરવા માટે API ઍક્સેસની જરૂર છે અને તેમને ટ્રેક કરવા માટે વેબહુક્સ. ઉચ્ચ ટ્રાફિક API માસિક વોલ્યુમ વધતા જતા બિઝનેસ ક્ષેત્રમાં પ્રવેશ કરે છે. ચોક્કસ પ્રતિ-એજન્ટ ખર્ચ અને ટિયર ક્યાં બેસે તે માટે ભાવ પૃષ્ઠ જુઓ.

  • Free: ફક્ત dashboard અને metadata exploration માટે ઉપયોગી. Read-only હોવાથી adapter payments settle કરી શકતો નથી.
  • Pro: live API monetization માટે default. પૂર્ણ API access, webhooks, exports.
  • Business: જ્યારે compliance માટે audit logs જોઈએ, અથવા વધારે API rate limits જોઈએ.
પૂર્ણ કિંમતો જુઓ
વારંવાર પૂછવામાં આવતી

પાંચ API-પ્રદાતા પ્રશ્નો.

શું હું સમાન API માટે Blockchain0x સાથે Stripe ચલાવી શકું છું?

હા, અને ઘણા API પ્રદાતાઓ કરે છે. પેટર્ન: તમારા અસ્તિત્વમાં રહેલા Stripe આધારિત માનવ સાઇનઅપ પ્રવાહને જાળવો, અને x402 કિંમતોની કોષ્ટકમાં માત્ર એજન્ટ-ફેસિંગ માર્ગોને યાદીબદ્ધ કરો. એડેપ્ટર ચોક્કસપણે તે માર્ગોને ગેટ કરે છે; કોષ્ટકમાં ન હોવા છતાં (તમારા Stripe-પ્રમાણિત ગ્રાહકો દ્વારા કોલ કરવામાં આવેલા માર્ગો સહિત) સીધા પસાર થાય છે, અસરગ્રસ્ત નથી. જો તમે બંનેને સેવા આપવા માટે એક જ માર્ગ માંગતા હો, તો હેન્ડલરમાં તમારી પોતાની API કી તપાસો અને માન્યતા ધરાવતા કોલર્સ માટે કિંમતી માર્ગને છોડી દો. બંને દર્શકોને તે મળે છે જે તેઓ ઇચ્છે છે, એક માર્ગ બીજાને અવરોધિત કર્યા વિના.

જો એક AI એજન્ટ ચુકવણી કરે છે અને પછી કૉલને ફરીથી પ્રયાસ કરતા પહેલા બહાર નીકળી જાય તો શું થાય છે?

ચૂકવણી હજુ પણ ઓન-ચેન પર માન્ય છે; તે માત્ર ઉપયોગમાં નથી આવતું. એજન્ટના વોલેટમાં તમારા સરનામે સફળ USDC પરિવહન દર્શાવે છે. એજન્ટના દૃષ્ટિકોણથી તેણે USDC ગુમાવ્યું; તમારા માટે, તમે એક કોલ માટે ચૂકવવામાં આવ્યા જે ક્યારેય અમલમાં આવ્યું નથી. આ પ્રેક્ટિસમાં દુર્લભ છે (x402 ક્લાયન્ટ ચૂકવણી કર્યા પછી તરત જ પુનઃપ્રયાસ કરે છે), પરંતુ જો તમે રક્ષણાત્મક બનવા માંગતા હો, તો તમે માન્ય ચુકવણાઓને ટ્રેક કરી શકો છો જે ક્યારેય પૂર્ણ કોલનું ઉત્પાદન નથી કર્યું અને USDC પાછું મોકલી શકો છો payments.create સાથે, મૂળ પેયર સરનામું ચૂકવીને. કોઈ અલગ રિફંડ એન્ડપોઈન્ટ નથી - રિફંડ માત્ર બીજી દિશામાં એક ચુકવણી છે.

હું મારી API અને કિંમતમાં ફેરફારોને કેવી રીતે સંસ્કરણ કરું?

પ્રાઇસિંગ ટેબલમાં દરેક એન્ટ્રી પ્રતિ-માર્ગ છે, તેથી વિવિધ માર્ગો વિવિધ ભાવો ચાર્જ કરી શકે છે. વર્ઝનિંગ માટે, ભલામણ કરેલ પેટર્ન એ છે કે v2 અંતિમ બિંદુઓને v1 સાથે નવા ભાવો નવા પ્રાઇસિંગ-ટેબલ એન્ટ્રીઓ તરીકે બહાર પાડવામાં આવે; ક્લાયન્ટ તેમના પ્રથમ 402 પ્રતિસાદમાં v2 માર્ગ પર નવા રકમને જોઈ શકે છે અને તેના અનુસાર ચૂકવણી કરે છે. સ્થિર માર્ગો પર અચાનક ભાવમાં વધારો ખરાબ પ્રોટોકોલ નાગરિકતા છે; અમે જૂના માર્ગને નકારવા અને નવા ભાવ પર નવા માર્ગની તરફ સંકેત કરતી 410 ગોન સેવા આપવા માટે ભલામણ કરીએ છીએ.

ઓબ્ઝર્વેબિલિટી કેવી રીતે દેખાય છે - લોગ્સ, મેટ્રિક્સ, એલર્ટ?

દરેક ચુકવણી Blockchain0x ડેશબોર્ડમાં પેયર વોલેટ, રકમ, અને સમયચિહ્ન સાથે દેખાય છે, અને તે જ ડેટા તમારા payment.received વેબહૂક પર આવે છે જેથી તમે તેને Datadog, Splunk, અથવા તમારા પોતાના લોગિંગ સ્ટેકમાં સ્ટ્રીમ કરી શકો. એડેપ્ટર તમારા સર્વરની અંદર ચાલે છે, તેથી વિનંતી-સ્તરના સંકેતો (કઈ માર્ગનો ઉલ્લેખ કરવામાં આવ્યો, તમે પાછા આપેલ દરેક 402, તમે ચકાસેલ દરેક X-Payment) તમારા લોગ કરવા અને તમારા સ્ટેક જે ફોર્મેટમાં ઉપયોગ કરે છે તેમાં મેટ્રિક્સ તરીકે ઉત્સર્જિત કરવા માટે છે. સ્પષ્ટ વસ્તુઓ પર વાયર એલર્ટ: 402 પ્રતિસાદમાં અચાનક વધારું, અથવા ચકાસેલ ચુકવણી દરમાં ઘટાડો.

નિયમનકારી પ્રશ્નો વિશે શું - શું હું આ કરું તો હું એક મની સર્વિસીસ બિઝનેસ છું?

શાયદ નહીં, પરંતુ આ જુરિસ્ડિક્શન-વિશિષ્ટ છે અને અમે તમારા વકીલ નથી. કારણ: તમે જે સેવાઓ પ્રદાન કરો છો તે માટે ચુકવણી પ્રાપ્ત કરી રહ્યા છો, ત્રીજા પક્ષો વચ્ચે પૈસા મોકલતા નથી (જે યુએસમાં MSB સ્થિતિ માટે ટ્રિગર છે). USDCને મોટાભાગના જુરિસ્ડિક્શનમાં પેમેન્ટ-સ્ટેબલકોઇન તરીકે માન્યતા આપવામાં આવી છે. તમે USD-સમાન આવક પર કર ચૂકવવું જોઈએ; અમે તે માટેની નોંધો બનાવીએ છીએ. જો તમે ઉચ્ચ-વોલ્યુમ B2B સંદર્ભમાં અથવા કડક ક્રિપ્ટો નિયમો (જર્મની, સિંગાપુર માટે ચોક્કસ આકારો) ધરાવતા જુરિસ્ડિક્શનમાં કાર્યરત છો, તો ઉત્પાદન ટ્રાફિકને ચાલુ કરતા પહેલા ચોક્કસ કાનૂની સલાહ મેળવો. અમે તમને અગાઉના ગ્રાહકો માટે આ કામ કર્યું હોય તેવા ફર્મો તરફ સંકેત આપી શકીએ છીએ.

એજન્ટોને તમારા API માટે ચૂકવવા દો.

ભાવ કોષ્ટક માટે એક માર્ગ ઉમેરો અને એડેપ્ટરને માઉન્ટ કરો. સ્ટ્રાઇપ માનવ માટે રહે છે. બંને દર્શકો સેવા આપી રહ્યા છે.