中国银联开放平台

支持中心

接口列表

统一支付接口

统一支付接口

统一支付接口

交易状态查询

银联加密公钥更新

预授权撤销

预授权完成

预授权完成撤销

POS参数传递

参数下载结束

统一支付接口

更新时间：2022-08-09

批结算

接口描述

接口介绍参照《销售点终端（POS）应用规范》。

请求方式

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.term.recon
	商户代码	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-按条件必填

请求参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	终端号	termId	String(8)		M-必填
	终端请求报文	termReqMsg	String(1,4096)		M-必填	终端签到请求8583报文本字段须做BASE64

公共应答参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	签名	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-按条件必填

应答参数

	中文名称	英文名称	域类型	默认值	请求要求	备注
	终端号	termId	String(8)		R-需要返回
	终端应答报文	termRespMsg	String(1,4096)		M-必填	终端签到应答8583报文本字段须做BASE64

示例报文

咨询服务