Skip to content

银联支付

更新时间:2026/8/2 22:56:23

通道概述

银联(即云闪付)是中国银联旗下的全渠道支付服务,通过银联全渠道支付平台(95516.com)网关直连 ACP 对接。DaxPay 支持银联网关直连模式,覆盖扫码、H5、付款码等主流收单场景。

银联(云闪付,通道 union_pay)与银联商务(UMS,通道 ums_pay)是两条相互独立的通道,签名方式、报文格式、网关与产品均不同,详见文末与银联商务的区别

支持的支付方式

  • 银联扫码(主扫):返回二维码链接,用户用云闪付 App 扫码支付(union_qr
  • 银联 H5:在手机浏览器中通过前台表单跳转完成支付(union_h5
  • 银联付款码(被扫):商户扫描用户云闪付付款码(union_barcode

JSAPI 未实现

union_jsapi(银联 JSAPI)在银联网关直连通道仅枚举定义、暂未实现;公众号/小程序内的银联支付可经聚合通道(如 Adapay、拉卡拉等)承担。

配置说明

在运营端「通道管理」中添加银联通道,配置以下参数:

  • 商户号
  • PKCS12 私钥证书(.pfx)及证书密码
  • 中级证书
  • 根证书

银联网关采用 RSA2 证书签名signMethod=01,SHA256withRSA),报文为 application/x-www-form-urlencoded 格式(非 JSON),三证书缺一不可。

回调处理

  • 支持同步返回与异步通知
  • 异步通知为 form-urlencoded 参数,需用银联公钥证书验签
  • 验签通过后取 queryId 作为通道订单号;退款回调以 origQryId 关联原交易
  • 需在银联商户平台配置回调地址,且回调地址须可外网访问

注意事项

  • 网关地址:沙箱 test.95516.com / 生产 95516.com
  • 私钥证书需妥善保管并定期更新,证书过期会导致签名失败
  • 付款码被扫按 authCode 前缀(银联 62)识别后映射为 union_barcode 再路由
  • 部分功能需单独向银联申请开通

与银联商务的区别

银联(云闪付)与银联商务(UMS)常被混淆,但两者是完全不同的通道

维度银联(云闪付)银联商务(UMS)
通道编码union_payums_pay
对接主体中国银联全渠道支付平台(95516.com)银联商务有限公司开放平台
签名方式RSA2 证书签名(PKCS12 私钥 + 中级/根证书)HmacSHA256 无证书(appKey + secretKey)
报文格式form-urlencodedJSON
产品数量单产品,3 种支付方式(扫码/H5/付款码)6 个产品(C扫B/公众号/APP/小程序/H5/B扫C)

如何选择

  • 接入银联(云闪付):直接对接中国银联网关,资金直清,适合需要云闪付原生扫码/付款码的场景
  • 接入银联商务(UMS):通过银联商务收单,支持银行卡/网关/快捷等全渠道收银,进件方式更丰富

官方网站 · 基于 GNU LGPL v3.0 协议开源