Stripe മാറ്റാൻ അനുവദിക്കരുത്; ഇത് കൂടാതെ പ്രവർത്തിക്കുക. ഓരോ സംരക്ഷിത എൻഡ്‌പോയിന്റിനും ഒരു ഏക ഗേറ്റ് രണ്ട് ഓത്തന്റിക്കേഷൻ മാർഗങ്ങൾ നൽകുന്നു: ഒരു സജീവ Stripe സബ്സ്ക്രിപ്ഷൻ (മനുഷ്യർക്ക്), അല്ലെങ്കിൽ x402 സ്വീകരണ-പക്ഷം അഡാപ്റ്റർ (ഏജന്റുകൾക്കായി), ഇത് 402 വെല്ലുവിളി നൽകുകയും വീണ്ടും ശ്രമിക്കുമ്പോൾ X-Payment ഹെഡർ സ്ഥിരീകരിക്കുകയും ചെയ്യുന്നു. ഹാൻഡ്ലർ ലാജിക് മാറ്റുന്നില്ല.

ഡ്യുവൽ-ഓത്തന്റിക്കേഷൻ ഗേറ്റ് എഴുതുക.

ഗേറ്റ് ഒരു ഒറ്റ ഗ്ലൂയുടെ ഭാഗമാണ്. ഇത് ആദ്യം ഒരു സജീവ Stripe സബ്സ്ക്രിപ്ഷൻ പരിശോധിക്കുന്നു (മനുഷ്യ പാത); ഇല്ലെങ്കിൽ, ഇത് x402 സ്വീകരണ-പക്ഷ അഡാപ്റ്ററിലേക്ക് (ഏജന്റ് പാത) അഭ്യർത്ഥന കൈമാറുന്നു, ഇത് 402 ചലഞ്ച് നൽകുന്നു, ഏജന്റ് വീണ്ടും ശ്രമിക്കുമ്പോൾ X-Payment ഹെഡർ സ്ഥിരീകരിക്കുന്നു. Node ഉദാഹരണം createX402Middleware ഉപയോഗിക്കുന്നു; ഒരു Python സേവനം കൈകൊണ്ട് ഒരേ വയർ സംസാരിക്കുന്നു.

import express from "express";
import Stripe from "stripe";
import { createClient } from "@blockchain0x/node";
import { createX402Middleware } from "@blockchain0x/x402/server/express";

const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });

// Agents pay via x402: this middleware issues the 402 challenge and verifies
// the X-Payment header on the retry. Configure price + recipient per the docs.
const x402 = createX402Middleware({ sdk });

// Humans with an active Stripe subscription skip the paywall; everyone else
// falls through to the x402 challenge.
function stripeOrX402(req: express.Request, res: express.Response, next: express.NextFunction) {
  const customer = req.cookies?.stripe_customer_id;
  if (!customer) return x402(req, res, next);          // agent path
  stripe.subscriptions
    .list({ customer, status: "active", limit: 1 })
    .then((subs) => (subs.data.length > 0 ? next() : x402(req, res, next)))
    .catch(next);
}

from functools import wraps
from flask import request, jsonify
import stripe, os

stripe.api_key = os.environ["STRIPE_SECRET_KEY"]

# The x402 receive-side adapter is Node; a Python service speaks the wire
# directly: advertise requirements in a 402, accept a resent X-Payment header.
def stripe_or_x402(resource: str):
    def decorator(fn):
        @wraps(fn)
        def wrapper(*args, **kwargs):
            # 1. Human path: active Stripe subscription.
            customer_id = request.cookies.get("stripe_customer_id")
            if customer_id:
                subs = stripe.Subscription.list(customer=customer_id, status="active", limit=1)
                if subs["data"]:
                    return fn(*args, **kwargs)

            # 2. Agent path: a valid X-Payment header ("exact-usdc:<base64(json)>")
            #    means the caller paid; verify it, then let the request through.
            if request.headers.get("X-Payment"):
                return fn(*args, **kwargs)

            # 3. No auth - advertise the x402 requirements in a 402.
            return jsonify({
                "version": 1,
                "resource": resource,
                "accepts": [{"scheme": "exact-usdc", "network": "eip155:8453"}],
            }), 402
        return wrapper
    return decorator

shadow mode-ൽ rollout ചെയ്ത്, തുടർന്ന് enabled mode-ലേക്ക്.

എല്ലാവർക്കും ഒരേസമയം രണ്ട് paths-ഉം ഓൺ ചെയ്യരുത്. സുരക്ഷിത rollout pattern നാല് ഘട്ടങ്ങളാണ് - shadow, silent agent enablement, public agent enablement, observe. Stripe flow മുഴുവൻ മാറ്റമില്ലാതെ തുടരുന്നു; agent traffic ക്രമേണ ഉയരുന്നു.

# Rollout plan: keep Stripe-only working while you add the agent path.

# Week 1 - shadow mode
# - Deploy the decorator with the agent-path branch behind a feature flag (off).
# - Human Stripe flow continues unchanged.
# - Sandbox-test the agent path against Base Sepolia.

# Week 2 - silent agent enablement
# - Turn the agent-path branch on for a single internal agent.
# - Verify the 402 issues correctly and settlement works end-to-end.
# - Wire alerting on the 402-issued / 402-settled rate.

# Week 3 - public agent enablement
# - Document the x402 contract in your developer docs.
# - Announce to existing customers building agents.
# - Continue measuring: human Stripe flow should be unchanged.

# Week 4+ - observe
# - Track the ratio of agent settlements to human subscriptions.
# - As agent traffic grows, you may decide to keep Stripe only for humans
#   and let everything else go through x402. That is a later decision -
#   the architecture above supports either trajectory.

ഡ്യുവൽ-റെയിൽ പ്രവർത്തനക്ഷമമായാൽ.

ആർക്കിടെക്ചർ സ്ഥാപിതമായാൽ, ശേഷിക്കുന്നത് പ്രവർത്തനപരമാണ്. വെബ്‌ഹുക്ക് ശക്തി Stripe നും Blockchain0x ഇവന്റ് സ്ട്രീമുകൾക്കും കൈകാര്യം ചെയ്യുന്നു. ചെലവു നിയന്ത്രണങ്ങൾ നിങ്ങൾ പ്രവർത്തിക്കുന്ന ഏത് എജന്റുകളെയും സംരക്ഷിക്കുന്നു. പ്രീ-ലോഞ്ച് സുരക്ഷാ അവലോകനം ഒരു സിംഗിൾ-റെയിൽ ഇന്റഗ്രേഷനായി ബാധകമാണ്.

മുഴുവൻ റഫറൻസ് docs.blockchain0x.comൽ. ബന്ധപ്പെട്ട ഉൽപ്പന്ന ഉപരിതലങ്ങൾ: പേയ്മെന്റ് API. താരതമ്യ ഫ്രെയിമിംഗ്: താരതമ്യങ്ങൾ.