admin管理员组

文章数量:1530517

2024年6月14日发(作者:)

银联二维码技术对接指引

1. 环境与参数

在实施商户侧上线银联云闪付二维码支付业务时,服务商/商户要保证每个商户编号下

每个门店至少有一个唯一的终端号(8位),终端编号应采用“门店编号+设备编号(如收银

机)”组成,每笔交易要上送正确的商户编号+终端编号,终端编号与门店编号的映射关系要

提供给银联。

1.1 接口规范及开发包

银联二维码商户接入最新的接口规范和开发包均会第一时间发布在银联开放平台上,商户可

以自行下载,下载地址如下:

/ajweb/help/file/techFile?productId=89

目前开发包中包含JAVA、.NET、PHP三种版本SDK和DEMO,使用其他开发语言需要自行开

发。开发包中的DEMO在WEB容器中可以直接运行(需要修改配置文件acp_ties

中的各种证书路径)。

对账文件格式规范也可在银联开发平台下载,下载地址如下:

/ajweb/help/file/toDetailPage?id=585&flag=1

1.2.接口地址

被扫消费、主

扫申码、交易

撤销、退款

测试交易状态查

环境 询(消费、撤

销、退款)

对账文件下

被扫消费、主

扫申码、交易

撤销、退款

生产交易状态查

环境 询(消费、撤

销、退款)

对账文件下

/gateway/api/

/gateway/api/

/

/gateway/api/

/gateway/api/

/

1.3.参数

1.3.1 商户号

测试环境:在银联开发平台(/ajweb/index)上使用手机号注

册用户即会生成一个777开头的商户号。

生产环境:商户与收单机构签订收单协议,由收单机构提交申请材料到银联,由银联分配商

户号。

1.3.2 商户证书及证书密码

交易过程中,需要对请求报文进行签名处理,防止报文被伪造或者在传输过程中被篡改。商

户证书即用于给请求报文签名。

测试环境:使用注册好的账号登录银联开发平台,并下载商户证书,商户证书密码为:000000,

具体如下图所示:

生产环境:登录商户服务平台提交服务单申请下发证书,或者联系银联在当地的分公司,由

分公司来帮忙申请。银联下发证书后需要商户上CFCA官网下载,具体下载流程见银联发送

的邮件(证书密码由商户在从IE浏览器中导出的时候自行设置)。

注意:一定要将银联下发的商户证书的公钥证书上传到商户服务平台,并点击启用。

1.2.3 验签证书

银联在响应商户的请求时,也会对响应报文进行签名,商户需要验证响应报文中的签名,以

确保响应报文确实来自银联,且未被篡改。在5.1.0版本中,响应报文中会包含用于验证响

应报文签名的验签证书,这就需要商户不但要验证报文的签名,还要验证响应报文中的验签

证书是否合法。

本文标签: 商户银联证书报文编号