1. 简介#

1.1 应用场景#

1.2 操作步骤#

1.3 说明#

2.对接准备#

在进行交易对接之前，通常需要完成一些前置工作，包括以下几个方面：
【机构开立】合作方提供企业相关信息，由国通产品运营人员申请开立后提供，用于传参使用。

【公钥获取】在进行联调之前，您需要获取公钥用于加密和签名等安全处理操作。这些公钥通常由国通产品运营通过邮件方式下发给合作方，在获取公私钥之后，请注意以下几点：
①区分测试环境和生产环境：确保您从国通产品运营那里获取到的公私钥是适用于相应环境（测试或生产）的。测试环境用于开发、调试和测试过程，而生产环境则是实际交易的环境。
②保证安全性：公私钥是非常重要的安全资料，请妥善保存，避免泄漏给未授权的人员或第三方。建议将其存储在安全的位置，并定期更换密钥以增强系统的安全性。
③配置正确：在进行联调时，请确保将相应的公私钥配置到您的系统中，并在请求和响应中使用正确的密钥进行加密和解密、签名和验签等操作。如果您尚未收到公私钥或有任何疑问，请及时与国通产品运营联系，确保正确获得所需的安全资料，以便顺利进行联调和交易对接。
【商户入网】提供商户入网申请相关资料。这些资料可能包括商户基本信息、营业执照、身份证信息、银行账户等，提交审核通过后将生成国通600商户号，用于传参使用。
①国通APP入网/代理平台入网：测试环境由合作方提供信息，国通产品运营人员申请入驻，生产环境由合作方使用国通APP或国通机构平台入驻（国通APP使用方式及机构账号可联系市场对接人员获取）。
②接口API入网：合作方通过国通入网接口完成商户入网，企业商户调用安心签企业用户开户及普通商户申请入驻 、小微商户调用安心签个人用户开户及小微商户申请入驻， 完成开户、绑卡、结算费率配置。
【商户认证】调用交易接口前，商户除完成入网审核，还需进行支付宝渠道认证。

3.接口调用#

3.1交易处理流程#

3.2退款处理流程#

微信、支付宝、银联云闪付参见退款接口（/yyfsevr/order/refund）；收银调用终端退款参见收银调用终端交易/退款接口（/yyfsevr/order/cashierPay）。 退款接口如下：

①银联微信、银联支付宝、银联小微通道交易支持90天内交易退款，ATQ通道支持30天内交易退款并且需同通道存在余额；
②同一笔订单多次退款的请求需相隔1分钟
③同一商户每秒最大退款频率为10次
④申请退款接口的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接口获取结果
⑤支付宝通道每日23点54分至零点不支持退款
⑥错误或无效请求频率限制: 6qps，即每秒钟异常或错误的退款申请请求不超过6次
⑦部分退款时，手续费计算不四舍五入进1，当交易全额退款时全部手续费退回
退款存在部分退款和全额退款（1）全额退款手续费取原手续费（2）部分退款手续费 算法如下：
a.先算出退款金额比率=退款金额/原交易金额（四舍五入保留小数点后10位）
b.退款手续费=原订单手续费退款金额比率（单位精确分小数后不保留）
c.如退款金额为最后一笔对应退款取剩余退款手续费
案例：
原交易金额：10000；退款金额：5414.14；退款比率：0.5414140000；原手续费：0.99
退款手续费：0.990.5414140000=0.53599986
小数点保留到分最终结果：0.53
如果第二笔订单退款金额4585.86
此时剩余退款金额为4585.86与退款金额一致：
相当于把剩下交易金额全部退掉
退款手续费算法为：原退款手续费-已退款手续费即：0.99-0.53=0.46

3.3对账流程#

以下是对账的一般流程：
【下载对账单】商户可以通过国通提供的接口（SFTP文件，需要添加IP白名单）或机构后台管理系统下载对账单。对账单包含了一段时间内的交易记录和相关的交易信息。

【对账处理】商户将对账单与自己的财务系统进行对比，核对每笔交易的金额、订单号、手续费等信息是否一致。如果发现异常或不一致的交易，商户需要进行调查和处理。
【异常处理】如果商户发现对账中存在异常的交易，如金额错误、重复交易、未完成的退款等，商户需要及时联系国通的技术支持团队或支付机构进行进一步调查和解决问题。
【对账结果确认】商户在核对完所有交易后，应确认对账结果。如果对账无误，商户可以认定交易数据准确无误；如果发现异常，商户需要协调解决问题并与国通或支付机构进行沟通。