接口描述
通过该接口请求退券。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/giftonl/rfdcpn
测试调用地址
https://openapi.unionpay.com/upapi/giftonlTest/rfdcpn
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。 | |||
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis();获取 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | M-必填 | 1.0.0
|
|||
| 编码方式 | encoding | string | M-必填 | UTF-8
|
|||
| 报文类型 | txn_type | string | M-必填 | RFD-CPN
|
|||
| 退券单号 | order_no | string | M-必填 | 不能重复
|
|||
| 报文时间 | txn_time | string | 14 | M-必填 | YYYYMMDDHHMMSS
|
||
| 签名 | sign | string | M-必填 | 请求报文验签，具体见附录3.6
|
|||
| 渠道方id | chnnl_id | string | M-必填 |
|
|||
| 礼券id | coupon_id | string | M-必填 |
|
|||
| 券码号 | coupon_code | string | M-必填 |
|
|||
| 原发券订单号 | orig_order_no | string | C-按条件必填 | 预付款模式必传
|
|||
| 原发券时间 | orig_txn_time | string | C-按条件必填 | 预付款模式必传
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答消息 | respMsg | string | M-必填 | 如果respCd不是0000，该字段解释了具体的出错原因。
|
|||
| 应答报文 | data | map | M-必填 |
|
|||
| 应答码 | respCd | string | M-必填 | 参考左侧菜单“应答码参照”
|
示例代码
{
"order_no":"20201010155313320463278",
"chnnl_id":"channel_lc",
"coupon_code":"320462887676724",
"coupon_id":"CPN00000000322",
"txn_type":"RFD-CPN",
"txn_time":"20201010155313",
"sign":"75E27A8D51EE97DB626CBE8E8D847A36",
"encoding":"UTF-8",
"version":"1.0.0"
}
中国银联版权所有©2002-2023沪 ICP备07032180号
