银联支付
通道概述
银联(即云闪付)是中国银联旗下的全渠道支付服务,通过银联全渠道支付平台(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_pay | ums_pay |
| 对接主体 | 中国银联全渠道支付平台(95516.com) | 银联商务有限公司开放平台 |
| 签名方式 | RSA2 证书签名(PKCS12 私钥 + 中级/根证书) | HmacSHA256 无证书(appKey + secretKey) |
| 报文格式 | form-urlencoded | JSON |
| 产品数量 | 单产品,3 种支付方式(扫码/H5/付款码) | 6 个产品(C扫B/公众号/APP/小程序/H5/B扫C) |
如何选择
- 接入银联(云闪付):直接对接中国银联网关,资金直清,适合需要云闪付原生扫码/付款码的场景
- 接入银联商务(UMS):通过银联商务收单,支持银行卡/网关/快捷等全渠道收银,进件方式更丰富