境内外持卡人在境内行购物等消费时用银行卡结算的交易,经批准的消费额将即时地反映到该持卡人的账户余额上。
POST
https://gateway.95516.com/gateway/api/appTransReq.do
https://gateway.test.95516.com/gateway/api/appTransReq.do
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | M-必填 |
固定填写5.1.0 |
|
编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 |
填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写,默认取值:UTF-8 |
|
证书ID | certId | N1..128 | 无 | C-按条件必填 |
填写签名私钥证书的Serial Number,该值可通过银联提供的SDK获取 |
|
签名 | signature | ANS1..1024 | 0 | M-必填 |
填写对报文摘要的签名 |
|
签名方法 | signMethod | N2 | 无 | M-必填 |
非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 |
|
交易类型 | txnType | N2 | 无 | M-必填 |
取值: 00:查询交易 01:消费 02:预授权 03:预授权完成 04:退货 05:圈存 11:代收 12:贷记 13:账单支付 14:转账(保留) 21:批量交易 22:批量查询 31:消费撤销 32:预授权撤销 33:预授权完成撤销 72:实名认证-建立绑定关系 73:账单查询 74:解除绑定关系 75:查询绑定关系 76:文件传输 77:发送短信验证码交易 78:开通查询交易 79:开通交易 94:IC卡脚本通知 95:查询更新加密公钥证书 |
|
交易子类 | txnSubType | N2 | 无 | M-必填 |
依据实际交易类型填写 00001注 默认取值:00 |
|
产品类型 | bizType | N6 | 无 | M-必填 |
依据实际业务场景填写(目前仅使用后4位,前面2位默认为00) 默认取值:000000 具体取值范围: 000201:B2C网关支付 000301:认证支付2.0 000302:评级支付 000401:贷记 000501:代收 000601:账单支付 000801:跨行收单 000901:绑定支付 001001:订购 00001注 000202:B2B |
|
渠道类型 | channelType | N2 | 无 | M-必填 |
05:语音 07:互联网 08:移动 16:数字机顶盒 |
|
前台通知地址 | frontUrl | ANS1..256 | 无 | O-选填 |
前台返回商户结果时使用,前台类交易需上送 不支持换行符等不可见字符 |
|
后台通知地址 | backUrl | ANS1..256 | 无 | M-必填 |
后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,不支持换行符等不可见字符,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX| 如果不需要发后台通知,可以固定上送http://www.specialUrl.com |
|
接入类型 | accessType | N1 | 无 | M-必填 |
0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 |
已被批准加入银联互联网系统的收单机构代码 |
|
商户类别 | merCatCode | N4 | 无 | C-按条件必填 |
填写MCC码,接入类型为收单机构接入时需上送 |
|
商户代码 | merId | AN15 | 无 | M-必填 |
已被批准加入银联互联网系统的商户代码 |
|
商户名称 | merName | ANS1..40 | 无 | C-按条件必填 |
接入类型为收单机构接入时需上送 不支持换行符等不可见字符 |
|
商户英文名称 | merEnName | ANS40 | C-按条件必填 | 查看详情 | ||
商户简称 | merAbbr | ANS1..8 | 无 | C-按条件必填 |
接入类型为收单机构接入时需上送 最长8位,不支持换行符等不可见字符 |
|
二级商户代码 | subMerId | AN5..15 | 无 | C-按条件必填 |
商户类型为平台类商户接入时必须上送 |
|
二级商户名称 | subMerName | ANS1..40 | 无 | C-按条件必填 |
商户类型为平台类商户接入时必须上送 最长40个字节,不支持换行符等不可见字符 |
|
二级商户简称 | subMerAbbr | ANS1…16 | 无 | C-按条件必填 |
仅支持字母或汉字或其组合,最长8位,不支持换行符等不可见字符。 商户类型为平台类商户接入时必须上送 |
|
商户订单号 | orderId | AN8..40 | 无 | M-必填 |
商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 |
商户发送交易时间 |
|
账号 | accNo | AN1..1024 | 无 | C-按条件必填 |
交易账号。请求时使用加密公钥对交易账号加密,并做Base64编码后上送;应答时如需返回,则使用签名私钥进行解密。 前台交易可由银联页面采集,也可由商户上送并返显。如需锁定返显卡号,应通过保留域(reserved)上送卡号锁定标识。 |
|
交易金额 | txnAmt | N1..12 | 无 | M-必填 |
单位为分 |
|
交易币种 | currencyCode | AN3 | 无 | M-必填 |
币种格式必须为3位代码,默认取值:156(人民币) |
|
银行卡验证信息及身份信息 | customerInfo | ANS1..1024 | 无 | O-选填 | 查看详情 | |
支付超时时间 | payTimeout | YYYYMMDDhhmmss | 无 | O-选填 |
订单支付超时时间,超过此时间用户支付成功的交易,不通知商户,系统自动退款,大约5个工作日金额返还到用户账户 |
|
请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
风控信息域 | riskRateInfo | ANS 1..2048 | 无 | O-选填 | 查看详情 | |
默认支付方式 | defaultPayType | N4 | 无 | O-选填 |
取值如下: 0001:认证支付 0004:储值卡支付 0005:IC卡支付 0201:网银支付 0404:互联网订单手机支付 0501:指定HCE支付 |
|
发卡机构代码 | issInsCode | AN1..11 | 无 | O-选填 |
当账号类型为02-存折时需填写 在前台类交易时填写默认银行代码,支持直接跳转到网银 |
|
支付卡类型 | payCardType | N2 | 无 | C-按条件必填 |
消费交易,视商户配置返回。该域取值为: 00:未知 01:借记账户 02:贷记账户 03:准贷记账户 04:借贷合一账户 05:预付费账户 06:半开放预付费账户 |
|
订单描述 | orderDesc | ANS1..32 | 无 | C-按条件必填 |
描述订单信息,显示在银联支付控件或客户端支付界面中 |
|
分账域 | accSplitData | ANS1..512 | 无 | O-选填 | 查看详情 | |
控制规则 | ctrlRule | N32 | 无 | O-选填 |
32位01字符串控制位, 从左至右第一位取值为1表示财税库银信息控制位; 第二位取值为1时表示小微商户; 第三位取值为1时表示河北电力代缴建立委托签约; 第四位取值为1时表示需要强制分期处理; 第五位取值为1时表示不返signPubKeyCert字段 |
|
分期付款信息域 | instalTransInfo | ANS1..128 | 无 | C-按条件必填 | 查看详情 | |
收款方附加数据 | acqAddnData | ANS 1..8000 | O-选填 | 查看详情 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | R-需要返回 | 固定填写5.1.0 |
|
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | 填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写,默认取值:UTF-8 |
|
签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 |
|
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 |
|
交易类型 | txnType | N2 | 无 | R-需要返回 | 取值: 00:查询交易 01:消费 02:预授权 03:预授权完成 04:退货 05:圈存 11:代收 12:贷记 13:账单支付 14:转账(保留) 21:批量交易 22:批量查询 31:消费撤销 32:预授权撤销 33:预授权完成撤销 72:实名认证-建立绑定关系 73:账单查询 74:解除绑定关系 75:查询绑定关系 76:文件传输 77:发送短信验证码交易 78:开通查询交易 79:开通交易 94:IC卡脚本通知 95:查询更新加密公钥证书 |
|
交易子类 | txnSubType | N2 | 无 | R-需要返回 | 依据实际交易类型填写 00001注 默认取值:00 |
|
产品类型 | bizType | N6 | 无 | R-需要返回 | 依据实际业务场景填写(目前仅使用后4位,前面2位默认为00) 默认取值:000000 具体取值范围: 000201:B2C网关支付 000301:认证支付2.0 000302:评级支付 000401:贷记 000501:代收 000601:账单支付 000801:跨行收单 000901:绑定支付 001001:订购 00001注 000202:B2B |
|
接入类型 | accessType | N1 | 无 | R-需要返回 | 0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 | 已被批准加入银联互联网系统的收单机构代码 |
|
商户代码 | merId | AN15 | 无 | R-需要返回 | 已被批准加入银联互联网系统的商户代码 |
|
商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | 商户发送交易时间 |
|
请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
应答码 | respCode | AN2 | 无 | M-必填 | 具体参见应答码定义章节 |
|
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | 填写具体的应答信息 |
|
银联受理订单号 | tn | N21 | 无 | C-按条件必填 | 商户推送订单后银联移动支付系统返回该流水号,商户调用支付控件时使用 |
|
签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | R-需要返回 | 固定填写5.1.0 |
|
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | 填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写,默认取值:UTF-8 |
|
签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 |
|
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 |
|
交易类型 | txnType | N2 | 无 | R-需要返回 | 取值: 00:查询交易 01:消费 02:预授权 03:预授权完成 04:退货 05:圈存 11:代收 12:贷记 13:账单支付 14:转账(保留) 21:批量交易 22:批量查询 31:消费撤销 32:预授权撤销 33:预授权完成撤销 72:实名认证-建立绑定关系 73:账单查询 74:解除绑定关系 75:查询绑定关系 76:文件传输 77:发送短信验证码交易 78:开通查询交易 79:开通交易 94:IC卡脚本通知 95:查询更新加密公钥证书 |
|
交易子类 | txnSubType | N2 | 无 | R-需要返回 | 依据实际交易类型填写 00001注 默认取值:00 |
|
产品类型 | bizType | N6 | 无 | R-需要返回 | 依据实际业务场景填写(目前仅使用后4位,前面2位默认为00) 默认取值:000000 具体取值范围: 000201:B2C网关支付 000301:认证支付2.0 000302:评级支付 000401:贷记 000501:代收 000601:账单支付 000801:跨行收单 000901:绑定支付 001001:订购 00001注 000202:B2B |
|
接入类型 | accessType | N1 | 无 | R-需要返回 | 0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 | 已被批准加入银联互联网系统的收单机构代码 |
|
商户代码 | merId | AN15 | 无 | R-需要返回 | 已被批准加入银联互联网系统的商户代码 |
|
商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | 商户发送交易时间 |
|
交易金额 | txnAmt | N1..12 | 无 | R-需要返回 | 单位为分 |
|
交易币种 | currencyCode | AN3 | 无 | M-必填 | 币种格式必须为3位代码,默认取值:156(人民币) |
|
请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
交易查询流水号 | queryId | AN20..21 | 无 | M-必填 | 由银联返回,用于在后续类交易中唯一标识一笔交易 |
|
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | 填写具体的应答信息 |
|
应答码 | respCode | AN2 | 无 | M-必填 | 具体参见应答码定义章节 |
|
清算金额 | settleAmt | N1..12 | 无 | M-必填 | ||
清算币种 | settleCurrencyCode | AN3 | 无 | M-必填 | ||
清算日期 | settleDate | MMDD | 无 | M-必填 | ||
系统跟踪号 | traceNo | N6 | 无 | M-必填 | ||
交易传输时间 | traceTime | MMDDhhmmss | 无 | M-必填 | ||
兑换日期 | exchangeDate | MMDD | 无 | C-按条件必填 | 交易成功,交易币种和清算币种不一致的时候返回 |
|
清算汇率 | exchangeRate | N8 | 无 | C-按条件必填 | 交易成功,交易币种和清算币种不一致的时候返回 格式为右对齐,无小数点 小数位数由最左边一位数字表示,第二位至第八位指的是汇率的值 |
|
账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 交易账号。请求时使用加密公钥对交易账号加密,并做Base64编码后上送;应答时如需返回,则使用签名私钥进行解密。 前台交易可由银联页面采集,也可由商户上送并返显。如需锁定返显卡号,应通过保留域(reserved)上送卡号锁定标识。 |
|
支付卡标识 | payCardNo | ANS1..19 | 无 | C-按条件必填 | 移动支付交易时,根据商户配置返回 |
|
支付卡名称 | payCardIssueName | ANS1..64 | 无 | C-按条件必填 | 移动支付交易时,根据商户配置返回 |
|
绑定标识号 | bindId | ANS1..128 | 无 | R-需要返回 | 不支持换行符等不可见字符 用于唯一标识绑定关系 |
|
签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
|
分期付款信息域 | instalTransInfo | ANS1..128 | 无 | C-按条件必填 | 查看详情 | |
订单优惠信息 | issAddnData | ANS1..8000 | O-选填 | 查看详情 | ||
真实卡号摘要 | cardDigest | AN64 | C-按条件必填 | 真实卡号的摘要,为商户提供防黄牛条件 |
||
支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | 消费交易,视商户配置返回。该域取值为: 00:未知 01:借记账户 02:贷记账户 03:准贷记账户 04:借贷合一账户 05:预付费账户 06:半开放预付费账户 |
|
支付方式 | payType | N4 | 无 | C-按条件必填 | 默认不返回此域,如需要返此域,需要提交申请,视商户配置返回,可在消费类交易中返回以下中的一种: 0001:认证支付 0002:快捷支付 0004:储值卡支付 0005:IC卡支付 0201:网银支付 1001:牡丹畅通卡支付 1002:中铁银通卡支付 0401:信用卡支付——暂定 0402:小额临时支付 0403:认证支付2.0 0404:互联网订单手机支付 9000:其他无卡支付(如手机客户端支付) |