控件或H5页面前台模式签约
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.contract.create |
||
发送方流水号 | 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 | M-必填 | 查看详情 | ||
Token信息域 | tokenInfo | Object | M-必填 | 查看详情 | ||
请求方保留域 | reqReserved | String(1..1024) | O-选填 |
商户自定义保留域,交易应答时会原样返回 |
||
前台通知地址 | frontUrl | String(1..256) | M-必填 | |||
前台失败通知地址 | frontFailUrl | String(1..256) | M-必填 | |||
后台通知地址 | backUrl | String(1..256) | M-必填 |
后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,不支持换行符等不可见字符,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX| |
||
加密信息域 | encryptData | Object | C-按条件必填 | 查看详情 | ||
商户端用户ID | merUserId | String(1..64) | M-必填 | |||
签约控制信息域 | contractControlInfo | Object | C-按条件必填 | 查看详情 | ||
不展示手输卡号入口标识 | noCardInputFlag | String[1] | C-按条件必填 |
取值1:表示不展示手输卡号入口 |
||
风险信息域 | riskRateInfo | Object | M-必填 | 查看详情 | ||
人脸信息域 | faceInfo | 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-需要返回 |
商户自定义保留域,交易应答时会原样返回 |
||
签约地址 | contractUrl | String(1..1024) | C-按条件必填 |
用于后续跳转 H5 页面完成签约 |
||
银联受理订单号 | tn | String[21] | C-按条件必填 |
用于后续拉起控件完成签约。由银联返回,用于在后续类交易中唯一标识一笔交易21位定长,仅支持数字 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | String(1..8) | M-必填 |
7.0.1 |
||
发送方系统索引号 | appId | String(1..32) | M-必填 |
当普通商户直连接入、平台类商户接入时,填商户号。 当收单机构接入时,填收单机构号。 |
||
发送方索引类型 | appType | String[2] | M-必填 |
本数据元的填写须根据报文发送方的实际角色进行填写。 当普通商户直连接入、平台类商户接入时,填02。 当收单机构接入时,填01。 |
||
接口类型 | bizMethod | String(1..64) | M-必填 |
取值详见技术规范 |
||
发送方流水号 | reqId | String(1..64) | M-必填 |
由发送方自行生成,保证每笔请求不重复。同步应答原样返回,异步应答生成新值。 |
||
签名 | sign | String(1..344) | M-必填 |
对报文摘要的签名 |
||
证书ID | signId | String(1..128) | C-按条件必填 |
签名证书序列号(十进制) |
||
签名或摘要方式 | signMethod | String(1..20) | M-必填 |
取值详见技术规范 |
||
银联签名公钥证书 | signPubKeyCert | String(1..2048) | C-按条件必填 |
仅应答报文才出现。当signMethod为“RSA2-CERT”或“SM2-CERT”时,该域必须存在,取值为公钥证书。该字段需做urlEncode。 |
||
业务参数 | body | JSON | M-必填 | 查看详情 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
应答码 | 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-需要返回 |
商户自定义保留域,交易应答时会原样返回 |