1、银联 二维码 技术 对接指引 1 环境与参数 在实施商户侧上线银联云闪付二维码支付业务时，服务商 /商户要保证每个商户编号下每个门店至少有一个唯一的终端号（ 8 位），终端编号应采用“门店编号 +设备编号（如收银机）”组成，每笔交易要上送正确的商户编号 +终端编号，终端编号与门店编号的映射关系要提供给银联。 1.1 接口 规范及开发包 银联 二维码商户接入 最新 的 接口 规范和开发包均会 第一时间 发布 在银联开放 平台上 ，商户可以自行下载，下载地址 如下 ： https:/ 目前 开发包中包含 JAVA、 .NET、 PHP 三种 版本 SDK 和 DEMO，使用其他开发语言需要自行 开
2、发 。 开发 包中的 DEMO在 WEB 容器中可以直接运行 （需要 修改配置文件 acp_sdk.properties中 的各种证书路径 ）。 对账 文件格式规范 也可在银联开发平台下载 ， 下载地址如下： https:/ 1.2 接口地址 测试环境 被扫 消费、主扫申码、交易撤销、退款 https:/ 交易 状态查询（ 消费 、撤销、 退款 ） https:/ 对账 文件下载 https:/ 生产环境 被扫 消费、主扫申码、交易撤销、退款 https:/ 交易 状态查询（ 消费 、撤销、 退款 ） https:/ 对账 文件下载 https:/ 1.3 参数 1.3.1 商户号 测试 环境
3、 ： 在 银联 开发平台（ https:/ 上 使用手机号 注册用户 即会生成一个 777 开头 的商户号 。 生产 环境 ： 商户 与收单机构签订收单协议， 由 收单机构提交申请材料到银联，由银联分配商户号 。 1.3.2 商户证书 及 证书密码 交易 过程 中 ，需要对请求报文进行签名处理， 防止 报文 被 伪造或者在传输过程中被篡改。 商户 证书即用于给请求报文签名 。 测试 环境 ： 使用 注册 好 的账 号 登录 银联 开发平台， 并 下载商户证书，商户证书密码为： 000000，具体如下图所示： 生产 环境 ： 登录 商户服务 平台 提交服务单申请下发证书，或者联系银联在当地的分公
4、司，由分公司来帮忙申请。 银联 下发证书后需要 商户 上 CFCA 官网下载，具体 下载 流程 见 银联发送的邮件 （证书 密码 由商户 在 从 IE 浏览器中导出的时候 自行 设置 ）。 注意 ： 一定 要 将 银联下发的商户证书 的 公钥证书上传到商户服务平台，并点击启用 。 1.2.3 验签证书 银联 在 响应 商户的请求时，也会对响应报文进行签名，商户需要验证响应报文中的签名，以确保 响应 报文确实来自银联，且未被篡改。在 5.1.0 版本 中，响应报文中 会 包含 用于验证 响应报文 签名 的 验签 证书，这就需要 商户 不但 要验证报文的 签名 ， 还 要 验证响应报文中的验签证书
5、 是否 合法。 测试 环境和生产环境的验签证书都已经打包进开发包了 ，如 上图 所示 ， acp_test_middle.cer和 acp_test_root.cer 为 测试 环境的证书 ， acp_prod_middle.cer和 acp_prod_root.cer 为生产 环境的证书 。 1.3.4 敏感信息 加密 证书 商户接入 二维码不涉及用户敏感信息，所以 暂 不需要 使用敏感 加密证书。 1.3.5 银行卡 测试 环境 ： 详见 https:/ 生产 环境 ： 使用真实有效 的银行卡 即可 。 1.4 错误码 错误码 列表及说明详见： https:/ 7 位 详细错误码列表及说明
6、： https:/ 2 测试 数据 生产 环境 ：验证 被扫时， 扫描 银联钱包 上的 二维码 完成 验证 ；验证 主扫时， 使用银联 钱包扫商户生产的二维码来完成支付验证。 测试 环境 ： 详 见 2.1及 2.2。 2.1 获取 C2B码 （被扫） 在 测试环境下，测试被扫时，不能 使用 银联钱包 生成 的 C2B 码，需要使用银联 开放 平台上的二维码仿真 来 生成 ， 银联 开放 平台二维码仿真 地址 如下： https:/ 如图 上图所示， 得到 的 qrNo 即为被扫 时 使用的 C2B 码，对于使用扫描枪的测试，还需将 C2B码转为条形码或者二维码。 2.2 收 款码 收款（主扫） 当 商户 生成 收款二维码时，需要付款方使用银联钱包 扫码 来完成付款，但是测试环境中 不 能使用银联钱包， 需要 使用银联 开放 平台 上 的二维码仿真完成付款动作。 主扫 付款仿真 地址 ： https:/ 具体 操作流程如下： 当 商户申请二维码付款 码 时，银联后台会生成一个待支付的订单， 付款方 在扫描二维码准备支付 时 ，需要先从银联查询二维码对应的订单信息， 若 确认付款则进行以下实际支付操作： 如果商户 的 测试 环境 位于 公网 之上 ， 且 在最后点击 “发送 ”前 正确填写了交易通知地址，则商户会收到 银联 发过来的交易通知 。
