Files
live-hub-py/docs/鱼翅充值api/订单接口/3.订单异步通知_推荐.md
T
2026-08-13 21:43:27 +08:00

48 lines
1.6 KiB
Markdown

# 订单异步通知【推荐】
# 接口说明
- 下单后,如订单流程、时间较长,需要第一时间返回下单成功状态,之后的流程中再去通知外部平台订单的状态
- POST 请求
- 接口地址一般为 ***http://IP******\[:PORT\]/网关/业务/callBackV2***
- 具体地址,请双方开发协定,或联系运营获取
# 请求参数
参数 类型 示例值 必要 描述
请求公共参数 —— 参考接口规范的请求公共参数 是 携带公共参数
out_order_id string OUT202503010010208888 是 来源/外部订单号
order_id string 202503010010208888 是 原厂的订单号
order_type int 4 是 订单类型:0-直充;1-话费;2-流量;3-卡密
order_status int 0 是 "0,待处理;1,处理中
2,成功;3,失败; 4-异常
这里应该只有 2 和 3、4"
fail_reason string 否 失败原因,失败必传
create_time string 2025/3/1 0:10 是 订单创建时间(原厂)
finish_time string 2025/3/1 0:10 是 订单完成时间(原厂)
cards string 加密数据 否 卡密订单时才可能有数据,使用ASE加密,加密方式参考附录的数据加密部分
## cards解密后的结构如下:
```JSON
[
{
card_no: 'CN88889999',(无卡号就填""空串)
card_pwd: 'ABCD-DEFG-GHIJ-JKLM',
expired_time: '2026-09-27 08:36:58',(过期时间,可不传)
price: '8.8',(卡密单价,可不传)
card_type: '0'(不传时,默认为0。0.普通卡密 1.短链)
}
]
```
# 响应信息
参数 类型 示例值 必要 描述
公共参数 —— 请参考接口规范的公共响应信息 是 携带公共参数