接口描述
通过该接口请求发券。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/giftonl/reqcpn
测试调用地址
https://openapi.unionpay.com/upapi/giftonlTest/reqcpn
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-必填 | REQ-CPN
|
|||
| 订单号 | order_no | string | 不超过64位 | M-必填 | 不能重复
|
||
| 报文时间 | txn_time | string | M-必填 | YYYYMMDDHHMMSS
|
|||
| 签名 | sign | string | M-必填 | 请求报文验签，具体见附录3.6
|
|||
| 渠道方id | chnnl_id | string | 11位 | M-必填 | 银联分配的渠道方编码
|
||
| 卡券id | coupon_id | string | 不超过64位 | M-必填 |
|
||
| 购买数量 | buy_qty | string | M-必填 | 数字，不超过10
|
|||
| 用户标识 | user_id | string | M-必填 | 渠道方app的open_id
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | M-必填 | 参考左侧菜单“应答码参照”
|
|||
| 应答消息 | respMsg | string | M-必填 | 如果respCd不是0000，该字段解释了具体的出错原因。
|
|||
| 应答报文 | data | map | M-必填 |
|
示例代码
{
"order_no":"20201010145139320462539",
"chnnl_id":"channel_lc",
"buy_qty":"1",
"sign":"52126CD5BDAA89C9FD7A05F616001858",
"encoding":"UTF-8",
"version":"1.0.0",
"coupon_id":"CPN00000000322",
"txn_type":"REQ-CPN",
"user_id":"TSZCtest",
"txn_time":"20201010145139",
}
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
