收付通汇入金

一、支付产品介绍

收付通汇入金是通联支付推出的大额支付补充产品，通过用户主动网银转账的方式完成支付。

业务场景	场景特点	典型应用案例
线上场景	用户在商户网站、APP或小程序内下单，商户端展示收款账号等信息，用户自行登录网银完成转账支付。	基金认购、大额保费缴纳、P2P理财大额投资、企业线上对公缴费、大额服务采购等。
线下场景	用户在线下门店、展会或面对面场景中完成大额消费，商户通过系统生成收款信息，用户现场使用手机网银或电脑网银转账支付。	线下门店大额商品购买、展会现场大额订单收款、线下服务费支付、保证金现场缴纳等。

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

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

设置商户公私钥、加密key

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

下载通联公钥

第三步：对接规范

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

商户调用【消费申请】/【担保消费申请】/【充值申请】接口，支付模式上送SFT_FUND_IN，创建汇入金订单；

云商通2.0校验订单过期时间不超过7天，默认7天，并返回收款账号、收款银行、打款金额等打款信息；

用户根据展示的收款信息，登录手机网银或电脑网银主动向通联备付金子账号转账；

收付通接收银行动账通知后，异步通知云商通2.0汇款结果；

云商通2.0匹配订单与收款账号，校验金额，完成订单账务处理，并通知商户最终结果。

支付模式=收付通汇入金需注意的字段：

请求参数说明

字段	字段类型	是否必填	字段名称	说明
payMode	String	是	支付模式	值为SFT_FUND_IN，表示收付通汇入金
orderValidTime	String	否	订单过期时间	格式：yyyy-MM-ddHH:mm:ss，最长不超过7天。如未上送，系统默认置为7天。

响应参数说明

订收付通汇入金的交易支持接口退款和自动退款两种模式。

商户调用【2294-退款申请】接口发起退款。支持部分金额退款，隔天交易亦可退款。交易完成后建议等待收付通异步通知终态后再发起退款，避免订单状态同步不及时导致退款失败。

注意：收付通汇入金的退款不支持分账回退逻辑，退款金额从未成功入账的汇款金额中扣减，原路退回至用户来款账户。

退款接口关键参数：

字段	字段类型	是否必填	字段名称	说明
orgRespTraceNum	String	否	原通联订单号	与orgReqTraceNum+orgTransDate二选一必填
orgReqTraceNum	String	否	商户订单号	与原订单创建时上送的一致
orgTransDate	String	否	订单时间	yyyy-MM-dd
orderAmount	Long	是	退款总金额	单位：分，支持部分退款和多次退款，累计不超过支付金额
respUrl	String	否	后台通知地址	用于接收退款结果异步通知

订单类型	订单状态	场景说明
汇入金订单	0：进行中	未开始：订单创建成功落单，尚未关联到汇入金流水。待处理：已收到汇入金流水，金额匹配一致，等待账务处理。退款中：因金额不一致/重复打款/无订单等原因，发起自动退款后。
	1：交易成功	入账成功：订单成功入账，资金划拨完成。
	2：交易失败	订单未成功入账，具体情况见处理说明。
退款	0：进行中	退款中：云商通2.0已调用收付通退款接口，退款处理中。
	1：交易成功	退款成功：款项已原路退回用户账户，退款流程完结。
	2：交易失败	退款失败：收付通退款接口返回失败或轮询终态为失败，原因记录在处理说明中。

为满足财务对账需求，通联支持商户下载对账文件：

门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件
调用API接口获取对账文件

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