আপনার 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 চালান। আপনার ব্যবসায়িক যুক্তির বিষয়ে কিছুই পরিবর্তন হয় না; বিলিং স্তরটি পাশাপাশি চলে।
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.
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-Payment প্রত্যাখ্যান করে যা উদ্ধৃত রুটের চেয়ে ভিন্ন paymentRequestId এর উল্লেখ করে।
- maxAgeSeconds - পেমেন্ট কতটা তাজা হতে হবে। এই উইন্ডোর চেয়ে পুরানো একটি পেমেন্ট প্রত্যাখ্যাত হয় এবং কলকারীকে আবার অর্থ প্রদান করতে হবে।
x402 হল মেশিন-থেকে-মেশিন: একটি x402-সচেতন ক্লায়েন্ট accepts পড়ে, চয়ন করা প্রয়োজনীয়তা অন-চেইনে পেমেন্ট করে, তারপর একটি X-Payment হেডার সহ অনুরোধটি পুনরায় জারি করে যা অ্যাডাপ্টার যাচাই করে। একটি ক্লায়েন্ট যা x402 জানে না তা কেবল 402 গ্রহণ করে এবং কোন ফলাফল পায় না, যা সঠিক ফলাফল (কলটি পেমেন্ট করা হয়নি)। এই প্রবাহে কোন হোস্টেড চেকআউট পৃষ্ঠা নেই; পেমেন্টটি কলারের ওয়ালেট দ্বারা প্রোগ্রাম্যাটিকভাবে নিষ্পত্তি করা হয়।
একটি মূল্য তালিকা। তিনটি ভাষা। একই আকার।
আপনি একটি অ্যাডাপ্টার মাউন্ট করেন এবং এটি একটি মূল্য তালিকা দেন যা METHOD এবং পথ দ্বারা কী করা হয়। এটি কেবল সেই রুটগুলিকে গেট করে যা আপনি তালিকাভুক্ত করেন; আপনার হ্যান্ডলার কখনও একটি অ-পেমেন্ট কল দেখে না, কারণ যখন এটি চলে তখন X-Payment হেডারটি ইতিমধ্যেই যাচাইকৃত হয়েছে। আকারটি পাইথন, TypeScript, এবং Go জুড়ে একরকম - X-Payment ওয়্যার ফরম্যাটটি একই, তাই একটি Go সার্ভার পাইথন ক্লায়েন্ট দ্বারা তৈরি করা হেডারগুলি গ্রহণ করে।
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 verifiesimport 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 এর net/http। অন্যান্য ফ্রেমওয়ার্কের জন্য, 402 শরীর এবং X-Payment হেডার হল সাধারণ HTTP যা @blockchain0x/x402 এর ওয়্যার সহায়ক তৈরি এবং বিশ্লেষণ করে - আপনার স্ট্যাকের অভিব্যক্তিতে চেকটি হাতে লিখুন। রুবি এবং JVM x402 প্যাকেজগুলি ক্লায়েন্ট সাইডের জন্য প্রকাশিত হয়েছে।
প্রতিটি টুলের জন্য কখন পৌঁছাতে হবে।
স্ট্রাইপ মানব চেকআউটের জন্য সঠিক টুল। Blockchain0x এজেন্ট চেকআউটের জন্য সঠিক টুল। তারা বিভিন্ন সমস্যা সমাধান করে এবং প্রায়শই একই API তে পাশাপাশি বসে থাকে।
| মাত্রা | Blockchain0x | Stripe Checkout |
|---|---|---|
| ক্রেতা | যেকোনো HTTP ক্লায়েন্ট (মানুষ বা AI এজেন্ট) | ব্রাউজারে মানব |
| পেমেন্টের আগে প্রমাণীকরণ প্রয়োজন | না - প্রথম কল 402 ফেরত দেয় অর্থপ্রদান প্রয়োজনীয়তার সাথে। | হ্যাঁ - ইমেইল + কার্ড ফর্ম |
| সেটেলমেন্ট গতি | 5 সেকেন্ড (USDC on Base) | 2-7 দিন (কার্ড নেটওয়ার্ক) |
| চার্জব্যাক ঝুঁকি | কিছুই নয় (USDC চূড়ান্ত) | চার্জব্যাক উইন্ডোর জন্য 120 দিন পর্যন্ত |
| প্রতি-লেনদেন খরচ অর্থনীতি | $0.01-$0.10 প্রতি কল এ কাজ করে (বেস গ্যাস + আমাদের ফি) | কার্ড ফি $1 এর নিচের লেনদেনকে অঅর্থনৈতিক করে তোলে |
| রিফান্ড | ম্যানুয়াল - আপনার কোড USDC ফেরত পাঠায় পেমেন্টকারী ঠিকানায় | Stripe ড্যাশবোর্ডের মাধ্যমে স্বয়ংক্রিয় |
| আন্তর্জাতিক সহায়তা | একই ওয়ালেট, যেকোনো দেশ, অতিরিক্ত কনফিগারেশন নেই | প্রতি-দেশ লাইসেন্সিং, মুদ্রা রূপান্তর, আঞ্চলিক নিয়ম |
| সর্বোত্তম জন্য | প্রোগ্রাম্যাটিক এজেন্ট-চালিত API ব্যবহার | মানব-চালিত চেকআউট (SaaS সাইনআপ, ই-কমার্স) |
যে প্যাটার্নটি বেশিরভাগ API প্রদানকারী অনুসরণ করে: মানব সাইনআপ প্রবাহের জন্য Stripe রাখুন (আপনার ড্যাশবোর্ড, আপনার সাবস্ক্রিপশন পণ্য পৃষ্ঠা); প্রোগ্রাম্যাটিক এজেন্ট অ্যাক্সেসের জন্য API প্রান্তে Blockchain0x যোগ করুন। x402 অ্যাডাপ্টার কেবল সেই রুটগুলিকে গেট করে যা আপনি এর মূল্য নির্ধারণের টেবিলে রেখেছেন, তাই আপনার মানব, Stripe-প্রমাণিত রুটগুলি অক্ষুণ্ণ থাকে। মূল্য নির্ধারিত রুটগুলিতে এজেন্টগুলিকে নির্দেশ করুন এবং বাকি অংশে মানবদের নির্দেশ করুন, এবং উভয় শ্রোতা একই API কোড দ্বারা পরিবেশন করা হয়।
প্রারম্ভিক ট্রাফিকের জন্য প্রো। যখন অডিট লগগুলি একটি প্রয়োজনীয়তা হয়ে যায় তখন ব্যবসা।
এপিআই প্রদানকারীরা প্রায়শই প্রথম দিন থেকেই প্রোতে শুরু করে: ফ্রি শুধুমাত্র পড়ার জন্য, এবং x402 অ্যাডাপ্টারকে পেমেন্ট যাচাই এবং নিষ্পত্তি করতে API অ্যাক্সেসের প্রয়োজন এবং সেগুলি ট্র্যাক করার জন্য ওয়েবহুক। উচ্চ-ট্রাফিক API মাসিক ভলিউম বাড়ার সাথে সাথে ব্যবসায়িক অঞ্চলে চলে যায়। সঠিক প্রতি-এজেন্ট খরচ এবং স্তরগুলি কোথায় রয়েছে তা দেখতে মূল্য নির্ধারণ পৃষ্ঠাটি দেখুন।
- Free: শুধু dashboard এবং metadata exploration-এর জন্য উপযোগী। Read-only, তাই adapter payment settle করতে পারে না।
- Pro: live API monetization-এর default। সম্পূর্ণ API access, webhooks, export।
- Business: যখন compliance-এর জন্য audit log, বা আরও বেশি API rate limit দরকার হয়।