跳到主要内容

配置

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 IDUUID,放在请求体的 merchantId 字段
API Secret仅在你的服务器上计算 signature 时使用,绝不上行