快捷协议

一、支付产品介绍

快捷协议是通联支付收付通平台提供的一种基于协议支付的代收产品。商户与用户签署支付协议后，可根据协议约定直接扣款，实现快速、安全的在线支付。快捷协议支持一次性签约、多次使用，适用于多种线上线下的代收场景。

业务场景	场景特点	典型应用案例
线上场景	用户在商户网站、APP或小程序内完成签约授权，后续由商户根据协议约定自动发起扣款，无需用户重复输入银行卡信息。	会员订阅（视频、音乐、阅读会员定期扣费）；教育分期、医美分期等分期还款；水电煤、物业费、学费等账单定期缴费；企业间对公账户资金归集。
线下场景	用户在线下门店或面对面场景中，通过商户系统或扫码方式完成签约或支付授权，实现快速扣款。	线下门店会员储值、预付费卡充值；现场服务费定期代扣；企业保证金现场缴纳。

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

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

设置商户公私钥、加密key

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

下载通联公钥

第三步：对接规范

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

快捷协议支付相关接口如下（各接口链接到综合支付版的具体接口规范）：

功能	接口	描述
订单创建	【2085-消费申请】	支付模式上送“QUICKPAY_SFT”，创建快捷协议支付订单
订单结果通知	【订单结果通知】	订单处理成功或失败均发送异步通知
退款	【2294-退款申请】	对消费订单发起退款，支持全额/部分退款
订单关闭	【2295-订单关闭】	按需对接，支持关闭未付款成功的订单
订单状态查询	【3001-订单状态查询】	查询订单状态（长时间未收到通知时调用）
对账	【4002-对账单文件下载】	下载对账文件进行交易对账
会员签约	【1010-个人会员实名及绑卡（申请）】	快捷协议签约，上送“绑卡类型”为“6-收付通协议”
会员签约确认	【1011-个人会员实名及绑卡（确认）】	确认签约短信验证码，完成绑卡

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

签约流程

支付流程

消费申请接口关键字段

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

订单类型	订单状态	场景说明
消费	0：进行中	待支付：订单创建成功落单，等待渠道处理扣款。支付中：渠道正在处理扣款请求。
	1：交易成功	支付成功：渠道已完成扣款，资金划拨完成。
	2：交易失败	支付失败：余额不足、协议已解除、银行卡异常、发卡行不支持等原因，订单未成功支付，具体情况见处理说明。已关闭：订单超过有效时间未支付成功，系统自动关闭。
退款	0：进行中	退款中：云商通已调用退款接口，退款处理中。
	1：交易成功	退款成功：款项已原路退回用户账户，退款流程完结。
	2：交易失败	退款失败：原交易不存在、退款金额超过原金额、收付通退款接口返回失败等原因，退款未成功，原因记录在处理说明中。

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

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

调用API接口获取对账文件

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