ప్రధాన కంటెంట్‌కు దాటవేయండి
వ్యక్తిత్వం 2 వేరియంట్ - API ప్రొవైడర్లు

మీ APIని AI ఏజెంట్లకు విక్రయించండి.

AI ఏజెంట్లు క్రెడిట్ కార్డ్ ఫారమ్‌ను నింపలేరు. వారు మీకు USDC లో చెల్లించవచ్చు. Blockchain0x ఆ ఒక్క API కాల్‌ను చేస్తుంది.

నొప్పి

మీ APIని మానవుల కోసం రూపొందించారు. మీ కాలర్లు ఇప్పుడు ఏజెంట్లు.

API ఆదాయానికి వచ్చే తదుపరి దశాబ్దం మానవ సైన్-అప్‌ల నుండి రాదు. ఇది AI ఏజెంట్లు వారి వినియోగదారుల తరఫున APIs ను కాల్ చేయడం నుండి వస్తుంది, సాధారణంగా ప్రోగ్రామాటిక్‌గా మరియు చక్రంలో ఎలాంటి మానవుడూ లేకుండా. ఆ ఏజెంట్లు మీ ఉన్న చెక్ అవుట్‌ను ఉపయోగించలేరు. వారు క్రెడిట్ కార్డ్ ఫారమ్‌ను నింపలేరు, ఖాతాను సృష్టించలేరు, నిర్ధారణ ఇమెయిల్‌ను క్లిక్ చేయలేరు, పాస్వర్డును గుర్తు చేసుకోలేరు.

వారు చేయగలది 402 Payment Required ప్రతిస్పందనను చదవడం, JSON శరీరంలో USDC మొత్తం మరియు గ్రహీతను పార్స్ చేయడం, Base పై చెల్లించడం మరియు చెల్లింపు యొక్క నిరూపణతో కాల్‌ను పునఃజారీ చేయడం. ఇది ఏజెంట్-చాలించిన API వాణిజ్యానికి మొత్తం ఆకారంగా ఉంది. ఖర్చు మోడల్ (స్థిర నాణెంలో ప్రతి కాల్ బిల్లింగ్) కూడా ఏజెంట్ వినియోగ ఆకారానికి కార్డ్ ఆధారిత సభ్యత్వాల కంటే బాగా సరిపోతుంది: కార్డులు $1 కంటే తక్కువ లావాదేవీలలో విఫలమవుతాయి; Base పై USDC గ్యాస్‌లో సెంట్లను ఖర్చు చేస్తుంది; చార్జ్‌బ్యాక్‌లు యంత్రాల మధ్య జరగవు.

Blockchain0x అనేది bridge. మీరు charge చేయాలనుకునే routes ను pricing table లో list చేసి x402 adapter ను mount చేయండి. ఒక unpaid call priced route కు వచ్చినప్పుడు, adapter ఖచ్చితంగా ఏమి pay చేయాలో వివరించే 402 ను return చేస్తుంది. Agent Base లో pay చేసి X-Payment header తో retry చేస్తుంది; adapter దాన్ని verify చేస్తుంది మరియు మీ handler run అవుతుంది. మీరు USDC collect చేసి మీ API ను మునుపటిలాగే run చేస్తారు. మీ business logic లో ఏదీ మారదు; billing layer పక్కనే పనిచేస్తుంది.

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 మొత్తం. చెల్లించడానికి ముందు క్లయింట్ దీని పై సరిపోతుంది.
  • నెట్‌వర్క్ / చైన్ ID - సర్దుబాటు చేయాల్సిన చైన్ (మైన్‌నెట్ బేస్, CAIP-2 eip155:8453). ఒక మైగ్రేషన్ రెండు అవసరాలను ఆమోదాలలో జాబితా చేయడం ద్వారా రెండు నెట్‌వర్క్‌లను ఉల్లేఖించవచ్చు.
  • payToAddress / amountWeiUsdc - గ్రహీత వాలెట్ మరియు USDC ప్రాథమిక యూనిట్లలో ఖచ్చితమైన మొత్తం (500000 = 0.50 USDC, 6 డెసిమల్స్). చెల్లించడానికి ముందు క్లయింట్ రెండింటిని నిర్ధారిస్తుంది.
  • paymentRequestId - చెల్లింపును ఈ ఉల్లేఖనానికి కట్టిస్తుంది. అడాప్టర్ ఉల్లేఖించిన మార్గానికి వేరే paymentRequestIdని సూచించే X-Paymentను తిరస్కరించును.
  • maxAgeSeconds - చెల్లింపు ఎంత తాజాగా ఉండాలి. ఈ విండో కంటే పాత చెల్లింపు తిరస్కరించబడుతుంది మరియు కాలర్ మళ్లీ చెల్లించాలి.

x402 యంత్రం-యంత్రం: x402-అవగాహన కలిగిన క్లయింట్ acceptsను చదువుతుంది, ఆన్-చైన్‌లో ఎంపిక చేసిన అవసరాన్ని చెల్లిస్తుంది, తరువాత అడాప్టర్ ధృవీకరించే X-Payment హెడ్డర్‌తో అభ్యర్థనను మళ్లీ జారీ చేస్తుంది. x402ని మాట్లాడని క్లయింట్ కేవలం 402ని స్వీకరిస్తుంది మరియు ఫలితం పొందదు, ఇది సరైన ఫలితం (కాల్ చెల్లించబడలేదు). ఈ ప్రవాహంలో హోస్టెడ్ చెకౌట్ పేజీ లేదు; చెల్లింపు పిలువువారి వాలెట్ ద్వారా ప్రోగ్రామాటిక్‌గా పరిష్కరించబడుతుంది.

అడాప్టర్ ప్యాటర్న్

ఒక ధర పట్టిక. మూడు భాషలు. ఒకే ఆకారం.

మీరు ఒక అడాప్టర్‌ను మౌంట్ చేస్తారు మరియు METHOD మరియు పథం ద్వారా కీ చేయబడిన ధరల పట్టికను అందిస్తారు. మీరు జాబితా చేసిన మార్గాలను మాత్రమే ఇది గేట్స్ చేస్తుంది; మీ హ్యాండ్లర్ ఎప్పుడూ చెల్లించని కాల్‌ను చూడదు, ఎందుకంటే ఇది X-Payment హెడ్డర్ ఇప్పటికే ధృవీకరించబడినప్పుడు నడుస్తుంది. ఆకారం Python, TypeScript మరియు Goలో సమానంగా ఉంటుంది - X-Payment వైర్ ఫార్మాట్ ఒకే విధంగా ఉంటుంది, కాబట్టి Go సర్వర్ Python క్లయింట్ ద్వారా నిర్మించిన హెడ్డర్లను ఆమోదిస్తుంది.

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. ఇతర ఫ్రేమ్‌వర్క్‌ల కోసం, 402 బాడీ మరియు X-Payment హెడ్డర్ సాధారణ HTTP, @blockchain0x/x402 లో వైర్ సహాయాలు నిర్మించబడతాయి మరియు పార్స్ చేయబడతాయి - మీ స్టాక్ యొక్క భాషలో చెక్‌ను చేతితో రాయండి. క్లయింట్ పక్కకు Ruby మరియు JVM x402 ప్యాకేజీలు ప్రచురించబడ్డాయి.

STRIPE CHECKOUT తో పోలిస్తే

ప్రతి టూల్ కోసం ఎప్పుడు చేరుకోవాలి.

స్ట్రైప్ మానవ చెక్‌ఔట్‌కు సరైన సాధనం. Blockchain0x ఏజెంట్ చెక్‌ఔట్‌కు సరైన సాధనం. అవి విభిన్న సమస్యలను పరిష్కరిస్తాయి మరియు తరచుగా ఒకే APIలో పక్కపక్కనే ఉంటాయి.

మాపుBlockchain0xStripe Checkout
కొనుగోలుదారుఏ HTTP క్లయింట్ (మానవ లేదా AI ఏజెంట్)బ్రౌజర్‌లో మానవుడు
చెల్లింపుకు ముందు ధృవీకరణ అవసరంలేదు - మొదటి కాల్ చెల్లింపు అవసరాలతో 402ని తిరిగి ఇస్తుందిఅవును - ఇమెయిల్ + కార్డు ఫారం
సమాప్తి వేగం5 సెకన్లు (USDC on Base)2-7 రోజులు (కార్డ్ నెట్‌వర్క్‌లు)
చార్జ్‌బ్యాక్ ప్రమాదంఏదీ లేదు (USDC తుది)120 రోజుల చార్జ్‌బ్యాక్ విండో వరకు
ప్రతి లావాదేవీ ఖర్చు ఆర్థిక శాస్త్రం$0.01-$0.10 ప్రతి కాల్‌కు పనిచేస్తుంది (Base గ్యాస్ + మా ఫీజు)కార్డు ఫీజులు $1 కంటే తక్కువ లావాదేవీలను ఆర్థికంగా అనుకూలంగా మారుస్తాయి
రీఫండ్లుమాన్యువల్ - మీ కోడ్ USDCని చెల్లింపుదారుని చిరునామాకు తిరిగి పంపుతుందిస్ట్రైప్ డాష్‌బోర్డ్ ద్వారా ఆటోమేటెడ్
అంతర్జాతీయ మద్దతుఅదే వాలెట్, ఏ దేశం, అదనపు కాన్ఫిగరేషన్ లేదుప్రతి దేశానికి అనుగుణంగా లైసెన్సింగ్, కరెన్సీ మార్పిడి, ప్రాంతీయ నియమాలు
ఉత్తమం కోసంప్రోగ్రామాటిక్ ఏజెంట్-చాలించిన API వినియోగంమానవ-నడిచే చెక్ అవుట్ (SaaS సైన్ అప్, ఈ-కామర్స్)

చాలా API providers అనుసరించే pattern ఇది: human signup flow కోసం Stripe ను ఉంచండి (మీ dashboard, మీ subscription product page); programmatic agent access కోసం API edge వద్ద Blockchain0x ను జోడించండి. x402 adapter మీ pricing table లో పెట్టిన routes ను మాత్రమే gate చేస్తుంది, కాబట్టి మీ human, Stripe-authenticated routes కు ఎలాంటి ప్రభావం ఉండదు. agents ను priced routes కు, humans ను మిగతావాటికి point చేయండి, అప్పుడు రెండు audiences కు కూడా అదే API code ద్వారా service అందుతుంది.

ఏ ప్లాన్ సరిపోతుంది

ప్రారంభ ట్రాఫిక్ కోసం ప్రో. ఆడిట్ లాగ్‌లు అవసరం అయ్యేటప్పుడు వ్యాపారం.

API providers దాదాపు ఎప్పుడూ day one నుంచే Pro లో ప్రారంభిస్తారు: Free read-only, మరియు x402 adapter payments ను verify చేసి settle చేయడానికి API access తో పాటు వాటిని track చేయడానికి webhooks కూడా అవసరం. Monthly volume పెరుగుతున్న కొద్దీ high-traffic APIs Business territory లోకి వెళ్తాయి. ఖచ్చితమైన per-agent cost మరియు tiers ఎక్కడ ఉన్నాయో pricing page చూడండి.

  • Free: dashboard మరియు metadata exploration‌కే ఉపయోగకరం. Read-only కాబట్టి adapter payments settle చేయలేడు.
  • Pro: live API monetization కోసం default. Full API access, webhooks, exports.
  • Business: compliance కోసం audit logs కావాలి లేదా higher API rate limits కావాలనుకున్నప్పుడు.
మొత్తం ధరలను చూడండి
సాధారణంగా అడిగే

ఐదు API-ప్రొవైడర్ ప్రశ్నలు.

నేను అదే API కోసం Blockchain0x తో పాటు Stripeని నడిపించగలనా?

అవును, మరియు అనేక API ప్రదాతలు చేస్తారు. నమూనా: మీ ఉన్న Stripe ఆధారిత మానవ సైన్ అప్ ప్రవాహాన్ని కొనసాగించండి, మరియు x402 ధర పట్టికలో ఏజెంట్-ఫేసింగ్ మార్గాలను మాత్రమే జాబితా చేయండి. అడాప్టర్ ఖచ్చితంగా ఆ మార్గాలను గేట్ చేస్తుంది; పట్టికలో లేని ప్రతిదీ (మీ Stripe-అనుమతించిన కస్టమర్లు కాల్ చేసే మార్గాలను సహా) నేరుగా గడువు చేయబడుతుంది, ప్రభావితం చేయబడదు. మీరు రెండింటిని సేవించే ఒకే మార్గాన్ని కావాలనుకుంటే, హ్యాండ్లర్‌లో మీ స్వంత API కీని తనిఖీ చేయండి మరియు ధృవీకరించిన కాలర్ల కోసం ధర పెట్టిన మార్గాన్ని దాటించండి. రెండు ప్రేక్షకులు తమకు కావాల్సినది పొందుతారు, ఒక మార్గం మరొకదాన్ని అడ్డుకోవడం లేదు.

ఒక AI ఏజెంట్ చెల్లించి, కాల్‌ను తిరిగి ప్రయత్నించే ముందు బయటకు వెళ్లితే ఏమి జరుగుతుంది?

ఆ payment on-chain లో ఇప్పటికీ valid గానే ఉంటుంది; కానీ అది ఉపయోగించబడదు. agent యొక్క wallet మీ address కు successful USDC transfer ను చూపిస్తుంది. agent దృష్టిలో అది USDC ను కోల్పోయింది; మీ దృష్టిలో, execute కాని call కు మీరు payment పొందారు. వాస్తవంలో ఇది అరుదు (x402 client pay చేసిన వెంటనే retry చేస్తుంది), కానీ మీరు defensive గా ఉండాలనుకుంటే పూర్తిగా completed call ఇవ్వని verified payments ను track చేసి, payments.create తో మీరు స్వయంగా USDC ను తిరిగి పంపవచ్చు, original payer address కు payment చేస్తూ. ప్రత్యేక refund endpoint లేదు - refund అనేది కేవలం వ్యతిరేక దిశలో జరిగే payment మాత్రమే.

నా API మరియు ధర మార్పులను ఎలా వెర్షన్ చేయాలి?

ధర పట్టికలో ప్రతి ఎంట్రీ మార్గానికి అనుగుణంగా ఉంటుంది, కాబట్టి వేర్వేరు మార్గాలు వేర్వేరు ధరలను వసూలు చేయవచ్చు. వెర్షనింగ్ కోసం, సిఫారసు చేయబడిన నమూనా v2 ఎండ్‌పాయింట్లను v1 తో కొత్త ధరలను కొత్త ధర-పట్టిక ఎంట్రీలుగా ప్రదర్శించడం; క్లయింట్లు v2 మార్గంలో వారి మొదటి 402 ప్రతిస్పందనలో కొత్త మొత్తాన్ని చూస్తారు మరియు అందుకు అనుగుణంగా చెల్లిస్తారు. స్థిరమైన మార్గాల్లో అకస్మాత్తుగా ధర పెరుగుదలలు చెడు ప్రోటోకాల్ పౌరత్వం; మేము పాత మార్గాన్ని రద్దు చేయడం మరియు కొత్త ధరలో కొత్త మార్గానికి సూచించే 410 Gone ను అందించడానికి సిఫారసు చేస్తాము.

అవగాహన ఎలా కనిపిస్తుంది - లాగ్‌లు, మెట్రిక్స్, అలర్ట్‌లు?

ప్రతి చెల్లింపు Blockchain0x డాష్‌బోర్డ్‌లో చెల్లించిన వ్యక్తి వాలెట్, మొత్తం, మరియు టైమ్‌స్టాంప్‌తో కనిపిస్తుంది, మరియు అదే డేటా మీ payment.received వెబ్‌హుక్‌లో వస్తుంది కాబట్టి మీరు దాన్ని Datadog, Splunk, లేదా మీ స్వంత లాగింగ్ స్టాక్‌లో ప్రసారం చేయవచ్చు. అడాప్టర్ మీ సర్వర్‌లో నడుస్తుంది, కాబట్టి అభ్యర్థన-స్థాయి సంకేతాలు (ఏ మార్గం ఉల్లేఖించబడింది, మీరు తిరిగి ఇచ్చిన ప్రతి 402, మీరు నిర్ధారించిన ప్రతి X-Payment) మీ లాగ్ చేయడానికి మరియు మీ స్టాక్ ఉపయోగించే ఏదైనా ఫార్మాట్‌లో మీట్రిక్‌లుగా విడుదల చేయడానికి మీది. స్పష్టమైన వాటిపై వైర్ అలర్ట్‌లు: 402 ప్రతిస్పందనలలో అకస్మాత్తుగా పెరుగుదల, లేదా నిర్ధారిత-చెల్లింపు రేటులో తగ్గుదల.

నియంత్రణ సంబంధిత ప్రశ్నల గురించి - నేను ఇది చేస్తే నేను ఒక నిధుల సేవల వ్యాపారం అవుతానా?

కచ్చితంగా కాదు, కానీ ఇది న్యాయ పరిధి ప్రత్యేకమైనది మరియు మేము మీ న్యాయవాదులు కాదు. కారణం: మీరు అందించే సేవలకు చెల్లింపు పొందుతున్నారు, మూడవ పక్షాల మధ్య డబ్బు ప్రసారం చేయడం కాదు (ఇది యునైటెడ్ స్టేట్స్‌లో MSB స్థితికి ట్రిగ్గర్). USDC చాలా న్యాయ పరిధుల్లో చెల్లింపు-స్థిరమైన నాణెగా గుర్తించబడింది. మీరు USD-సమాన ఆదాయంపై పన్ను చెల్లించాలి; మేము మీకు అవసరమైన రికార్డులను రూపొందిస్తాము. మీరు అధిక-పరిమాణ B2B సందర్భంలో లేదా కఠినమైన క్రిప్టో నియమాలతో ఉన్న న్యాయ పరిధిలో (జర్మనీ, కొన్ని ఆకారాల కోసం సింగపూర్) పనిచేస్తే, ఉత్పత్తి ట్రాఫిక్‌ను మలుపు వేసే ముందు నిర్దిష్ట న్యాయ సలహా పొందండి. మేము ఈ పనిని గత కస్టమర్ల కోసం చేసిన సంస్థలకు మీకు సూచించవచ్చు.

ఏజెంట్లు మీ APIకి చెల్లించడానికి అనుమతించండి.

Pricing table కు ఒక route జోడించి adapter ను mount చేయండి. Stripe మనుషుల కోసం ఉంటుంది. రెండు audiences కూడా సేవ చేయబడతాయి.