持卡人被商户用扫描枪扫码,发起预授权。预授权交易用于受理方向持卡人的发卡方确认交易许可。受理方将预估的消费金额作为预授权金额,发送给持卡人的发卡方。
POST
https://gateway.95516.com/gateway/api/backTransReq.do
https://gateway.test.95516.com/gateway/api/backTransReq.do
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 | 默认取值:UTF-8 | |
签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 | |
产品类型 | bizType | N6 | 无 | M-必填 | 000201 | |
接入类型 | accessType | N1 | 无 | M-必填 | 0:普通商户直连接入 1:收单机构接入 2:平台类商户接入 | |
商户代码 | merId | AN15 | 无 | M-必填 | ||
二级商户代码 | subMerId | AN5..15 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
二级商户名称 | subMerName | ANS1..40 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
二级商户简称 | subMerAbbr | ANS1…16 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
商户订单号 | orderId | AN8..40 | 无 | M-必填 | 预授权的订单号,由商户生成 | |
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 | ||
交易币种 | currencyCode | AN3 | 无 | M-必填 | 默认为156 | |
交易金额 | txnAmt | N1..12 | 无 | M-必填 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
终端号 | termId | ANS8 | 无 | O-选填 | ||
风控信息域 | riskRateInfo | ANS 1..2048 | 无 | O-选填 | 查看详情 | |
渠道类型 | channelType | N2 | 无 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 | |
交易类型 | txnType | N2 | 无 | M-必填 | 取值:02 | |
交易子类 | txnSubType | N2 | 无 | M-必填 |
04:二维码预授权 |
|
后台通知地址 | backUrl | ANS1..256 | 无 | M-必填 | 后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX| | |
请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | 商户自定义保留域,交易应答时会原样返回 | |
证书ID | certId | N1..128 | 无 | M-必填 | ||
版本号 | version | NS5 | 无 | M-必填 | 固定填写 | |
接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 |
接入机构代码时出现 |
|
C2B码 | qrNo | N1..20 | 无 | M-必填 |
特定格式的数字串,用于C2B场景下的二维码支付。 C2B码的默认有效时间为3分钟 |
|
收款方附加数据 | acqAddnData | ANS 1..8000 | O-选填 | 查看详情 | ||
终端信息 | termInfo | ANS 1..1024 | 无 | M-必填 | 查看详情 | |
控制规则 | ctrlRule | N32 | 无 | O-选填 |
32位01字符串控制位, 从左至右第五位取值为1时表示不返signPubKeyCert字段 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
签名 | signature | ANS1..1024 | 0 | M-必填 | ||
产品类型 | bizType | N6 | 无 | R-需要返回 | ||
接入类型 | accessType | N1 | 无 | R-需要返回 | ||
商户代码 | merId | AN15 | 无 | R-需要返回 | ||
商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | ||
交易币种 | currencyCode | AN3 | 无 | M-必填 | 默认为156 | |
交易金额 | txnAmt | N1..12 | 无 | R-需要返回 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
查询流水号 | queryId | AN20..21 | 无 | M-必填 | 预授权交易的流水号,供后续查询用 | |
应答码 | respCode | AN2 | 无 | M-必填 | ||
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | ||
签名公钥证书 | signPubKeyCert | AN2048 | 无 | C-按条件必填 | 使用RSA签名方式时必选,此域填写银联签名公钥证书。 | |
交易类型 | txnType | N2 | 无 | R-需要返回 | ||
交易子类 | txnSubType | N2 | 无 | R-需要返回 | ||
请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
版本号 | version | NS5 | 无 | R-需要返回 | ||
接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 | 接入机构代码时出现 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
签名 | signature | ANS1..1024 | 0 | M-必填 | ||
产品类型 | bizType | N6 | 无 | R-需要返回 | ||
接入类型 | accessType | N1 | 无 | R-需要返回 | ||
商户代码 | merId | AN15 | 无 | R-需要返回 | ||
商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | ||
支付方式 | payType | N4 | 无 | C-按条件必填 | 根据商户配置返回 | |
交易币种 | currencyCode | AN3 | 无 | M-必填 | 默认为156 | |
账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 根据商户配置返回 | |
交易金额 | txnAmt | N1..12 | 无 | R-需要返回 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
查询流水号 | queryId | AN20..21 | 无 | M-必填 | 预授权交易的流水号,供后续查询用 | |
系统跟踪号 | traceNo | N6 | 无 | M-必填 | ||
交易传输时间 | traceTime | MMDDhhmmss | 无 | M-必填 | ||
清算日期 | settleDate | MMDD | 无 | M-必填 | ||
清算币种 | settleCurrencyCode | AN3 | 无 | M-必填 | ||
清算金额 | settleAmt | N1..12 | 无 | M-必填 | ||
清算汇率 | exchangeRate | N8 | 无 | C-按条件必填 | 交易成功,交易币种和清算币种不一致的时候返回 | |
兑换日期 | exchangeDate | MMDD | 无 | C-按条件必填 | 交易成功,交易币种和清算币种不一致的时候返回 | |
应答码 | respCode | AN2 | 无 | M-必填 | ||
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | ||
签名公钥证书 | signPubKeyCert | AN2048 | 无 | C-按条件必填 | 使用RSA签名方式时必选,此域填写银联签名公钥证书。 | |
交易类型 | txnType | N2 | 无 | R-需要返回 | ||
交易子类 | txnSubType | N2 | 无 | R-需要返回 | ||
请求方保留域 | reqReserved | ANS1..1024 | 无 | M-必填 | 预授权交易的流水号,供后续查询用 | |
版本号 | version | NS5 | 无 | R-需要返回 | ||
接入机构代码 | accInsCode | AN8..11 | 无 | C-按条件必填 | 接入机构代码时出现 |
|
支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | 消费交易,视商户配置返回。该域取值为: 00:未知 01:借记账户 02:贷记账户 03:准贷记账户 04:借贷合一账户 05:预付费账户 06:半开放预付费账户 |
|
发卡机构代码 | issInsNo | AN8..11 | 无 | C-按条件必填 | 根据配置返回 |
|
APP代码 | appCode | AN1..11 | C-按条件必填 | 付款APP机构代码,根据配置返回 |
||
订单优惠信息 | issAddnData | ANS1..8000 | O-选填 | 查看详情 |
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”;
交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常