代收
查看产品
更新时间:2022-08-09
签约

接口描述
签约主要适用于代收业务中的代收业务委托建立,自助消费、自助转账业务中实名终端的账户定制;签约交易包含有卡方式签约和无卡方式签约,其中有卡签约一般由线下专用POS机具发起的有磁有密交易,需卡片出现和交易密码验证,验证强度高;无卡签约包含了前台签约和后台签约两种模式,双因素验证一般适用于前台签约模式,静态信息验证一般适用于后台签约模式。

请求方式
POST

生产调用地址
https://gateway.95516.com/gateway/api/frontTransReq.do

测试调用地址
https://gateway.test.95516.com/gateway/api/frontTransReq.do

请求参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
版本号 |
version |
NS5 |
无 |
M-必填
|
|
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
M-必填
|
默认取值:UTF-8
|
|
产品类型 |
bizType |
N6 |
无 |
M-必填
|
|
|
代收款项 |
billType |
ANS2 |
无 |
M-必填
|
代收款项 | 说明 | 01 | 移动电话 | 02 | 固定电话 | 03 | 水费 | 04 | 电费 | 05 | 煤气费 | 06 | 社保 | 07 | 小灵通 | 08 | 信用卡还款 | 09 | 烟草 | 10 | 信用卡中心 | 11 | 有线和付费电视 | 12 | 保险 | 13 | 税务 | 14 | 证券公司 | 15 | 金融机构 | 16 | 贷款还款 | 17 | 网络服务费 | 18 | 资金归集 | 19 | 教育费 | 20 | 物业管理费 | 21 | 公益捐款 | CS | 财税库银 | RZ | 商户实时入账 | OT | 其他 |
|
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
M-必填
|
|
|
交易类型 |
txnType |
N2 |
无 |
M-必填
|
取值:72
|
|
交易子类 |
txnSubType |
N2 |
无 |
M-必填
|
16:签约
|
|
接入类型 |
accessType |
N1 |
无 |
M-必填
|
0:商户直连接入 1:收单机构接入 2:平台商户接入
|
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填
|
填写对报文摘要的签名
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填
|
非对称签名:
01(表示采用 RSA 签名)
HASH 表示散列算法
11:支持散列方式验证 SHA-256
12:支持散列方式验证 SM3
|
|
渠道类型 |
channelType |
N2 |
无 |
M-必填
|
|
|
商户代码 |
merId |
AN15 |
无 |
M-必填
|
|
|
商户订单号 |
orderId |
AN8..40 |
无 |
M-必填
|
商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
|
|
银行卡验证信息及身份信息 |
customerInfo |
ANS1..1024 |
无 |
M-必填
|
查看详情
|
|
账单号码 |
billNo |
ANS1..64 |
无 |
M-必填
|
表示用户号码,仅支持数字和字母,最长40位
|
|
账号 |
accNo |
AN1..1024 |
无 |
M-必填
|
|
|
证书ID |
certId |
N1..128 |
无 |
M-必填
|
|
|
二级商户代码 |
subMerId |
AN5..15 |
无 |
C-按条件必填
|
商户类型为平台类商户接入时必
须上送
|
|
二级商户简称 |
subMerAbbr |
ANS1…16 |
无 |
C-按条件必填
|
商户类型为平台类商户接入时必
须上送
|
|
二级商户名称 |
subMerName |
ANS1..40 |
无 |
C-按条件必填
|
商户类型为平台类商户接入时必
须上送
|
|
后台通知地址 |
backUrl |
ANS1..256 |
无 |
C-按条件必填
|
后台返回商户结果时使用,如上送,则发送商户后台交易结果通知,不支持换行符等不可见字符,如需通过专线通知,需要在通知地址前面加上前缀:专线的首字母加竖线ZX| 如果不需要发后台通知,可以固定上送http://www.specialUrl.com
|
|
加密证书ID |
encryptCertId |
N1..128 |
无 |
C-按条件必填
|
|
|
商户简称 |
merAbbr |
ANS1..8 |
无 |
C-按条件必填
|
接入类型为收单机构接入时需上
送
|
|
商户类别 |
merCatCode |
N4 |
无 |
C-按条件必填
|
填写 MCC 码,接入类型为收单
机构接入时需上送
|
|
商户名称 |
merName |
ANS1..40 |
无 |
C-按条件必填
|
接入类型为收单机构接入时需上
送
|
|
商户英文名称 |
merEnName |
ANS40 |
|
C-按条件必填
|
查看详情
|
|
收单机构代码 |
acqInsCode |
AN8..11 |
无 |
C-按条件必填
|
接入类型为收单机构接入时需上
送
|
|
有卡交易信息域 |
cardTransData |
ANS1Trans |
无 |
C-按条件必填
|
查看详情
|
|
终端号 |
termId |
ANS8 |
无 |
C-按条件必填
|
channelType = 03 时, termId 必
填
|
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填
|
查看详情
|
|
持卡人IP |
customerIp |
NS7..40 |
无 |
O-选填
|
有 IP 防钓鱼要求的商户上送
|
|
风控信息域 |
riskRateInfo |
ANS 1..2048 |
无 |
O-选填
|
查看详情
|
|
控制规则 |
ctrlRule |
N32 |
无 |
O-选填
|
32位01字符串控制位, 第五位取值为1时表示不返signPubKeyCert字段
|
|
前台通知地址 |
frontUrl |
ANS1..256 |
无 |
O-选填
|
前台交易需填写
|
|
请求方保留域 |
reqReserved |
ANS1..1024 |
无 |
O-选填
|
商户自定义保留域,交易应答时
会原样返回
|

应答报文(同步应答)
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填 |
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填 |
|
|
应答码 |
respCode |
AN2 |
无 |
M-必填 |
|
|
应答信息 |
respMsg |
ANS1..256 |
无 |
M-必填 |
|
|
签名公钥证书 |
signPubKeyCert |
AN1..2048 |
无 |
C-按条件必填 |
此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
|
收单机构代码 |
acqInsCode |
AN8..11 |
无 |
C-按条件必填 |
接入类型为收单机构接入时需
返回
|
|
账号 |
accNo |
AN1..1024 |
无 |
C-按条件必填 |
根据商户配置返回 |
|
支付卡类型 |
payCardType |
N2 |
无 |
C-按条件必填 |
根据商户配置返回 |
|
版本号 |
version |
NS5 |
无 |
R-需要返回 |
|
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
R-需要返回 |
|
|
产品类型 |
bizType |
N6 |
无 |
R-需要返回 |
|
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
R-需要返回 |
|
|
交易类型 |
txnType |
N2 |
无 |
R-需要返回 |
取值:72 |
|
交易子类 |
txnSubType |
N2 |
无 |
R-需要返回 |
|
|
接入类型 |
accessType |
N1 |
无 |
R-需要返回 |
0:商户直连接入 1:收单机构接入 2:平台商户接入
|
|
请求方保留域 |
reqReserved |
ANS1..1024 |
无 |
R-需要返回 |
|
|
商户代码 |
merId |
AN15 |
无 |
R-需要返回 |
|
|
商户订单号 |
orderId |
AN8..40 |
无 |
R-需要返回 |
商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
|
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填 |
查看详情 |
|
发卡机构代码 |
issInsCode |
AN1..11 |
无 |
O-选填 |
|

异常应答说明
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”; 交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常