Stripeని మార్చవద్దు; దానితో పాటు నడపండి. ప్రతి రక్షిత ఎండ్‌పాయింట్ ముందు ఒకే గేటు రెండు ఆథ్ పద్ధతులతో ఉంటుంది: ఒక క్రియాశీలమైన Stripe సబ్‌స్క్రిప్షన్ (మానవుల కోసం), లేకపోతే x402 రిసీవ్-సైడ్ అడాప్టర్ (ఏజెంట్ల కోసం), ఇది 402 సవాలు జారీ చేస్తుంది మరియు పునరుద్ధరణపై X-Payment హెడ్డర్‌ను నిర్ధారిస్తుంది. హ్యాండ్లర్ తర్కం మారదు.

ద్వంద్వ-అథ్ గేట్‌ను రాయండి.

గేట్ ఒకే ఒక్క గ్లూ భాగం. ఇది మొదట ఒక క్రియాశీలమైన Stripe సబ్‌స్క్రిప్షన్ కోసం తనిఖీ చేస్తుంది (మానవ మార్గం); ఎవరూ లేకపోతే, ఇది x402 రిసీవ్-సైడ్ అడాప్టర్ (ఏజెంట్ మార్గం) కు అభ్యర్థనను అందిస్తుంది, ఇది 402 ఛాలెంజ్‌ను జారీ చేస్తుంది మరియు ఏజెంట్ పునరావృతం చేసినప్పుడు X-Payment హెడ్డర్‌ను ధృవీకరిస్తుంది. నోడ్ ఉదాహరణ 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 ను flip చేయవద్దు. Safe rollout pattern నాలుగు phases లో ఉంటుంది - shadow, silent agent enablement, public agent enablement, observe. Stripe flow మొత్తం సమయంలో unchanged గా ఉంటుంది; agent traffic gradually పెరుగుతుంది.

# 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. పోల్చడం: పోల్చింపులు.