实时付款/代付

一、支付产品介绍

1.1 产品概述

实时付款/代付是通联面向商户推出的资金实时下款能力产品，支持商户通过通联合作银行渠道，将账户资金实时代付至指定个人或企业银行账户。产品支持对私、对公多种收款账户类型，具备到账时效快、渠道覆盖广、全链路可追溯的核心特点，广泛适用于佣金发放、用户提现、退款打款等需要向外部账户实时付款的平台型商户。

1.2 适用场景

产品支持对私银行卡、对公账户多种收款方式，可无缝集成于商户业务系统与资金结算场景，为商户提供安全、便捷、高效的一站式实时代付解决方案。

1.3 商户入网

1.3.1 准入标准

1. 商户主体合规合法，营业执照在有效期内，不属于通联支付禁止准入行业类目
2. 商户经营内容与备案类目一致，不得超范围开展支付业务，不得转借支付接口
3. 商户资金来源合规可追溯，代付场景真实且具备相应业务背景证明材料
4. 完成“实时付款/代付”支付产品的权限配置，并开通对应代付渠道额度

二、技术开发准备

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

点击密钥管理获取商户公钥、私钥及加密密钥。

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

点击通联公钥下载通联公钥

 第三步：对接规范

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

三、开发指引

3.1 核心开发内容

3.2对接规范

测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

生产地址：https://ibsapi.allinpay.com/yst/yst-service-api/tx/handle

支付产品固定值：payMode=WITHDRAW_SFT

请求方式：POST，数据格式 JSON，编码 UTF-8

开发文档：https://prodoc.allinpay.com/doc/1360/

3.3 消费流程

1.商户业务系统调用通联【2290—提现申请】接口，上送支付模式WITHDRAW_SFT，传入代付订单信息、收款账户信息与金额

2.通联系统校验：应用支付产品权限配置是否包含“实时付款/代付”；商户代付额度是否充足；收款账户信息是否合规

3.校验通过后，系统执行账户动账操作：商户账户余额扣减，资金通过收付通代付渠道划转至收款银行账户

4.通联将交易结果异步推送至商户预设回调地址

5.未收到异步通知时，商户可主动调用【3001—订单状态查询】接口获取订单终态

实时付款/代付必填字段

核心返回参数

3.4退款流程

实时付款/代付交易成功后，资金已划转至收款账户，不支持通过接口直接发起退款或撤销。如遇代付错误、重复打款等需追回资金的场景，处理方式如下：

1. 交易处于“进行中”状态时，可联系通联运营人员申请渠道拦截，拦截成功后资金将原路退回商户账户。
2. 交易已成功的，需由商户与收款方协商退款，或通过法律途径追回，通联可协助提供交易凭证。

3.5 订单管理

自主出金支付订单需遵循统一状态流转规则，禁止自定义订单状态，确保交易全链路可追溯、可对账、可排查：

3.6订单对账

为满足商户财务对账、资金核对与多业务线管理需求，通联提供两种对账文件获取方式，对账文件包含所有的交易、退款、手续费明细，支持按支付渠道、交易时间维度筛选：

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

2. 调用API接口获取对账文件

商户可调用接口自动下载对账文件，支持日度、月度对账文件获取，接口详情参考通联官方文档：https://prodoc.allinpay.com/doc/476/；接口调用支持批量下载、定时拉取，适配商户财务系统自动化对账需求，文件格式为CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。