配置
API 配置
| 配置项 | 值 |
|---|---|
| Base URL(收款) | https://api.168tonpay.xyz/api/v1/compat/godapay |
| Base URL(付款) | https://apply.168tonpay.xyz/api/v1/compat/godapay |
| 认证 | 请求体 MD5 排序签名(HMAC-SHA256 可按商户开启) |
| 速率限制 | 60 请求 / 分钟 / 商户 |
沙箱是按商户开启的(不是按 host):把商户标记为 demo 商户后,带 isTest: true 即可在同一 host 上跑合成 SMS、无真实资金。
环境变量
在你的项目中设置:
# 收款接口基址
API_BASE=https://api.168tonpay.xyz/api/v1/compat/godapay
# 凭证由平台在发放时告知
MERCHANT_ID=aef6025b-f435-443c-bb18-f10e65d9314c
API_SECRET=xxxxxxxx
# Webhook 端点(你自己的服务器地址,即请求里的 returnUrl)
WEBHOOK_URL=https://your-server.example/api/webhook
Webhook 签名复用
API_SECRET,无需额外的WEBHOOK_SECRET。详见 Webhooks。
凭证
凭证由平台团队发放,详见 测试凭证。
| 字段 | 说明 |
|---|---|
| Merchant ID | UUID,放在请求体的 merchantId 字段 |
| API Secret | 仅在你的服务器上计算 signature 时使用,绝不上行 |