订单信息同步
接口描述
本接口只对有业务合作的内容方开放,内容方根据自身的订单状态改变情况通知权益平台,权益平台会根据不同的订单状态进行权益核销、恢复等操作
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/upbms/notifyOrderState
测试调用地址
https://openapi.unionpay.com/upapi/upbmstest/notifyOrderState
URL请求参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
产品token |
token |
string |
|
|
M-必填
|
详情请参考“获取token”接口中应答参数“token”的具体数据。 |
|
签名信息 |
sign |
string |
|
|
M-必填
|
详细签名算法可参考“技术指南”板块第3条。 |
|
时间戳 |
ts |
long |
|
|
M-必填
|
单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。 |
HTTP报文体参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
银联流水号 |
orderId |
string |
20 |
|
M-必填
|
权益平台订单号
|
|
商户订单号 |
merOrderId |
string |
|
|
C-按条件必填
|
供应商订单号
|
|
订单状态 |
state |
string |
2 |
|
C-按条件必填
|
参照订单状态字典
|
|
订单补充信息 |
reserve |
map |
|
|
O-选填
|
订单补充信息
|
同步应答参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
应答码 |
respCd |
string |
6 |
|
M-必填
|
参考左侧菜单“应答码参照”
|
|
应答消息 |
respMsg |
string |
|
|
C-按条件必填
|
如果respCd不是0000,该字段解释了具体的出错原因。
|
示例代码