新增 docs/抖音-码速达:把新平台(dy-openplatform-api.wanmahui.com)联调文档页的 全部数据落到仓库,供离线查阅与后续对接。 数据来源:文档页把全部数据内嵌在隐藏 input#raw_data 的 JSON 里(api / message / fee / menu 四块),一次请求即取全,无需逐页爬取。 内容: - README.md:平台速览(网关、鉴权要素、计费)、14 条消息与 16 个接口总表、对接六步; - 01-计费规则.md:免费/基础(1 金豆)/高级(2 金豆)/增值(4 金豆)四档与各接口分级; - 02-接口调用规范与签名.md:网关 POST /api/openplatform/gateway、公共参数 uid/method/timestamp/sign、MD5 签名算法与可复算示例、返回结构; - 03-消息推送规范与签名.md:topic/pub_time/sign 走 URL、data 走 POST body、 验签要点、message.config 消息设置、messagetest 测试入口; - 接口API/ 16 篇:请求参数、返回字段(层级缩进)、可解析的返回示例 JSON、 签名原串 + MD5 结果; - 消息推送/ 14 篇:topic、data 字段、示例 JSON、签名原串 + MD5 结果; - data/raw_data.json(与页面快照逐字段校验一致)、data/page.html、data/代码示例/ (页面内置 JAVA/.NET/PHP 示例 6 份)、data/crawl-meta.json(抓取元信息与文件 MD5)。 校验:接口 16/16、消息 14/14 无缺漏,33 段示例 JSON 全部可解析,内部链接全部可达。 文档页访问令牌已隐去(凭据不入库)。04~06 的分析类文档暂不入库,仅保留本地。
4.0 KiB
4.0 KiB
充值结果提交(topup.result)
本页数据抓取自抖音码速达开放平台「接口API → 充值结果提交」。
| 项目 | 内容 |
|---|---|
| 接口名称 | 充值结果提交 |
| 方法名 method | topup.result |
| 功能分级 | 基础功能 |
| 请求地址 | POST https://dy-openplatform-api.wanmahui.com/api/openplatform/gateway |
| Content-Type | application/x-www-form-urlencoded |
| 说明 | 商家处理完充值请求后,异步回调告知平台充值结果 |
| 抖店原始路径 | /topup/result |
| 抖店原始文档 | 商家充值结果回调 |
请求参数
| 参数名 | 类型 | 必填 | 提交方式 | 说明 |
|---|---|---|---|---|
| uid | String | 是 | Post | 抖店商户号(公共参数,示例 111111111) |
| method | String | 是 | Post | 方法名,固定为 topup.result(公共参数) |
| timestamp | String | 是 | Post | 秒级时间戳,10 分钟内有效(公共参数) |
| sign | String | 是 | Post | 签名,签名原串 MD5(小写),见「接口调用规范与签名」 |
| trade_order_no | String | 是 | Post | 订单号,示例:47544092076043809181 |
| topup_biz | String | 是 | Post | 充值业务,示例:MOBILE_TOPUP |
| seller_order_no | String | 是 | Post | 商家充值单号,示例:DY8123123 |
| seller_order_status | String | 是 | Post | 充值结果,示例:SUCCESS |
| err_code | String | 否 | Post | 错误码,示例:1003 |
| err_desc | String | 否 | Post | 错误信息,示例:参数校验失败 |
| url | String | 否 | Post | 去使用链接,示例:https://xxxx.com |
| url_type | String | 否 | Post | 去使用链接类型:microapp-小程序,normal-普通链接,示例:normal |
| topup_failure_reason_code | String | 否 | Post | 充值失败错误码:10001-手机号码无效,10002-商家缺货,10003-命中运营商风控策略,示例:10001 |
返回参数
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| data | Object | `` | 返回数据 |
| trade_order_no | String | 4754409207604380918 |
平台订单号 |
| topup_biz | String | MOBILE_TOPUP |
充值业务 |
| result | String | FAILED |
平台接口充值结果失败 |
| seller_order_no | String | DY8123123 |
商家充值单号 |
| err_code | String | -1 |
错误码 |
| err_desc | String | 内部错误 |
错误信息 |
返回示例
{
"code": "10000",
"message": "成功",
"data": {
"trade_order_no": "4754409207604380918",
"topup_biz": "MOBILE_TOPUP",
"result": "FAILED",
"seller_order_no": "DY8123123",
"err_code": "-1",
"err_desc": "内部错误"
}
}
签名原串示例
除 sign 外的全部参数按参数名字典序拼接 参数名+参数值,首尾各加一次用户秘钥(这里用占位秘钥 XXXXXXXXXXXXXXXXXXXX、占位商户号 111111111、时间戳 1780000000):
XXXXXXXXXXXXXXXXXXXXerr_code1003err_desc参数校验失败methodtopup.resultseller_order_noDY8123123seller_order_statusSUCCESStimestamp1780000000topup_bizMOBILE_TOPUPtopup_failure_reason_code10001trade_order_no47544092076043809181uid111111111urlhttps://xxxx.comurl_typenormalXXXXXXXXXXXXXXXXXXXX
参数名排序:err_code、err_desc、method、seller_order_no、seller_order_status、timestamp、topup_biz、topup_failure_reason_code、trade_order_no、uid、url、url_type
sign = md5(签名原串)(32 位小写)= 9322cbc2e8f5cce0b2931cbe9eb6e312
请求代码示例
页面内置 JAVA / .NET / PHP 三种示例代码,已原样保存:
data/代码示例/接口API-请求示例-JAVA.txtdata/代码示例/接口API-请求示例-DOTNET.txtdata/代码示例/接口API-请求示例-PHP.txt
第 2 / 16 个接口 | 导航: 返回索引