订单结果状态回调API

简要描述

订单结果回调

注：商家提供API 由充值平台回调商户URL
商户正式上线时，请提交回调url,服务器IP等信息，交由平台方配置
字段：ys_cards 为数组，参与拼接的默认值设置为：Array

请求地址：

请求域名：http://xxxxx.com【商户提供域名】如需真实获得回调可提供公网回调地址
地址：/api/callback 【接口范例】
请求：POST

返回结果说明

SUCCESS

签名验证算法参考

卡密模式下返回的ys_cards不参与签名

因JAVA版本的MD5和PHP 存在一定差异 JAVA编码在使用MD5时请参考放单的加密方法

注：验签的密钥需要保密，验签的目的：1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家，做好验签
调试是可以重复触发回调接口用于调试
[图片]

处理建议

这是一个注意类告示
1．订单如果提交10-120分钟未返回终止状态（状态码8失败、9成功）建议每隔5-10分钟通过查询接口查询订单最新状态
2．订单如果提交120分钟以上仍未返回终止状态，且查询状态也返回处理中，即可通知双方运营人员查明原因，一起协商处理
3．在前端管理平台，运营人员可发起状态查询请求，查询平台订单最新状态，同步订单状态

请求参数

Body 参数application/json

示例

{
    "biz_no": "SK000001",
    "order_id": 22102100000517,
    "third_id": "SJ221789094701_1_1",
    "real_amount": 0,
    "state": 4,
    "cost": 10.1,
    "info": "卡密格式错误#",
    "time": "2022-09-21 11:24:23",
    "voucher": "",
    "card_no": "",
    "error_code": "2",
    "sign": "f30f0f637606c145d284c8eb2625e17b"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

简要描述#

订单结果回调#

请求地址：#

返回结果说明#

签名验证算法参考#

卡密模式下返回的ys_cards不参与签名#