在 PonponPay 接入 x402

在平台创建受保护资源规则，然后在服务端路由中使用 PonponPay SDK。SDK 会处理 402 challenge、付款验证和结算调用。

接入流程

1. 在 Dashboard 的 x402 Agent Payments 页面创建 Resource configuration。
2. 填写公开 resource URL、HTTP method、价格、网络、USDC 合约和 settlement wallet。
3. 在服务端路由中安装并初始化 PonponPay SDK，API Key 只能放在服务端环境变量里。
4. 用 SDK 包装受保护接口。未付款时返回 402，付款成功后继续返回业务数据。
5. 在平台查看 Payment records，跟踪验证、结算和链上交易状态。

服务端 SDK 示例

x402 必须在服务端使用 API Key 模式。不要把 API Key 或 settlement 逻辑放到浏览器包中。

import { ponponpayX402 } from '@ponponpay/sdk/x402';

const x402 = ponponpayX402({
  apiKey: process.env.PONPONPAY_API_KEY!,
  resource: {
    resource: 'https://merchant.example.com/api/premium-data',
    method: 'GET',
    price: '$0.01',
    maxAmountRequired: '10000',
    network: 'eip155:8453',
    asset: 'USDC',
    payTo: '0xYourMerchantSettlementWallet',
    description: 'Premium market data'
  }
});

export async function GET(request: Request) {
  const result = await x402.verifyAndSettle(request);
  if (!result.paid) {
    return result.required();
  }

  return Response.json({ data: 'premium payload' });
}

支持网络

当前仅支持标准 EVM exact 流程，也就是 Circle USDC 的 transferWithAuthorization。

平台验证规则

• scheme 必须是 exact。
• network、asset、assetContract、payTo、amount 必须和资源配置匹配。
• resource URL 和 HTTP method 会强制匹配当前请求。
• validAfter / validBefore 必须处于有效窗口内，nonce 只能结算一次。
• EIP-712 签名必须恢复到 authorization.from。

暂不支持的链

BSC、Tron、Solana、TON、BTC 不属于当前标准 EVM exact 流程。后续如果支持，需要单独的 x402 scheme 或 PonponPay 扩展。