订单结果状态回调API

简要描述

订单结果回调

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

请求地址：

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

返回结果说明

SUCCESS

请求示例

POST方式提交， 数据格式：Content-Type: application/json  假设密钥为：test

请求地址：
http://xxxxx.com/api/callback
请求参数：
{
    "supplierAccountGuid": "test-merchant",
    "productNo": 22102100000517,
    "productCost": "100.980",
    "priceVer": 1640966400,
    "timestamp": 1640966400,
    "sign": "6a8380f2846f63918d773c61d4dbb960"
}

请求返回示例：

{
    "code":200,
    "msg":"success"
}

签名验证算法

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

注：验签的密钥需要保密，验签的目的：1、主要是提供信息来源可靠性验证 2、数据不可串改的安全性保障 3、时效性控制。所以建议商家，做好验签

处理建议

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

请求参数

Body 参数application/json

order_id

integer

平台充值订单号

必需

充值接口返回(优先使用)

third_id

string

商家侧订单ID

必需

biz_no

string

sku编码（仅参考

必需

real_amount

integer

实际充值金额

必需

state

enum<integer>

订单状态

必需

枚举值:

234416

cost

number

必需

info

string

订单费用

必需

非代充业务订单成功state=3可取用

time

string

订单处理时间

必需

voucher

string

凭证信息

必需

card_no

string

如果我们是卡密充值，那么会返回卡号

必需

error_code

enum<integer>

错误码

必需

枚举值:

123

sign

string

签名

必需

签名算法详见<签名验证算法>

ys_cards

卡密或兑换码信息

可选

一手卡密或代下单-餐饮的时候，需要上报

Any of

一手卡密返回信息

代餐返回信息

一手卡密订单成功时返回多张卡密返回多个

card_type

integer

卡类型

必需

卡类型、1:普通类型,返回卡号卡密、2:兑换码,返回卡密、3:链接类型，返回卡链接、4:二维码返回二维码地址

card_no

string

卡号

必需

卡号，卡类型普通类型该字段必填

card_pwd

string

卡密

必需

卡密，卡类型 2,3,4 时候，该字段必填卡密、卡链接、二维码地址统一使用此字段

示例

{
    "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

简要描述#

订单结果回调#

请求地址：#

返回结果说明#

请求示例#

请求返回示例：#

签名验证算法#

请求参数

示例代码

返回响应

简要描述

订单结果回调

请求地址：

返回结果说明

请求示例

请求返回示例：

签名验证算法