x402 合规预检
x402 复活了那个一直空着的 HTTP 状态码 402(Payment Required):服务器回一个 402,Agent 用稳定币当场付清,再拿到 200 和内容。整个过程一次请求、无账号、无人在环。它让机器按次、按量、微额地为 API 与内容付费。
但「付得快」不等于「付得合规」。付款方是代码时,谁在付、授权到哪、对手方干不干净。这些判断必须在钱出去之前、以机器速度做完。OceanAlt 作为 x402 的 companion,在结算前插入一道逐闸合规校验,不与 x402 竞争。
x402 付款前,怎么查收款方?
x402 的报价会告诉 Agent 把钱付到哪里:某条链上的一个 payTo 地址。签名之前,把这个地址和链名发给 OceanAlt 的免费判定接口 POST /api/decide,得到放行(allow)、复核(review)或拒绝(decline),附原因码和可以核对的证据。只有放行才继续付款。想防住假冒的卖家,再用 GET /api/endpoint 查一下返回 402 的那个网址。
我方定位:x402 的合规 provider
做 x402 的 companion
我们不重写 x402,也不和它的 facilitator 抢结算。我们坐在结算前的一跳,给付款意图做合规判决,可以付再交给 x402 完成 402 → 200。
逐闸合规校验
一笔 x402 付款先过我们的闸:身份归因(KYA)、授权与限额、支付防火墙、对手方 AML 筛查。过闸才结算,不过闸当场拦下并给出逐项原因。
一行接入,协议中立
在你发起 x402 支付前调一次 /api/pay 预检即可;不改 x402 报文、不托管你的钱、不消费 nonce。也适配 AP2 等其它轨道。
判决可核验
每条判决都给出逐闸 checks 与可点开核验的证据;方法与支柱对照公开的 RAP 框架。
在浏览器里实测一笔
填一个收款地址(0x / T / base58 均可)和可选的金额、用途,预检这笔 x402 付款过不过闸,并逐项给出原因。无状态:不消费 nonce、不结算、不需要凭证。
这是只读预检,不是付款
真实付款闭环测试
上面的预检不花钱。这里用你的自托管钱包(Rabby / MetaMask)对付费端点 /api/x402/decision 真付一笔:单次判定 $0.002,或买一个充值包($0.10 = 100 次判定)。走 x402 官方流程(EIP-3009 签名 + facilitator 结算),付款方免 gas,不碰私钥。
⚠ 真实付款 · $0.002 USDC(Base 主网)
本组件用你自己的自托管钱包(Rabby / MetaMask)对付费端点真实支付 $0.002 USDC,用来验证主网收款真的能跑通。付款走 x402 官方流程,一旦结算不可撤销。实际网络与金额以端点返回的 402 报价为准。若端点当前配置为测试网,付的是测试 USDC(非真钱),下方会如实标注。
如何接入
在你的 Agent 发起 x402 支付之前,先对同一笔意图调一次预检;返回 allow 再继续结算,block 则中止。接入代码、授权信封配置与自描述闸门清单都在付款前检查控制台里。

