八、订单状态回调(推荐)
8.1 请求接口
- 请求方式:Post
- 接收类型:raw/json
- 返回:json
- 说明:订单状态为已发货、已完成、已撤单、已取消、审核不通过时,才会推送。
8.2 推送地址
接口开发完成,请前往 172号卡订单管理系统(PC端) 设置回调地址(右上角)。
8.3 推送请求头
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
sign | String | Y | 可以通过AES解密对比172平台订单号进行签名验证。 secret秘钥:向管理员索取。 向量:MengLong172HaoKa。 具体可以参考这个网站的解密结果 AES解密工具 ![]() |
8.4 推送请求参数
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
RequidId | String | Y | 推送请求Id,唯一。推送失败时,会重复请求这条Id的信息。 |
Data | String | Y | 返回订单信息,Json字符串格式。 |
8.5 Data订单信息参数
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
OrderNo | String | Y | 合作方订单号。 |
OrderNo172 | String | Y | 172平台订单号,请求头sign里加密的是这个号码。 |
OrderStatus | String | Y | 订单状态: 已发货,已完成,审核不通过,已取消,已撤单。 |
ThirdPhone | String | N | 办理号码。 |
Remark | String | N | 备注失败原因。 |
ExpressName | String | N | 物流公司。 |
ExpressCode | String | N | 物流单号。 |
CardStatus | String | N | 激活状态: 已激活,未激活,可能为Null。 |
ActiveTime | String | N | 激活时间,格式:yyyy-MM-dd HH:mm:ss,可能为Null。 |
IsFirstCharge | Int | N | 是否首充: 0 未首充 1 已首充。 |
FirstCharge | String | N | 首充金额。 |
8.6 推送返回
8.6.1 成功返回
上传成功code
返回0
,如果返回非0
,message
是错误提示信息。
json
{
"code": 0,
"message": "上传成功"
}
8.6.2、错误返回
json
{
"code":-1,
"message":"错误"
}