快捷支付

一、支付产品介绍

1.1产品概述

快捷支付是通联支付收银宝平台提供的一种银行卡快捷付款方式。持卡人无需登录网上银行，可直接输入卡面信息及持卡人身份信息，通过验证银行预留手机接收的校验码完成签约或支付。主要用于PC网站或移动端的银行卡支付场景。

1.2适用场景

快捷支付适用于以下线上和线下场景：

1.3商户入网

商户可联系通联分公司人员签署协议提交入网材料，审核通过入网成功后，即可进行支付产品开通。

一、技术开发准备

2.1开发环境准备

第一步：密钥获取（云梯）

设置商户公私钥、加密key

第二步：公共参数获取（云梯）

下载通联公钥

第三步：对接规范

调用通联接口，统一使用POST形式提交，数据格式统一为JOSN，相关SDK及签名方法如下：SDK示例：https://prodoc.allinpay.com/doc/1360/

• 接口说明

3.1API列表

快捷支付相关接口如下：

说明：快捷支付仅支持绑卡方式为“7-收银宝快捷支付签约”绑定的银行卡。

3.2消费流程

快捷支付消费流程包括签约流程和支付流程两部分。

签约流程

快捷支付需要用户先完成签约绑卡后方可发起支付。

方式一：纯接口签约

• 商户调用【个人会员实名及绑卡（申请）（1010）】，上送“绑卡类型”为“7-收银宝快捷支付签约”，发起签约申请。
• 银行向用户银行预留手机号发送短信验证码。
• 用户输入验证码，商户调用【个人会员实名及绑卡（确认）（1011）】确认签约。
• 签约成功后，返回协议号，商户保存协议号用于后续支付。

方式二：一键绑卡签约

调用【一键绑卡申请】接口，仅需一次性上送持卡人银行代码、姓名、证件号，即可无缝跳转至银行H5页面，自动呈现名下全部银行卡列表。持卡人点选卡片后，一步完成短信验证码确认，实现绑卡签约。

支付流程

快捷支付支持免短信验证和验证短信两种模式。

模式A：免短信验证

• 用户选择快捷支付，商户调用【消费申请（2085）】向云商通发起支付请求，支付模式上送 QUICKPAY_VSP。
• 云商通向支付渠道请求支付。
• 响应返回订单状态，不返回验证方式，无需调用确认支付接口。
• 支付完成后，渠道异步通知云商通，云商通通过【订单结果通知】异步通知商户结果。

模式B：验证短信（交易验证方式：1）

• 用户选择快捷支付，商户调用【消费申请（2085）】发起支付请求，支付模式上送 QUICKPAY_VSP。
• 云商通向支付渠道请求支付。
• 响应不返回订单状态，返回验证方式值为“1”，需继续调用【确认支付（后台+短信验证码确认）】完成支付确认。
• 支付完成后，渠道异步通知云商通，云商通通过【订单结果通知】异步通知商户结果。
• 如长时间未收到异步通知，可调用【订单状态查询】或【订单详情查询】接口查询订单状态。

消费申请接口关键字段

说明：快捷支付仅支持绑卡方式“7-收银宝快捷支付签约”绑定的银行卡。

3.3退款流程

若用户需要退款则可调用退款接口，将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下：

• 上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口
• 退款支持部分退款和全额退款，同时支持多次退款。退款金额不能大于支付金额。

3.4订单管理

客户支付完成后，云商通将支付结果通过【订单结果通知】异步推送给商户。如果长时间未收到异步通知，可调用【订单状态查询】或【订单详情查询】接口查询订单状态。

3.5订单对账

为满足财务对账需求，通联支持商户下载对账文件。具体方式如下：

门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件

调用API接口获取对账文件

商户可调用【下载商户对账文件】接口下载对账文件，支持日度、月度对账文件获取，文件格式支持CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。