统一支付接口
查看产品
更新时间:2022-08-09
银联加密公钥更新
接口描述
商户定期(1天1次)向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证书更新期间,全渠道系统支持新老证书的共同使用,新老证书并行期为1个月。全渠道系统向商户返回最新的加密公钥证书,由商户服务器替换本地证书。
请求方式
POST
生产调用地址
https://gateway.95516.com/api/trans.do
测试调用地址
https://gateway.test.95516.com/api/trans.do
公共请求参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
版本号 |
version |
String(5) |
6.0.0 |
M-必填
|
固定填写6.0.0
|
|
编码方式 |
encoding |
String(1,20) |
UTF-8 |
M-必填
|
填写报文使用的字符编码 UTF-8,默认取值:UTF-8
|
|
签名方法 |
signMethod |
String(1,32) |
|
M-必填
|
RSA-SHA256:表示采用RSA签名,摘要算法用SHA256
|
|
签名 |
signature |
String(1,1024) |
|
M-必填
|
填写对报文摘要的签名
|
|
商户证书序列号 |
merCertId |
String(1,128) |
|
M-必填
|
填写商户签名私钥证书的Serial Number(十进制),该值可通过银联提供的SDK获取 仅支持数字。
|
|
业务接口 |
bizMethod |
String(1,128) |
|
M-必填
|
acp.trade.pk.query
|
|
商户代码 |
merId |
String(15) |
|
M-必填
|
已被批准加入银联互联网系统的商户代码 固定15位长,仅支持数字和字母
|
|
随机字符串 |
nonceStr |
String(1,32) |
|
M-必填
|
|
|
商户订单号 |
orderId |
String(8,40) |
|
M-必填
|
商户订单号,不能含“-”或“_” 仅支持数字和字母
|
|
交易发送时间 |
txnTime |
String(14) |
|
M-必填
|
商户发送交易时间,格式: yyyyMMDDHHmmss
|
|
参数集合 |
bizContent |
String(1,10240) |
|
C-按条件必填
|
|
请求参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
证书类型 |
certType |
String(2) |
|
M-必填 |
01:敏感信息加密公钥 |
公共应答参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
签名 |
signature |
String(1,1024) |
|
M-必填 |
填写对报文摘要的签名 |
|
银联证书序列号 |
cupCertId |
String(1,128) |
|
M-必填 |
填写银联签名私钥证书的Serial Number(十进制),该值可通过银联提供的SDK获取。 仅支持数字。 |
|
商户代码 |
merId |
String(15) |
|
R-需要返回 |
已被批准加入银联互联网系统的商户代码 固定15位长,仅支持数字和字母 |
|
随机字符串 |
nonceStr |
String(1,32) |
|
R-需要返回 |
|
|
商户订单号 |
orderId |
String(8,40) |
|
R-需要返回 |
商户订单号,不能含“-”或“_” 仅支持数字和字母
|
|
交易发送时间 |
txnTime |
String(14) |
|
R-需要返回 |
商户发送交易时间,格式: yyyyMMDDHHmmss |
|
交易状态码 |
resultCode |
String(1,10) |
|
M-必填 |
SUCCESS:成功 FAILURE:失败 UNKNOWN:未知 PROCESSING:处理中
|
|
交易应答码 |
respCode |
String(1,128) |
|
C-按条件必填 |
返回信息为具体原因,如: 成功:SUCCESS 系统异常:SYSTEM_ERROR 验签失败:SIGNATURE_VERIFY_FAIL 无此交易权限:NOT_AUTH 余额不足:NOT_ENOUGH_MONEY 银行系统异常:BANK_ERROR 交易密码错:PIN_ERROR ……
|
|
交易应答信息 |
respMsg |
String(1,256) |
|
C-按条件必填 |
返回交易应答信息的详细描述 |
|
参数集合 |
bizContent |
String(1,10240) |
|
C-按条件必填 |
|
应答参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
请求方自定义域 |
reqReserved |
String(1,1024) |
|
R-需要返回 |
商户自定义保留域,交易应答时会原样返回 |
|
证书类型 |
certType |
String(2) |
|
R-需要返回 |
01:敏感信息加密公钥 |
|
加密公钥证书 |
encryptPubKeyCert |
String(1,2048 ) |
|
C-按条件必填 |
|
示例报文
signature=asdfasdfasdfasdfasdf&merId=123456789&nonceStr=789gfhh&orderId=12345678&resultCode=FAIL&respCode=NOT_FOUND&respMsg=证书未找到