接口描述
签约支付交易
请求方式
POST
生产调用地址
https://gateway.95516.com/api/v7/trans.do
测试调用地址
https://gateway.test.95516.com/api/v7/trans.do
公共参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | String(1..8) | M-必填 |
7.0.1 |
||
| 发送方系统索引号 | appId | String(1..32) | M-必填 |
当普通商户直连接入、平台类商户接入时，填商户号。 当收单机构接入时，填收单机构号。 |
||
| 发送方索引类型 | appType | String[2] | M-必填 |
本数据元的填写须根据报文发送方的实际角色进行填写。 当普通商户直连接入、平台类商户接入时，填02。 当收单机构接入时，填01。 |
||
| 接口类型 | bizMethod | String(1..64) | M-必填 |
bizMethod 取值为：acp.trade.contract.pay |
||
| 发送方流水号 | reqId | String(1..64) | M-必填 |
由发送方自行生成，保证每笔请求不重复。同步应答原样返回，异步应答生成新值。 |
||
| 签名 | sign | String(1..344) | M-必填 |
对报文摘要的签名 |
||
| 证书ID | signId | String(1..128) | M-必填 |
签名证书序列号（十进制） |
||
| 签名或摘要方式 | signMethod | String(1..20) | M-必填 |
取值详见技术规范 |
请求业务参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 接入类型 | accessType | String[1] | M-必填 |
0：普通商户直连接入1：收单机构接入2：平台类商户接入 |
||
| 收单机构代码 | acqInsCode | String(8..11) | C-按条件必填 |
已被批准加入银联互联网系统的收单机构代码 接入类型为收单机构接入时需上送 |
||
| 商户信息域 | merInfo | Object | C-按条件必填 | 查看详情 | ||
| 二级商户信息域 | subMerInfo | Object | C-按条件必填 | 查看详情 | ||
| 商户代码 | merId | String[15] | M-必填 |
已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母 |
||
| 商户订单号 | orderId | String(8..40) | M-必填 |
商户订单号，不能含“-”或“_”仅支持数字和字母 |
||
| 交易发送时间 | txnTime | String[14] | M-必填 |
商户发送交易时间，格式： yyyyMMddHHmmss |
||
| 账户验证信息域 | accountVerifyInfo | Object | C-按条件必填 | 查看详情 | ||
| Token信息域 | tokenInfo | Object | M-必填 | 查看详情 | ||
| 请求方保留域 | reqReserved | String(1..1024) | O-选填 |
商户自定义保留域，交易应答时会原样返回 |
||
| 交易金额 | txnAmt | String(1..12) | M-必填 |
仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字 |
||
| 交易币种 | currencyCode | String[3] | M-必填 |
3位数字。币种格式必须为3位代码，默认取值：156（人民币） |
||
| 风险信息域 | riskRateInfo | Object | M-必填 | 查看详情 | ||
| 营销信息域 | discountInfo | Object | O-选填 | 查看详情 | ||
| 后台通知地址 | backUrl | String(1..256) | C-按条件必填 |
后台返回商户结果时使用，如上送，则发送商户后台交易结果通知，不支持换行符等不可见字符，如需通过专线通知，需要在通知地址前面加上前缀：专线的首字母加竖线ZX| |
||
| 掩码卡号 | maskedCardNo | String(16..19) | C-按条件必填 |
前6后4明文，其余*替换。 |
||
| 分期付款信息域 | instalTransInfo | Object | C-按条件必填 | 查看详情 | ||
| 基金信息域 | fundInfo | Object | C-按条件必填 | 查看详情 | ||
| 加密信息域 | encryptData | Object | C-按条件必填 | 查看详情 | ||
| 商户控制信息域 | merCtrlInfo | Object | O-选填 | 查看详情 |
同步应答业务参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 应答码 | code | String[10] | M-必填 |
对调用结果进行统一归类，指导开发者判断并进行后续业务操作。数据字典见附录A《应答码》。 |
||
| 应答码描述 | msg | String(1..128) | M-必填 |
同一个应答码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 详细应答码 | subCode | String[10] | M-必填 |
描述了详细的业务处理失败的原因，详见每个交易接口说明，仅用于问题排查和分析，无须开发者判断。 |
||
| 详细应答码描述 | subMsg | String(1..128) | M-必填 |
同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 接入类型 | accessType | String[1] | R-需要返回 |
0：普通商户直连接入1：收单机构接入2：平台类商户接入 |
||
| 收单机构代码 | acqInsCode | String(8..11) | R-需要返回 |
已被批准加入银联互联网系统的收单机构代码 |
||
| 商户代码 | merId | String[15] | R-需要返回 |
已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母 |
||
| 商户订单号 | orderId | String(8..40) | R-需要返回 |
商户订单号，不能含“-”或“_”仅支持数字和字母 |
||
| 交易发送时间 | txnTime | String[14] | R-需要返回 |
商户发送交易时间，格式： yyyyMMddHHmmss |
||
| 请求方保留域 | reqReserved | String(1..1024) | R-需要返回 |
商户自定义保留域，交易应答时会原样返回 |
||
| 交易金额 | txnAmt | String(1..12) | R-需要返回 |
仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字 |
||
| 交易币种 | currencyCode | String[3] | R-需要返回 |
3位数字。币种格式必须为3位代码，默认取值：156（人民币） |
||
| 银联受理订单号 | tn | String[21] | C-按条件必填 |
由银联返回，用于在后续类交易中唯一标识一笔交易21位定长，仅支持数字 |
||
| 清算信息域 | settleInfo | Object | C-按条件必填 | 查看详情 | ||
| 营销信息域 | discountInfo | Object | C-按条件必填 | 查看详情 | ||
| 卡类型 | cardType | String[2] | C-按条件必填 |
卡性质01：借记卡02：贷记卡 |
||
| 发卡行简称 | issInsAbbr | String(1..11) | C-按条件必填 | |||
| 分期付款信息域 | instalTransInfo | Object | C-按条件必填 | 查看详情 | ||
| 发卡总行机构中文名称 | issHeadName | String(1..40) | C-按条件必填 | |||
| 账户验证信息域 | accountVerifyInfo | Object | C-按条件必填 | 查看详情 | ||
| 加密信息域 | encryptData | Object | C-按条件必填 | 查看详情 |
异步应答业务参数
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 应答码 | code | String[10] | M-必填 |
对调用结果进行统一归类，指导开发者判断并进行后续业务操作。数据字典见附录A《应答码》。 |
||
| 应答码描述 | msg | String(1..128) | M-必填 |
同一个应答码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 详细应答码 | subCode | String[10] | M-必填 |
描述了详细的业务处理失败的原因，详见每个交易接口说明，仅用于问题排查和分析，无须开发者判断。 |
||
| 详细应答码描述 | subMsg | String(1..128) | M-必填 |
同一个详细错误码可对应多个不同的描述，对处理结果进行详细提示。 |
||
| 接入类型 | accessType | String[1] | R-需要返回 |
0：普通商户直连接入1：收单机构接入2：平台类商户接入 |
||
| 收单机构代码 | acqInsCode | String(8..11) | R-需要返回 |
已被批准加入银联互联网系统的收单机构代码 |
||
| 商户代码 | merId | String[15] | R-需要返回 |
已被批准加入银联互联网系统的商户代码固定15位长，仅支持数字和字母 |
||
| 商户订单号 | orderId | String(8..40) | R-需要返回 |
商户订单号，不能含“-”或“_”仅支持数字和字母 |
||
| 交易发送时间 | txnTime | String[14] | R-需要返回 |
商户发送交易时间，格式： yyyyMMddHHmmss |
||
| 请求方保留域 | reqReserved | String(1..1024) | R-需要返回 |
商户自定义保留域，交易应答时会原样返回 |
||
| 交易金额 | txnAmt | String(1..12) | R-需要返回 |
仅支持数字。单位为币种对应的最小单位，参数值不能带小数仅支持数字 |
||
| 交易币种 | currencyCode | String[3] | R-需要返回 |
3位数字。币种格式必须为3位代码，默认取值：156（人民币） |
||
| 银联受理订单号 | tn | String[21] | C-按条件必填 |
由银联返回，用于在后续类交易中唯一标识一笔交易21位定长，仅支持数字 |
||
| 清算信息域 | settleInfo | Object | C-按条件必填 | 查看详情 | ||
| 营销信息域 | discountInfo | Object | C-按条件必填 | 查看详情 | ||
| 卡类型 | cardType | String[2] | C-按条件必填 |
卡性质01：借记卡02：贷记卡 |
||
| 发卡行简称 | issInsAbbr | String(1..11) | C-按条件必填 | |||
| 分期付款信息域 | instalTransInfo | Object | C-按条件必填 | 查看详情 | ||
| 发卡总行机构中文名称 | issHeadName | String(1..40) | C-按条件必填 | |||
| 账户验证信息域 | accountVerifyInfo | Object | C-按条件必填 | 查看详情 | ||
| 加密信息域 | encryptData | Object | C-按条件必填 | 查看详情 |
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
