# ClawPay

> USDT (BSC BEP-20) 收付平台,为人类与 AI 智能体设计。邮箱即身份(kankan.email 原生支持),开户费 $99,交易费率 1%。资金链上直收商户地址,平台不过手资金。

Base URL: https://clawpay.click
Auth: Authorization: Bearer pay_live_xxx(注册验证后签发,仅显示一次)

## 快速开始(5 个调用)

1. POST /api/merchants/register  {"email":"you@example.com"}        → 邮箱收 6 位验证码(agent 可用 IMAP/REST 读 kankan.email 收件箱)
2. POST /api/merchants/verify    {"email":"...","code":"123456"}    → 返回 apiKey + callbackSecret(仅此一次)
3. POST /api/orders/activation   (Bearer apiKey)                    → $99 开户订单,得到 to_address 和 expected_amount
   按 expected_amount 精确转账 USDT(BSC)到 to_address               → 链上确认(约 1 分钟)后商户自动激活
4. POST /api/merchants/me/address (Bearer) {"bsc_address":"0x...","callback_url":"https://..."}  → 绑定收款地址
5. POST /api/orders              (Bearer) {"amount_usdt":50,"memo":"商品A","callback_url":"..."}
   → 返回 cashier_url(收银台页)与 expected_amount;买家按精确金额付款到商户地址
   → 链上确认后平台 POST callback_url,头带 X-ClawPay-Signature = HMAC-SHA256(callbackSecret, body)

## 端点

- POST /api/merchants/register        发验证码(限 60s/次)
- POST /api/merchants/verify          验证并签发 API key
- GET  /api/merchants/me              商户资料(状态/地址/费率余额)
- POST /api/merchants/me/address      绑定 BSC 收款地址/回调地址
- POST /api/orders/activation         创建 $99 开户订单(pending 商户可用)
- POST /api/orders                    创建收款订单(active 商户)
- GET  /api/orders                    订单列表(最近 50)
- GET  /api/orders/{order_no}         订单详情
- GET  /api/public/orders/{order_no}/status  公开订单状态(买家轮询用,无需 key)
- GET  /api/billing/summary           费率账单(1% 记账,月结)
- GET  /o/{order_no}                  收银台页(QR + 精确金额 + 状态自动刷新)
- GET  /health                        健康检查
- GET  /openapi.json                  OpenAPI 3.0 描述

## 关键规则

- 金额防撞单:每个订单 expected_amount = 名义金额 + 随机尾数(如 50.37),必须按精确金额转账才会自动确认
- 订单有效期 30 分钟;过期未付自动关闭
- 链:BSC (BEP-20),USDT 合约 0x55d398326f99059fF775485246999027B3197955
- 费率:成交额 1%,平台记账,月结;开户费 $99 一次性
- 回调失败自动重试 5 次(退避),日志可查

## 支持

在线客服(知识库自助问答): https://lookhere.help(本站右下角气泡即为其嵌入)
联系: support@kankan.email