大额支付

1. 产品介绍

1.1 简介

受制于现有扫码支付、快捷支付、网银支付的限额，无法满足客户的大额支付和充值的需求，提供了银行大额转账的功能。

1.2 应用场景

银行大额转账适用于客户在移动端和PC端进行大额收款的场景，如供应链支付、加油站汽柴油供应采购等这些大额支付场景；

样例待补充

1：付款人在商户的APP里选择订单进行支付;

2：填写付款人户名、卡号后提交至汇付，汇付返回入账标识；

3：通过付款人银行APP或到银行柜台进行转账操作（卡号，户名，金额，入账标识（填备注） 四要素要一致）；

4：汇付备份金账户收到资金后，系统会自动入账到商户，并异步推送入账信息。

1.3 名词定义及说明

入账标识（调账标识）：我司通过该标识来匹配客户的大额转账交易（该标识我司返回，客户转账时填备注/附言里）

手续费相关：

【实时收取】：默认配置，交易过程中，根据商户配置的手续费率，实时计算并收取。实时收取模式下可以指定手续费内扣或手续费外扣。

【手续费内扣】：默认配置，手续费内扣指从交易金额中扣收手续费，比如100元的交易金额，0.6%的手续费率，手续费为0.6元。收款方实际收款为100.00-0.6=99.4元。

【手续费外扣】：是从指定的主体及斗拱账户中扣收手续费，收款方仍是全额收款。这里指定承担手续费的主体通常是商户、平台、渠道。承担方及账户是在控台上配置的；需单独申请开通。

手续费规则：

1. 交易时手续费默认是内扣，如果商户配置了外扣，可以在调用下单接口时通过【fee_flag】参数指定这笔交易是内扣还是外扣，见【开发指引】-【系统调用流程】-【下单请求支付信息】。
2. 交易手续费，按照四舍五入默认计算，举例：0.2334，保留两位小数为0.23元。
3. 退款手续费，全额退款为全额退费。
4. 退款手续费，部分退款公式为：退款手续费（向上取整）=退款金额*原订单手续费金额/原订单金额。

【多次退款累计的手续费差额会合并计算到最后一笔退款】，举例：向上取整为0.011取整为0.02。

2. 接入前准备

2.1 商务准备

1. 选择接入模式

2. 直签模式：指商户与汇付直接签约。具体流程：商户完成协议签署后，商户需要准备好入网材料提供给汇付销售人员，汇付收到后会尽快为商户发起入网申请，待审核通过入网成功后，商户联系人将收到短信通知控台账号及密码。

3. 服务商模式：指服务商与汇付签约，服务商通过接口或控台方式完成商户入网。具体流程：服务商完成协议签署后，服务商需要准备好入网材料提供给汇付销售人员，汇付收到后会尽快为服务商发起入网申请，待审核通过入网成功后，服务商联系人将收到短信通知控台账号及密码。

4. 在斗拱完成商户进件入网

5. 直签模式：已有汇付销售人员申请开通，商户无须另行操作；

6. 服务商模式：

   1. 控台入网：参考服务商控台进件流程，渠道商接入指引；
   2. API入网：企业商户调用企业商户基本信息入驻接口 、小微商户调用个人商户基本信息入驻接口 完成开户、绑卡、结算配置。

7. 选择接入功能并准备相关材料

   1. 大额转账能力：
      1. 直签模式：联系汇付销售人员申请开通，商户无须另行操作；
      2. 服务商模式：联系汇付销售人员申请开通服务商大额转账权限，开通后给予所属商户开通相关权限；

2.2 对接准备

第一步：密钥获取

联调之前需要先获取公私钥，参见公私解钥参数获取说明；

第二步：公共参数获取

登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息;

第三步：业务开通及配置

直签商户联系销售即可；

• 服务商或代理商开通

服务商或代理商通过线下签约方式申请银行大额转账功能；

汇付运营人员在审核好服务商资料之后，帮助服务商开通、配置、变更；

•  商户开通

1. 开通方式

服务商控台开通：服务商或代理商通过控台为商户开通网银转账功能权限；

1. 服务商通过服务商控台为商户申请

服务商通过服务商控台为商户申请银行大额转账功能

如果是新商户入驻直接申请银行大额转账，申请路径：服务商控台-商户管理-商户入驻

在填写好商户基础信息之后，可以选择开通银行大额转账，并填写相关费率；

配置好之后，上传上述要求的资料，保存并提交入驻；

入驻状态可以在“服务商控台-商户管理-业务管理-申请单管理”页面查询；

2）通过接口开通

调用 商户业务开通 接口开通。具体流程请参考API文档，商户进件。

3. 开发指引

3.1 对接规范

调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：

SDK示例：Java SDK

加签验签：v2版接口加签验签

3.2 确认业务配置

登录控台查询大额转账是否配置完成

1. 通过服务商控台:服务商控台-【商户管理】-【信息查询】-【商户信息】-业务信息-编辑-支付功能

2. 通过商户控台：商户控台-【我的信息管理】-【我的信息】-业务信息

3. 通过商户详细信息查询接口来确认相关配置。

3.3 系统调用流程

3.3.1 交易流程

银行大额转账流程说明

1) 调用银行大额转账接口，创建订单，汇付返回入账标识；

2) 客户通过线上网银/线下银行柜台转账，大额转账四要素（姓名、卡号、金额、入账标识（填备注/附言里））务必填写一致，如不一致请参考3.3.2交易关单流程；

3) 网银或柜台汇款到汇付的备付金账户，所需信息如下：

行名：上海汇付支付有限公司-备付金账户

行号：991290000099

户名：上海汇付支付有限公司

户号：215500687

注：各银行的操作上可能有差异，可能要先选择“支付公司”类型才能找到行名；

       银行大小额时间：工作日早8晚5，超过大小额时间，次工作日入账，具体入账时间以银行为准；

4) 汇付收到银行转账信息后，会匹配大额转账四要素，一致的做自动入账，并异步推送入账信息；

图例：

银行大额转账接口需关注以下字段：

3.3.2 交易关单

• 商户自查发现打款金额或入账标识错误时，可调用关单接口进行关单，并通过企业微信、邮件等方式联系售后经理、汇付运营，进行人工退款；

• 如果2个工作日未完成银行打款，系统会自动关单；

3.3.3 资金流水查询

一般情况，商户通过网银或线下柜台转账成功后，2小时入账成功，如果超过两小时未收到异步推送交易结果，商户可调用资金流水查询接口进行查询入账情况。

3.3.4 对账流程

为了满足商户财务的对账需求，斗拱提供了对账功能。

方案一：控台下载；

方案二：接口获取；参见交易结算对账单查询接口

• 接口下载的对账文件包括以下四类：
  • 日对账单类型：包括日结算对账单、日分账对账单、日出金对账单；
  • 日交易数据：主要是各种支付交易记录；
  • 月结算对账单：按月汇总的结算对账单；
  • 月交易数据：按月汇总支付交易记录；

3.3.5 异步通知

针对交易结果，汇付会通过异步消息的方式通知客户系统。 

调用汇付接口时上送的异步通知地址为http/https路径：服务器为POST回调，默认超时时间为5秒，超时后会重试3次；不支持HTTP重定向；服务器对应答不是200~300之间的错误，会默认重试3次；异步通知服务器对HTTPS不认证验签和ALLOW_ALL_HOSTNAME_VERIFIER；如商户自定义通知端口，请使用8000-9005内端口，否则无法通知；URL 上请勿附带参数；异步回调请求编码集为：UTF-8；收到通知后请返回状态码“200”,响应异步通知。

注意事项：

同样的异步消息可能会通知多次，因此接收异步消息的处理需做好幂等，保障多次接收到同样的消息处理后结果不变。

在实现异步消息接收的同时，都建议您在重要的业务环节，通过反查接口确认 非终态 支付订单的状态，以保证在发生异步消息延迟或无法送达情况下的支付结果一致性。

详见异步通知使用说明。

3.4 支持银行清单

银行处理时间为工作日8:00-17:00，超过17:00（建议在16:30前）将在次工作日处理，具体入账时间以银行为准。

支持个人大额打款银行（11家）：

【工商银行 】【农业银行】【交通银行】【招商银行】【中信银行（仅支持APP）】 【平安银行】【江苏银行】【中国银行】【民生银行】【华夏银行】 【邮政储蓄银行】

支持对公大额打款银行（14家）：

【工商银行】【农业银行】【交通银行】【招商银行】【中信银行】 【建设银行】【江苏银行】【中国银行】【民生银行】【华夏银行】 【邮政储蓄银行】【浦发银行】【东莞农村商业银行】【浙江泰隆商业银行】

4. API列表

5.常见问题

1. 支付接口调用报错：“resp_desc”：“数据权限认证失败”

问题原因：商户信息校验没有通过。

解决方案：

1）检查报文中的产品号（product_id）是否填写正确;

2）检查报文中的系统号（sys_id）和商户号（huifu_Id） 从属关系是否正确。

2. 转账交易完成，但是未正常入账。

问题原因：

1）转账时四要素（姓名、卡号、金额、入账标识）中一项或多项填写错误，导致无法匹配交易

2）交易被风控

解决方案：

联系售后经理、汇付运营，进行人工处置。

更多问题详见斗拱开发者社区：https://service.dougong.net/t/qa