创建订单
接口地址 https://api.routepays.com/v1，请求与响应都是 JSON。
- 每个请求带四个请求头：密钥 ID、时间戳、随机串和 HMAC-SHA256 签名
- 超过五分钟的请求、重复使用的随机串都会被拒绝
- 把你自己的订单号作为 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… HMAC-SHA256
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 签名，先验签再处理。
会重试
投递失败会按退避间隔重试；每个事件有固定的 ID，方便去重。
事件齐全
order.paid、order.expired、order.held、order.settled、payout.approved、payout.succeeded、payout.failed。
上线前
- 在控制台创建 API 密钥；Secret 只显示一次，只能放在你的服务器上。
- 设置回调地址（需通行密钥确认），发一条测试事件。
- 每一笔订单都是真实订单，第一次端到端测试请用小金额。