统一支付接口
查看产品
更新时间:2022-08-09 11:27:30
全渠道统一支付接口是将银联现有在全渠道、CUPA等多个平台上分散建设的卡、码、脸等支付产品(包括支付、撤销和查询等多个API接口)整个为一套接口,支付商户无感知对接银联现有及未来新增的支付产品,且后续新产品上线不需要再次改造,只需商户或技术服务商启用接口预留字段即可接入。
API名称 |
请求方式 |
API描述 |
操作 |
统一支付接口 |
HTTP
POST |
用于线下刷卡交易、生物特征识别(例如人脸)、被扫支付等后台交易。
对于被扫支付,收银员使用扫码设备读取用户微信、支付宝、云闪付等APP付款码以后,二维码或条码信息传送至商户收银台,由商户收银台或者商户后台调用该接口发起支付对用户进行收款。
对于线下刷卡交易,上送卡支付信息域;刷脸和二维码被扫交易上送授权码域。
+三家授权码的规则
关于调用支付接口后相关情况的处理方案:当调用扣款接口返回支付中或未知状态,需要调用查询接口查询订单实际支付状态。当遇到用户超过日限额需要输入密码返回“支付中”的状态,建议 5 秒调一次查询,调用 6 次后还未成功作支付超时处理。
调用订单查询接口建议:查询6次每隔2的N次方秒查询一次(具体的查询次数和时间也可自定义,建议查询时间不低于30秒)6次查询完成,接口仍未返回成功标识,则调用冲正接口;
|
查看详情
|
退货 |
HTTP
POST |
该交易是支付交易的反向交易,用于商户因商品回退或服务取消,将已扣款项归还持卡人原扣款账户。支持部分退货、多次退货。该交易参加资金清算,为后台交易。 |
查看详情
|
冲正 |
HTTP
POST |
冲正必须与原始消费在同一天(准确讲是昨日23:00至本日23:00之间)。
冲正交易,仅用于超时无应答等异常场景,只有发生支付系统超时或者支付结果未知时可调用冲正,其他正常支付的订单如果需要实现相通功能,请调用消费撤销或者退货。
特别说明:仅支持正向交易,其他交易不支持冲正。
|
查看详情
|
交易状态查询 |
HTTP
POST |
对于未收到交易结果的联机交易,商户应向银联全渠道支付平台发起交易状态查询交易,查询交易结果。完成交易的过程不需要同持卡人交互,属于后台交易。可查询N次(建议不超过6次),每次时间间隔2的N次秒发起,即间隔1、2、4、8、16、32秒查询(具体的查询次数和时间也可自定义,建议查询时间不低于30秒);查询5次以上,仍获取不到明确状态的交易,后续可以间隔更长时间发起查询,最终结果以对账文件为准。 |
查看详情
|
银联加密公钥更新 |
HTTP
POST |
商户定期(1天1次)向银联全渠道系统发起获取加密公钥信息交易。在加密公钥证书更新期间,全渠道系统支持新老证书的共同使用,新老证书并行期为1个月。全渠道系统向商户返回最新的加密公钥证书,由商户服务器替换本地证书。 |
查看详情
|
终端签到 |
HTTP
POST |
参照《销售点终端(POS)应用规范》,POS向银联收单系统签到获取工作密钥。
|
查看详情
|
预授权 |
HTTP
POST |
暂无 |
查看详情
|
预授权撤销 |
HTTP
POST |
预授权成功的交易,可以发起撤销。 |
查看详情
|
预授权完成 |
HTTP
POST |
暂无 |
查看详情
|
预授权完成撤销 |
HTTP
POST |
暂无 |
查看详情
|
终端签退 |
HTTP
POST |
接口介绍 参照《销售点终端(POS)应用规范》。 |
查看详情
|
POS参数传递 |
HTTP
POST |
接口介绍 参照《销售点终端(POS)应用规范》。 |
查看详情
|
参数下载结束 |
HTTP
POST |
接口介绍 参照《销售点终端(POS)应用规范》。 |
查看详情
|
批结算 |
HTTP
POST |
接口介绍 参照《销售点终端(POS)应用规范》。 |
查看详情
|