48 lines
1.6 KiB
Markdown
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.短链)
|
|
}
|
|
]
|
|
```
|
|
|
|
# 响应信息
|
|
参数 类型 示例值 必要 描述
|
|
公共参数 —— 请参考接口规范的公共响应信息 是 携带公共参数
|
|
|
|
|