创建订单
接口地址 https://api.routepays.com/v1。
- 每个请求带 Key ID、时间戳、随机串与 HMAC-SHA256 签名四个请求头
- 时间戳偏差超过 5 分钟或随机串重复的请求会被拒绝
- 以商户订单号作为 Idempotency-Key，重试不会重复建单
- 客户在 checkout_url 完成付款后返回 return_url
POST https://api.routepays.com/v1/orders
X-ACQ-KEY: ak_…
X-ACQ-TS: 1790680394
X-ACQ-NONCE: 9f2c4b1e…
X-ACQ-SIGN: 3b7e…
Idempotency-Key: SO-10086
{
"amount": "100",
"external_order_no": "SO-10086",
"return_url": "https://shop.example.com/orders/SO-10086"
}
201 Created
{
"order_no": "ACQ2609291213K7QXD2",
"status": "waiting_payment",
"checkout_url": "https://checkout.routepays.com/c/c109c905…",
"expires_at": "2026-09-29T12:43:14Z"
}接口
| 接口 | 用途 |
|---|---|
POST /v1/orders | 创建订单，返回收银台地址 |
GET /v1/orders/{order_no} | 查询订单 |
GET /v1/orders | 订单列表，支持筛选与分页 |
POST /v1/orders/{order_no}/cancel | 取消未付款订单 |
GET /v1/balances | 余额 |
GET /v1/settlements | 结算记录 |
GET /v1/payouts | 提现记录 |
GET /v1/assets | 支持的币种与限额 |
POST /v1/webhooks/test | 发送测试回调 |
回调
签名
每次投递带时间戳与原始报文的 HMAC-SHA256 签名。
重试
失败后按退避间隔重试，共 7 次；事件 ID 固定，便于去重。
事件
order.paid、order.expired、order.held、order.settled、payout.approved、payout.succeeded、payout.failed。
上线前检查
- 在控制台创建 API 密钥；Secret 仅显示一次，只保存在服务端。
- 设置回调地址（须通行密钥确认），发送测试回调确认验签通过。
- 所有订单均为真实订单，首次端到端测试请使用小额。