八、订单状态回调（推荐） ​

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

<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  "code"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">0</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  "message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"&#x4E0A;&#x4F20;&#x6210;&#x529F;"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>

8.6.2、错误返回 ​

json

<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"code"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">-1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">"message"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">:</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"&#x9519;&#x8BEF;"</span></span>
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span>