接口描述
商户根据账单查询应答信息，申请缴费二维码，同步应答二维码信息；供持卡人扫码支付；持卡人支付完成，银联向行业发起销账，处理成功后通过后台地址发送商户通知。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试调用地址
https://gateway.test.95516.com/gateway/api/backTransReq.do
请求参数 | 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | NS5 | 无 | M-必填 | 固定填写 | |
| 编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 | 默认取值：UTF-8 | |
| 产品类型 | bizType | N6 | 无 | M-必填 |
000601：账单支付 |
|
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 | ||
| 后台通知地址 | backUrl | ANS1..256 | 无 | M-必填 |
后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，不支持换行符等不可见字符，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX| 如果不需要发后台通知，可以固定上送http://www.specialUrl.com |
|
| 交易币种 | currencyCode | AN3 | 无 | M-必填 | 默认为156 | |
| 交易金额 | txnAmt | N1..12 | 无 | M-必填 | ||
| 交易类型 | txnType | N2 | 无 | M-必填 |
取值：13 |
|
| 交易子类 | txnSubType | N2 | 无 | M-必填 |
08: 申请缴费联机二维码 |
|
| 接入类型 | accessType | N1 | 无 | M-必填 |
0：商户直连接入 |
|
| 签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 | |
| 签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3 | |
| 渠道类型 | channelType | N2 | 无 | M-必填 |
07：互联网 08：移动 |
|
| 商户代码 | merId | AN15 | 无 | M-必填 | ||
| 商户订单号 | orderId | AN8..40 | 无 | M-必填 |
商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
| 业务代码 | bussCode | ANS4..20 | 无 | M-必填 |
busscode 三元组：账单类型_地区码_附加地区码 示例：D1_3300_0000 账单类型、地区码、附加地区码参考获取账单业务要素（BIZ）说明 |
|
| 终端信息 | termInfo | ANS 1..1024 | 无 | M-必填 | 查看详情 | |
| 接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 |
接入机构代码时出现 |
|
| 原交易查询流水号 | origQryId | AN21 | 无 | C-按条件必填 |
先查询后缴费的交易，需上送查询交易应答的queryId |
|
| 账单要素 | billQueryInfo | ANS1..2048 | 无 | C-按条件必填 | 查看详情 | |
| 证书ID | certId | N1..128 | 无 | C-按条件必填 | ||
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
| 控制规则 | ctrlRule | N32 | 无 | O-选填 | 32位01字符串控制位，从左至右第二位取值为1时表示小微商户 | |
| 请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | 商户自定义保留域，交易应答时会原样返回 | |
| 支付超时时间 | payTimeout | YYYYMMDDhhmmss | 无 | O-选填 |
主扫申码的时候，表示二维码本身的有效时间，商户未上送默认填1天，商户上送了则取商户上送的，最大有效时间1天 |
|
| 终端号 | termId | ANS8 | 无 | O-选填 | 原则是可以通过交易上送的终端编号准确定位商户每一个门店内每一台收银设备，建议按“门店编号+收银机编号”或“设备编号”组成8位终端编号在交易中上送。商户需将终端编号与门店对应关系反馈给银联。 |
应答报文（同步应答）
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 二维码数据 | qrCode | ANS1..300 | 无 | M-必填 | ||
| 签名 | signature | ANS1..1024 | 0 | M-必填 | ||
| 签名方法 | signMethod | N2 | 无 | M-必填 | ||
| 应答码 | respCode | AN2 | 无 | M-必填 | ||
| 应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
| 接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 | 接入机构代码时出现 |
|
| 签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 |
|
| 版本号 | version | NS5 | 无 | R-需要返回 | ||
| 编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
| 产品类型 | bizType | N6 | 无 | R-需要返回 | ||
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | ||
| 交易类型 | txnType | N2 | 无 | R-需要返回 | ||
| 交易子类 | txnSubType | N2 | 无 | R-需要返回 | ||
| 接入类型 | accessType | N1 | 无 | R-需要返回 | 0：商户直连接入 1：收单机构接入 2：平台商户接入 |
|
| 请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
| 商户代码 | merId | AN15 | 无 | R-需要返回 | ||
| 商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 |
后台通知参数（异步应答）
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 查询流水号 | queryId | AN20..21 | 无 | M-必填 | 消费交易的流水号，供后续查询用 | |
| 交易传输时间 | traceTime | MMDDhhmmss | 无 | M-必填 | ||
| 签名 | signature | ANS1..1024 | 0 | M-必填 | ||
| 签名方法 | signMethod | N2 | 无 | M-必填 | ||
| 系统跟踪号 | traceNo | N6 | 无 | M-必填 | ||
| 应答码 | respCode | AN2 | 无 | M-必填 | ||
| 应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
| 兑换日期 | exchangeDate | MMDD | 无 | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |
| 发卡机构代码 | issInsNo | AN8..11 | 无 | C-按条件必填 | 根据配置返回 | |
| 接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 | 接入机构代码时出现 |
|
| 签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 |
|
| 清算币种 | settleCurrencyCode | AN3 | 无 | C-按条件必填 | 成功时出现 | |
| 清算汇率 | exchangeRate | N8 | 无 | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |
| 清算金额 | settleAmt | N1..12 | 无 | C-按条件必填 | 成功时出现 | |
| 清算日期 | settleDate | MMDD | 无 | C-按条件必填 | 成功时出现 | |
| 银行卡验证信息及身份信息 | customerInfo | ANS1..1024 | 无 | C-按条件必填 | 查看详情 | |
| 账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 成功时出现，根据商户配置返回 | |
| 支付方式 | payType | N4 | 无 | C-按条件必填 | 根据商户配置返回 | |
| 支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | 根据商户配置返回 | |
| 版本号 | version | NS5 | 无 | R-需要返回 | ||
| 编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
| 产品类型 | bizType | N6 | 无 | R-需要返回 | ||
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | ||
| 交易币种 | currencyCode | AN3 | 无 | R-需要返回 | 默认为156 | |
| 交易金额 | txnAmt | N1..12 | 无 | R-需要返回 | ||
| 交易类型 | txnType | N2 | 无 | R-需要返回 | ||
| 交易子类 | txnSubType | N2 | 无 | R-需要返回 | ||
| 接入类型 | accessType | N1 | 无 | R-需要返回 | 0：商户直连接入 1：收单机构接入 2：平台商户接入 |
|
| 请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
| 商户代码 | merId | AN15 | 无 | R-需要返回 | ||
| 商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 |
中国银联版权所有©2002-2023沪 ICP备07032180号
