接口能力
下单、查询、通知、对账，五类接口够用
-
直充下单
话费、会员类商品直接充到用户账号
-
卡密下单
返回兑换码或卡密，由你的系统展示给用户
-
订单查询
按外部订单号查询实时状态
-
回调通知
订单完成或失败主动通知，未返回 success 自动重试
-
对账下载
按日下载订单与资金对账文件
快速上手
一个请求就能下单
请求与回调都带签名，验签通过再处理。字段以控制台内文档为准。
-
签名方式
HMAC-SHA256，小写十六进制，随 X-Sign 请求头发送
-
传输协议
所有请求走 HTTPS，时间戳与服务器时间相差不超过 300 秒
-
超时建议
请求超时建议设为 10 秒，超时后按订单号查询，不要换号重下
待签名串
stringToSign = appId + "\n" + timestamp + "\n" + nonce + "\n" + payload
POST 的 payload 为请求 body 原文；GET 为按 key 升序拼接的 query。
沙箱 sandbox-api.tobunny.com，正式 api.tobunny.com，两者路径与参数一致，切换只需更换域名与密钥。
POST https://sandbox-api.tobunny.com/v1/orders
Content-Type: application/json
X-App-Id: your_app_id
X-Timestamp: 1790648400
X-Nonce: 3f9a1c7e5b2d4a68
X-Sign: 9d2c…（HMAC-SHA256 小写十六进制）
{"outOrderNo":"ORD20260930000123","goodsId":"G200013","quantity":1,"account":"13800000000","notifyUrl":"https://your-domain.com/callback/tusi"}{
"orderId": "T2026093012345678",
"outOrderNo": "ORD20260930000123",
"goodsId": "G200013",
"quantity": 1,
"status": "success",
"cards": [],
"failReason": "",
"finishedAt": "2026-09-30T10:21:08+08:00"
}回调请求头同样带 X-App-Id、X-Timestamp、X-Nonce、X-Sign。请在 5 秒内返回 HTTP 200 且响应体为 success，否则按 1 分钟至 24 小时的间隔重试 6 次，并按 outOrderNo 做幂等。
接入流程
最快当天完成联调
-
STEP 01
注册开通
提交企业资料，开通账户并获取 AppId 与 AppSecret。
-
STEP 02
沙箱联调
在沙箱环境调用下单、查询和回调接口，不产生真实扣款。
-
STEP 03
审核上线
联调通过后提交上线申请，切换到正式接口地址。
-
STEP 04
正式发放
预存余额后实时下单发放，订单与对账随时可查。
