接口描述
发起一笔消费交易同时完成无感支付签约
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/appTransReq.do
测试调用地址
https://gateway.test.95516.com/gateway/api/appTransReq.do
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5 | 5.1.0 | M-必填 | 固定填写5.1.0
|
|
| 编码方式 | encoding | string | 20 | UTF-8 | M-必填 | 默认取值：UTF-8
|
|
| 证书ID | certId | string | 128 | C-按条件必填 | 填写签名私钥证书的Serial Number，该值可通过银联提供的SDK获取
|
||
| 签名 | signature | string | 1024 | M-必填 | 填写对报文摘要的签名
|
||
| 签名及散列算法 | signMethod | string | 2 | M-必填 | 非对称签名：01：签名采用RSA算法，使用SHA-256散列算法配合；敏感信息加解密采用RSA算法；21：签名采用SM2算法，使用SM3散列算法配合；敏感信息加解密采用SM2算法。散列验证算法：11：支持散列方式验证SHA-256；12：支持散列方式验证SM3
|
||
| 交易类型 | txnType | string | 2 | 01 | M-必填 | 取值：01
|
|
| 交易子类 | txnSubType | string | 2 | 27 | M-必填 | 27：支付并签约
|
|
| 产品类型 | bizType | string | 6 | 000201 | M-必填 | 默认：000201
|
|
| 渠道类型 | channelType | string | 2 | 08 | M-必填 | 08
|
|
| 后台通知地址 | backUrl | string | 256 | M-必填 | 后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX|
|
||
| 接入类型 | accessType | string | 1 | M-必填 | 0：普通商户直连接入;1：收单机构接入;2：平台类商户接入
|
||
| 收单机构代码 | acqInsCode | string | 11 | C-按条件必填 | 接入类型为收单机构接入时需上送
|
||
| 商户类别 | merCatCode | string | 4 | C-按条件必填 | 接入类型为收单机构接入时需上送
|
||
| 商户代码 | merId | string | 15 | M-必填 |
|
||
| 商户名称 | merName | string | 40 | C-按条件必填 | 接入类型为收单机构接入时需上送
|
||
| 商户英文名称 | merEnName | string | 40 | C-按条件必填 | 接入类型为收单机构接入时需上送
|
||
| 商户简称 | merAbbr | string | 8 | C-按条件必填 | 接入类型为收单机构接入时需上送
|
||
| 二级商户代码 | subMerId | string | 15 | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
||
| 二级商户全称 | subMerName | string | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
|||
| 二级商户简称 | subMerAbbr | string | 16 | C-按条件必填 | 商户类型为平台类商户接入时必须上送
|
||
| 商户订单号 | orderId | string | 40 | M-必填 | 由商户端生成的业务订单号
|
||
| 订单发送时间 | txnTime | string | 14 | M-必填 | 商户发送交易时间
|
||
| 账号 | accNo | string | 1024 | C-按条件必填 | 1、后台类消费交易时上送全卡号或卡号后4位；2、跨行收单且收单机构收集银行卡信息时上送；3、前台类交易可通过配置后返回，卡号可选上送
|
||
| 交易金额 | txnAmt | string | 12 | M-必填 | 单位为分
|
||
| 交易币种 | currencyCode | string | 3 | 156 | C-按条件必填 | 默认为156
|
|
| 银行卡验证信息及身份信息 | customerInfo | string | 1024 | O-选填 | 详细用法参考接口文档
|
||
| 订单支付超时时间 | payTimeout | string | O-选填 | 订单支付超时时间
|
|||
| 请求方保留域 | reqReserved | string | O-选填 | 商户自定义保留域，交易应答时会原样返回
|
|||
| 保留域 | reserved | string | 2048 | O-选填 |
|
||
| 风险信息域 | riskRateInfo | string | O-选填 |
|
|||
| 加密证书ID | encryptCertId | string | 128 | C-按条件必填 | 当使用银联公钥加密密码、CVN2、有效期等敏感信息时，需上送加密证书CertID
|
||
| 默认支付方式 | defaultPayType | string | 4 | O-选填 | 取值参考数据元说明
|
||
| 发卡机构代码 | issInsCode | string | 11 | O-选填 |
|
||
| 支付卡类型 | payCardType | string | 2 | C-按条件必填 | 特殊商户交易控制用（如借贷分离）
|
||
| 订单描述 | orderDesc | string | 32 | C-按条件必填 | 移动支付上送
|
||
| 控制规则 | ctrlRule | string | 32 | O-选填 | 第五位取值为1时表示不返signPubKeyCert字段
|
||
| 订单详细信息（支持单品） | acqAddnData | string | O-选填 |
|
|||
| 签约模板ID | planId | string | M-必填 | 签约模板ID，与接入产品对应，入网时生成。
|
|||
| 签约场景 | contractScene | string | M-必填 | 取值如下：01-支付并强制开通免密支付，02-支付并可选开通免密支付.
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5 | 5.1.0 | R-需要返回 |
|
|
| 编码方式 | encoding | string | 20 | UTF-8 | R-需要返回 |
|
|
| 签名 | signature | string | 1024 | M-必填 |
|
||
| 签名及散列算法 | signMethod | string | 2 | M-必填 |
|
||
| 交易类型 | txnType | string | 2 | R-需要返回 |
|
||
| 交易子类 | txnSubType | string | 2 | R-需要返回 |
|
||
| 产品类型 | bizType | string | 6 | R-需要返回 |
|
||
| 接入类型 | accessType | string | 1 | R-需要返回 |
|
||
| 收单机构代码 | acqInsCode | string | 11 | C-按条件必填 | 接入类型为收单机构接入时需返回
|
||
| 商户代码 | merId | string | 15 | R-需要返回 |
|
||
| 商户订单号 | orderId | string | 40 | R-需要返回 |
|
||
| 订单发送时间 | txnTime | string | 14 | R-需要返回 |
|
||
| 请求方保留域 | reqReserved | string | R-需要返回 |
|
|||
| 保留域 | reserved | string | 2048 | O-选填 |
|
||
| 响应码 | respCode | string | M-必填 |
|
|||
| 应答信息 | respMsg | string | 256 | M-必填 |
|
||
| 银联受理订单号 | tn | string | 21 | C-按条件必填 | 商户推送订单后银联移动支付系统返回该流水号，商户调用云闪付时需传入
|
||
| 签名公钥证书 | signPubKeyCert | string | 2048 | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
|
异步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 5 | 5.1.0 | R-需要返回 | ||
| 编码方式 | encoding | string | 20 | UTF-8 | R-需要返回 | ||
| 签名 | signature | string | 1024 | M-必填 | |||
| 签名及散列算法 | signMethod | string | 2 | M-必填 | |||
| 交易类型 | txnType | string | 2 | R-需要返回 | |||
| 交易子类 | txnSubType | string | 2 | R-需要返回 | |||
| 产品类型 | bizType | string | 6 | R-需要返回 | |||
| 接入类型 | accessType | string | 1 | R-需要返回 | |||
| 收单机构代码 | acqInsCode | string | 11 | C-按条件必填 | 接入类型为收单机构接入时需返回 | ||
| 商户代码 | merId | string | 15 | R-需要返回 | |||
| 商户订单号 | orderId | string | 40 | R-需要返回 | |||
| 订单发送时间 | txnTime | string | 14 | R-需要返回 | |||
| 交易金额 | txnAmt | string | 12 | R-需要返回 | |||
| 交易币种 | currencyCode | string | 3 | 156 | M-必填 | 默认为156 | |
| 请求方保留域 | reqReserved | string | R-需要返回 | ||||
| 保留域 | reserved | string | 2048 | O-选填 | |||
| 交易查询流水号 | queryId | string | M-必填 | 消费交易的流水号，供后续查询用 | |||
| 响应码 | respCode | string | M-必填 | ||||
| 响应信息 | respMsg | string | M-必填 | ||||
| 清算金额 | settleAmt | string | 12 | M-必填 | |||
| 清算币种 | settleCurrencyCode | string | 3 | M-必填 | |||
| 清算日期 | settleDate | string | 4 | M-必填 | |||
| 系统跟踪号 | traceNo | string | 6 | M-必填 | |||
| 交易传输时间 | traceTime | string | 12 | M-必填 | |||
| 兑换日期 | exchangeDate | string | 4 | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | ||
| 汇率 | exchangeRate | string | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |||
| 账号 | accNo | string | 1024 | C-按条件必填 | 根据商户配置返回 | ||
| 支付卡类型 | payCardType | string | 2 | C-按条件必填 | 根据商户配置返回 | ||
| 支付方式 | payType | string | 4 | C-按条件必填 | 根据商户配置返回 | ||
| 支付卡标识 | payCardNo | string | 19 | C-按条件必填 | 移动支付交易时，根据商户配置返回 | ||
| 支付卡名称 | payCardIssueName | string | 64 | C-按条件必填 | 移动支付交易时，根据商户配置返回 | ||
| 签名公钥证书 | signPubKeyCert | string | 2048 | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 | ||
| 订单优惠信息（支持单品） | issAddnData | string | 8000 | O-选填 | |||
| 真实卡号摘要 | cardDigest | string | 64 | C-按条件必填 | 根据控制规则返回 | ||
| 标记化支付信息域 | tokenPayData | string | 1024 | C-按条件必填 | 签约成功时返回 | ||
| 清算场次 | settleNo | string | 2 | C-按条件必填 |
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
