API 概览
商户 API 是一组 REST 接口（GodaPay 兼容），所有请求在请求体里带 signature 字段做 MD5 排序签名认证。
基础信息
Base URL
https://api.168tonpay.xyz/api/v1/compat/godapay # 收款
https://apply.168tonpay.xyz/api/v1/compat/godapay # 付款
认证
所有端点都使用请求体的 MD5 排序签名。详见 认证。
请求示例
POST /api/v1/compat/godapay/pay/order/create HTTP/1.1
Host: api.168tonpay.xyz
Content-Type: application/json
{
"merchantId": "0b8a4f32-1c1e-4a1c-9b25-3a9c2e0f7d5b",
"orderNo": "ORD-001",
"returnUrl": "https://your-server.example/webhook",
"playerPhone": "01711000000",
"playerRef": "player_1",
"signature": "<md5-sorted>"
}
响应格式
成功（code: 0）：
{
"code": 0,
"data": { /* 端点定义的字段 */ }
}
错误（code 非 0）：
{
"code": 1103,
"message": "Amount must be between 10 and 1000000"
}
详见 错误码。
端点列表
| 端点（相对 Base URL） | 方法 | 用途 |
|---|---|---|
/pay/order/create | POST | 创建收款订单 |
/pay/order/query | POST | 查询订单 |
/pay/order/status/:platformOrderNo | GET | 托管页轮询状态 |
/apply/create | POST | 创建付款订单 |
/apply/query | POST | 查询付款订单 |
/pay/balance | POST | 查询余额 |
支持的支付通道
| 通道代码 | 名称 |
|---|---|
bkash | bKash |
nagad | Nagad |
rocket | Rocket |
订单状态
| 状态 | 收款订单 | 付款订单 |
|---|---|---|
pending | 已创建，等待玩家支付 | 已创建，待处理 |
processing | 正在结算 | 正在出款 |
completed | 资金已入账 | 出款成功 |
failed | 失败（终态） | 出款失败 |
expired | 超时未支付 | 超时未完成 |
cancelled | 已取消 | 已取消 |
速率限制
每商户 60 请求 / 分钟。详见 速率限制。
HTTP 状态码
| 状态码 | 含义 |
|---|---|
| 200 | 成功（业务成败看响应体 code） |
| 400 | 请求错误 |
| 401 | 未授权 / 签名无效 |
| 404 | 未找到 |
| 429 | 触发速率限制 |
| 500 | 服务器错误 |
Webhook
订单进入终态时，平台会向你请求里的 returnUrl 发送 form-urlencoded 回调（status "1"=已支付/"0"=未支付），你需应答字面量 SUCCESS。详见 Webhooks。