订单结果状态回调API
POST
简要描述
订单结果回调
注：商家提供API 由充值平台回调商户URL
商户正式上线时，请提交回调url,服务器IP等信息，交由平台方配置
字段：ys_cards 为数组，如果字段值有回调的话，需要参与验签，拼接的默认值设置为：Array
ys_cards参数样例转json后如下 实际以表单为准
#网址模式（餐饮，卡密url下单）
[{"card_pwd":"https:\/\/mdlp.com\/#\/pages\/store\/list?sic42y","card_type":3}]
#卡密模式
[{"card_no":"JDV16751600092119","card_pwd":"9ax4-4112-7015-2840","card_type":1}]请求地址：
http://xxxxx.com【商户提供域名】如需真实获得回调 可提供公网回调地址地址：
/api/callback 【接口范例】请求：
POST返回结果说明
订单回调状态说明：
| state | 状态名 | 备注 | 处理结果 |
|---|---|---|---|
| 3 | 充值成功 | 充值结果 | 处理成功 |
| 4 | 充值失败 | 充值结果 | 处理失败 |
| 41 | 充值结果未知 | 充值结果未知 | 人工核实 |
签名验证算法参考
卡密模式下返回的ys_cards不参与签名
因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法
注：验签的密钥需要保密，验签的目的：1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家，做好验签
调试是可以重复触发回调接口 用于调试
[图片]
处理建议
1．订单如果提交10-120分钟未返回终止状态（状态码4失败、3成功）建议每隔5-10分钟通过查询接口查询订单最新状态
2．订单如果提交120分钟以上仍未返回终止状态，且查询状态也返回处理中，即可通知双方运营人员查明原因，一起协商处理
3．在前端管理平台，运营人员可发起状态查询请求，查询平台订单最新状态，同步订单状态
请求参数
Body 参数multipart/form-data
请求示例代码
返回响应
修改于 2026-03-12 03:42:29