银联签约支付
查看产品
更新时间:2023-08-17
支付短信
接口描述
给银行卡预留手机号发送支付短信,支付短信与支付交易商户号、订单号、交易发送时间需保持一致。
请求方式
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.sms
|
|
发送方流水号 |
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
|
|
Token信息域 |
tokenInfo |
Object |
|
M-必填
|
查看详情
|
|
请求方保留域 |
reqReserved |
String(1..1024) |
|
O-选填
|
商户自定义保留域,交易应答时会原样返回
|
|
交易金额 |
txnAmt |
String(1..12) |
|
M-必填
|
仅支持数字。单位为币种对应的最小单位,参数值不能带小数仅支持数字
|
|
交易币种 |
currencyCode |
String[3] |
|
M-必填
|
3位数字。币种格式必须为3位代码,默认取值:156(人民币)
|
|
商户控制信息域 |
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-需要返回 |
商户自定义保留域,交易应答时会原样返回
|