Merchant of record 之外的收单层

把收款的麻烦留在网关里

商户站点只负责下单，paykit 负责建单、收款、并用签名回调把结果送回去。渠道差异、金额匹配、回调重试都留在网关内部。

01

扫码页与卡支付跳转都由网关渲染，商户不用处理渠道 UI 与状态。

02

每次回调都用 HMAC 签名，失败按 30s / 5min / 30min / 6h 重投，五投后标记失败。

03

人民币通道给每笔待支付订单分配 1–99 分尾数，并由数据库唯一索引兜底，并发同价不会串单。

04

新增渠道只需实现三件事：报价、建单、验签。订单与回调留在网关核心。

当前可用渠道

按此部署的实际配置生成

渠道

Creem 卡支付 信用卡 / Apple Pay / Google Pay，以 USD 结算。

两个动作即可

01

签名建单用 HMAC 调用 POST /v1/checkouts，拿到 checkoutUrl，把买家送过去。

02

接收回调校验 x-paykit-signature，按 orderId 履约；非 2xx 会触发退避重试。

03

对账兜底回调丢失时用 GET /v1/checkouts/:orderId 主动查，结果与回调一致。

canonical = "<timestamp>.POST./v1/checkouts." + sha256(rawBody)
signature = hex(HMAC-SHA256(apiSecret, canonical))

完整契约见仓库 docs/API.md。自助注册尚未开放，届时会在本页提供入口。

2026-11-02T09:49:15.335Z