什么支付接口以及API代付接口

什么支付接口以及API代付接口
一、 前言：
支付通道的API批量自动代付接口。下面就支付接口及API批量代付简单介绍，鉴于很多商户对APi批量自动代付不是很熟悉下文讲主要介绍说明代付业务API接口的设计思路，应用场景等内容。
由于作者本人为业务人员，非技术同学，因此本文不会涉及相关技术说明。
二、支付通道的APi批量自动代付业务API接口整体设计思路：
基于商户能够通过API接口发起支付及代付业务的角度去设计API接口。
APi代付包括的接口为：
●单笔代付接口
●批量代付接口
●交易查询接口
●余额查询接口
●打款通知回调接口
三、 各接口的设计说明：
（1） 单笔代付接口
该接口向商户提供单笔代付发起功能，发起后系统向商户返回接收成功通知；
适用场景：小金额，高频率的代付发起
使用场景：单次，低频率代付发起
参数名称 说明
商户号 商户注册签约后，支付平台分配的唯一标识号
金额 该笔代付交易的金额
代付订单号 唯一的交易订单号，每一笔交易对应一个交易订单号
付款批次号 唯一的付款批次号，可以多笔订单对应一个批次号
银行编码 该笔代付收款银行在系统对应的银行编号
收款人姓名 该笔代付收款人的姓名
收款卡号 该笔代付收款银行卡的卡号
回调通知 推送该笔代付的付款状态

（2）批量代付接口
该接口向商户提供批量代付发起功能，用来实现多笔订单的代付；
适用场景：多笔代付同时发起
参数名称 说明
商户号 商户注册签约后，支付平台分配的唯一标识号
金额 该笔代付交易的金额
代付订单号 唯一的交易订单号，每一笔交易对应一个交易订单号
付款批次号 唯一的付款批次号，可以多笔订单对应一个批次号
银行编码 该笔代付收款银行在系统对应的银行编号
收款人姓名 该笔代付收款人的姓名
收款卡号 该笔代付收款银行卡的卡号
回调通知 推送该笔代付的付款状态

（3） 交易查询接口
该接口向商户提供交易查询功能，发起后系统向商户返回交易数据；
使用场景：有针对性的查询某一笔或多笔代付订单的实时交易状态
请求参数

参数名称 说明
商户号 商户注册签约后，支付平台分配的唯一标识号
请求时间 该笔代付请求的发起时间
商户代付订单号 商户系统中的唯一订单号

响应参数：
参数名称 说明
商户代付订单号 商户系统中的唯一订单号
交易状态 该笔代付请求的交易状态

四、 建议的API对接业务流程

方式一为商户等待系统回调通知，然后处理业务；
方式二为商户主动发起查询，获得终态结果后处理业务；
方式二在回盘速度上可能会开于回调通知，使用方式一还是方式二视商户的实际交易场景；
五、 代付业务API接口设计中同步或者异步的选择：
同步适用于逻辑简单，业务清楚，事物小的情况；
异步适用于业务方复杂，耗时长的情况；
六、代付业务API接口中的注意事项：
（1） 需要提供明确的错误信息描述和建议解决方案；这个过程中可能出出现商户需要重新发起出款的情况，因此需要明确的信息描述；
（2） 向商户所提供的接口文档中，对每个接口字段都要有明确清楚的定义，限制条件；
（3） 每个接口都建议向商户提供使用场景；
（4） 需要向商户提供建议的业务流程，以防止商户在对接过程中，在对接的流程和步骤上产生问题；