{"name":"OceanAlt Compliant Payment Gateway","desc":"结算前跑 11 道闸(9 道常开 + 2 道默认关闭由接入方自选):身份归因(KYA) → 授权吊销检查 → 身份证明(防冒用) → KYC 准入(可选) → 单笔额度 → 单日累计额度 → 收款白名单 → 授权意图比对(防提示注入) → AML 制裁与风险筛查 → 行为异常检测(可选) → 防重放 / 防双花。公开档结算为模拟,鉴权档(x-pay-key)可真实上链。","gates":[{"key":"kya","name":"身份归因(KYA)","nameEn":"Attribution (KYA)","optional":false},{"key":"revoked","name":"授权吊销检查","nameEn":"Revocation check","optional":false},{"key":"proof","name":"身份证明(防冒用)","nameEn":"Identity proof (anti-impersonation)","optional":false},{"key":"kyc","name":"KYC 准入(可选)","nameEn":"KYC gate (optional)","optional":true},{"key":"limit","name":"单笔额度","nameEn":"Per-payment limit","optional":false},{"key":"velocity","name":"单日累计额度","nameEn":"Daily cumulative limit","optional":false},{"key":"allowlist","name":"收款白名单","nameEn":"Payee allowlist","optional":false},{"key":"mandate","name":"授权意图比对(防提示注入)","nameEn":"Mandate-intent match (anti prompt-injection)","optional":false},{"key":"aml","name":"AML 制裁与风险筛查","nameEn":"AML sanctions & risk screening","optional":false},{"key":"anomaly","name":"行为异常检测(可选)","nameEn":"Behavioral anomaly detection (optional)","optional":true},{"key":"replay","name":"防重放 / 防双花","nameEn":"Replay & double-spend prevention","optional":false}],"auth":"注册后签发 agentSecret;之后每次调用须在 x-agent-secret 头出示,用于证明你就是该 agent(防冒充)。凭证可轮换;授权可随时吊销且即刻生效(RAP 支柱2)。","rateLimit":"每 IP 40 次/分钟;每 agent 20 次/分钟。超限返回 429。","standard":"https://oceanalt.com/en/rap","usage":{"POST /api/pay { action:'preview', amountUsdc, to, purpose, agentId?, network? }":"① 付款前无状态预检(不结算/不消费nonce/不需凭证):先问『这笔过不过闸』,逐项返回。AML 收款方风险筛查对所有人有效;额度/白名单/用途需已 register 的 mandate 才生效。network 可传 base/solana/ethereum(x402 主要在 base、solana),决定链上分析查哪条链。x402 场景推荐的第一个调用。","POST /api/pay { action:'register', agentId, entity, label?, mandate? }":"归因 agent(KYA,落库)→ 返回 agentSecret;可同时设本 agent 的授权信封 mandate:{maxUsdc,dailyUsdc,payees:[],purpose}","POST /api/pay { action:'set-mandate', agentId, mandate } + x-agent-secret":"设置/更新本 agent 的授权信封(多租户:每个 agent 自己的额度/白名单/用途)","POST /api/pay { action:'status', agentId } + x-agent-secret":"查看本 agent 的授权信封 + 今日已花 + 最近被拦记录","POST /api/pay { action:'check', agentId }":"查询归因状态","POST /api/pay { action:'rotate', agentId } + x-agent-secret":"轮换凭证(旧的即刻作废)","POST /api/pay { action:'revoke', agentId } + x-agent-secret":"吊销授权(即刻生效;终态,不可自助恢复)","POST /api/pay { agentId, amountUsdc, to, purpose, nonce } + x-agent-secret":"发起合规支付(nonce 须唯一一次性,防重放/双花)。金额 ≥ mandate.holdOverUsdc 时返回 202+holdId 挂起等人工批准","POST /api/pay { action:'hold-status', holdId }":"轮询挂起支付的批准结果(pending 待批准 / approved 已批准并结算 / rejected 已拒绝)"},"mandate":{"maxUsdc":0.1,"dailyUsdc":0.3,"allowedPayees":["0x0200000000000000000000000000000000000402"],"purpose":"unlock-premium","holdOverUsdc":null},"example":"curl -X POST https://oceanalt.com/api/pay -H 'content-type: application/json' -d '{\"action\":\"register\",\"agentId\":\"bot-1\",\"entity\":\"Acme (KYC)\"}'"}