接口描述
商户组织消费交易报文，发送报文给后台系统，后台系统完成交易处理，并将组织受理结果报文和交易结果返回商户。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试调用地址
https://gateway.test.95516.com/gateway/api/backTransReq.do
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5.1.0 | M-必填 | 固定填写
|
||
| 编码方式 | encoding | string | UTF-8 | M-必填 | 默认取值：UTF-8
|
||
| 证书ID | certId | string | C-按条件必填 |
|
|||
| 签名 | signature | string | M-必填 | 填写对报文摘要的签名
|
|||
| 签名方法 | signMethod | string | M-必填 | 非对称签名：01（表示采用RSA签名）
HASH表示散列算法
11：支持散列方式验证SHA-256
12：支持散列方式验证SM3
|
|||
| 交易类型 | txnType | string | 1.0 | M-必填 | 取值：01
|
||
| 交易子类 | txnSubType | string | 10.0 | M-必填 | 28
|
||
| 产品类型 | bizType | string | 6 | M-必填 | 默认000000
|
||
| 渠道类型 | channelType | string | 2 | M-必填 | 07/08
|
||
| 前台通知地址 | frontUrl | string | O-选填 | 前台返回商户结果时使用，前台类交易需上送
|
|||
| 后台通知地址 | backUrl | string | M-必填 | 后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX|
|
|||
| 接入类型 | accessType | string | M-必填 | 0：普通商户直连接入
1：收单机构接入
2：平台类商户接入
|
|||
| 收单机构代码 | acqInsCode | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户类别 | merCatCode | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户代码 | merId | string | M-必填 |
|
|||
| 商户名称 | merName | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户英文名称 | merEnName | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 商户简称 | merAbbr | string | C-按条件必填 | 接入类型为收单机构接入时需上送
|
|||
| 二级商户代码 | subMerId | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户全称 | subMerName | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户简称 | subMerAbbr | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 商户订单号 | orderId | string | M-必填 | 商户端生成
|
|||
| 订单发送时间 | txnTime | string | M-必填 | 商户发送交易时间
|
|||
| 签约协议号 | contractId | string | M-必填 | 交易子类为10签约支付时必送
|
|||
| 交易金额 | txnAmt | string | M-必填 | 单位为分
|
|||
| 交易币种 | currencyCode | string | 156.0 | M-必填 | 默认为156
|
||
| 银行卡验证信息及身份信息 | customerInfo | string | C-按条件必填 | 1、后台类消费交易时上送
2、认证支付2.0，后台交易时可选
Key=value格式
（具体填写参考数据元说明）
|
|||
| 订单接收超时时间（防钓鱼使用） | orderTimeout | string | O-选填 | 1、前台类消费交易时上送
2、认证支付2.0，后台交易时可选
|
|||
| 终端号 | termId | string | O-选填 |
|
|||
| 请求方保留域 | reqReserved | string | O-选填 | 商户自定义保留域，交易应答时会原样返回
|
|||
| 保留域 | reserved | string | O-选填 |
|
|||
| 风险信息域 | riskRateInfo | string | O-选填 |
|
|||
| 加密证书ID | encryptCertId | string | C-按条件必填 |
|
|||
| 发卡机构代码 | issInsCode | string | O-选填 |
|
|||
| 终端信息域 | userMac | string | O-选填 | 移动支付业务需要上送
|
|||
| 持卡人IP | customerIp | string | O-选填 | 前台交易，有IP防钓鱼要求的商户上送
|
|||
| 订单描述 | orderDesc | string | C-按条件必填 | 移动支付上送
|
|||
| 分账域 | accSplitData | string | O-选填 | 分账域，用法参见注13
该域需整体做Base64编码。
|
|||
| 控制规则 | ctrlRule | string | O-选填 | 32位01字符串控制位，从左至右第四位取值为1时表示需要强制分期处理
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | R-需要返回 |
|
|||
| 编码方式 | encoding | string | R-需要返回 |
|
|||
| 签名 | signature | string | M-必填 |
|
|||
| 签名方法 | signMethod | string | M-必填 |
|
|||
| 交易类型 | txnType | string | R-需要返回 |
|
|||
| 交易子类 | txnSubType | string | R-需要返回 |
|
|||
| 产品类型 | bizType | string | R-需要返回 |
|
|||
| 接入类型 | accessType | string | R-需要返回 |
|
|||
| 收单机构代码 | acqInsCode | string | C-按条件必填 |
|
|||
| 商户代码 | merId | string | R-需要返回 |
|
|||
| 商户订单号 | orderId | string | R-需要返回 |
|
|||
| 订单发送时间 | txnTime | string | R-需要返回 |
|
|||
| 交易金额 | txnAmt | string | R-需要返回 |
|
|||
| 交易币种 | currencyCode | string | R-需要返回 | 默认为156
|
|||
| 请求方保留域 | reqReserved | string | R-需要返回 |
|
|||
| 保留域 | reserved | string | O-选填 |
|
|||
| 交易查询流水号 | queryId | string | O-选填 |
|
|||
| 响应码 | respCode | string | M-必填 |
|
|||
| 应答信息 | respMsg | string | M-必填 |
|
|||
| 账号 | accNo | string | C-按条件必填 | 根据商户配置返回
|
|||
| 支付卡类型 | payCardType | string | C-按条件必填 | 根据商户配置
|
|||
| 支付方式 | payType | string | C-按条件必填 | 根据商户配置
|
|||
| 银联订单号 | tn | string | C-按条件必填 | 商户推送订单后银联移动支付系统返回该流水号，商户调用支付控件时使用
|
|||
| 签名公钥证书 | signPubKeyCert | string | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
|
异步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | R-需要返回 | ||||
| 编码方式 | encoding | string | R-需要返回 | ||||
| 签名 | signature | string | M-必填 | ||||
| 签名方法 | signMethod | string | M-必填 | ||||
| 交易类型 | txnType | string | R-需要返回 | ||||
| 交易子类 | txnSubType | string | R-需要返回 | ||||
| 产品类型 | bizType | string | R-需要返回 | ||||
| 接入类型 | accessType | string | R-需要返回 | ||||
| 收单机构代码 | acqInsCode | string | C-按条件必填 | ||||
| 商户代码 | merId | string | R-需要返回 | ||||
| 商户订单号 | orderId | string | R-需要返回 | ||||
| 订单发送时间 | txnTime | string | R-需要返回 | ||||
| 交易金额 | txnAmt | string | R-需要返回 | ||||
| 交易币种 | currencyCode | string | R-需要返回 | 默认为156 | |||
| 请求方保留域 | reqReserved | string | R-需要返回 | ||||
| 保留域 | reserved | string | O-选填 | ||||
| 交易查询流水号 | queryId | string | M-必填 | ||||
| 响应码 | respCode | string | M-必填 | ||||
| 响应信息 | respMsg | string | M-必填 | ||||
| 清算金额 | settleAmt | string | M-必填 | ||||
| 清算币种 | settleCurrencyCode | string | M-必填 | ||||
| 清算日期 | settleDate | string | M-必填 | ||||
| 系统跟踪号 | traceNo | string | M-必填 | ||||
| 交易传输时间 | traceTime | string | M-必填 | ||||
| 兑换日期 | exchangeDate | string | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |||
| 汇率 | exchangeRate | string | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |||
| 账号 | accNo | string | C-按条件必填 | 根据商户配置返回 | |||
| 支付卡类型 | payCardType | string | C-按条件必填 | 根据商户配置返回 | |||
| 支付方式 | payType | string | C-按条件必填 | 根据商户配置返回 | |||
| 支付卡标识 | payCardNo | string | C-按条件必填 | 移动支付交易时，根据商户配置返回 | |||
| 支付卡名称 | payCardIssueName | string | C-按条件必填 | 移动支付交易时，根据商户配置返回 | |||
| 签名公钥证书 | signPubKeyCert | string | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 |
示例代码
参考https://open.unionpay.com/tjweb/acproduct/APIList?acpAPIId=532&&apiservId=450&&version=V2.2
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
