统一转账接口

TIP

可以将商户账号中资金移动到指定账户中，该产品适用商家给企业或个人发放佣金等，但有被灰黑产用于洗钱的的风险，请谨慎使用。

接口说明

参数	说明
请求URL	/unipay/allocation/transfer
请求方式	POST
请求类型	application/json

请求参数

公共参数

字段名	变量名	必填	类型	长度	示例值	描述
应用号	appId	否	String	32	A112544225541	此次操作所要使用的支付应用号
用户IP	clientIp	否	String	64	127.0.0.1	支持V4和V6，部分支付方式要求必填，如调用微信支付方式时
随机数值	nonceStr	否	String	32	d112892e382a7093
签名值	sign	否	String	64	072695d112892e382a7093b81e6a52af
请求时间	reqTime	是	String		2024-10-24 12:00:00	请求时间和当前时间误差不要超过五分钟，时间格式 yyyy-MM-dd HH:mm:ss

业务参数

字段名	变量名	必填	类型		示例值	描述
商户转账号	bizTransferNo	是	String	100	123	支付时客户系统传输的分账单号，需要保证唯一，可以为字符文字组合
支付通道	channel	是	String	20	ali_pay	要进行支付的通道编码，如微信支付、支付宝支付等。见常量和状态表PayChannelEnum相关的描述
转账金额	amount	是	BigDecimal	8,2	10.12	要进行转账的金额,单位为元，保留两位小数
标题	title	是	String	100	转账给小刘
转账原因	description	否	String	150	提成
转账类型	transferType	否	String	20	123	微信使用，见 TransferTypeEnum
收款人账号类型	payeeType	是	String	20		见TransferPayeeTypeEnum
收款人账号	payeeAccount	是	String	100
收款人姓名	payeeName	否	String	50
预留的转账扩展参数	extraParam	否	ChannelParam	2048	暂时未使用
商户扩展参数	attach	否	String	500	id=123332	商户扩展参数，回调时会原样返回
异步通知地址	notifyUrl	否	String	200	http://abc.cn/noticeCallback	异步通知地址

响应结果

通用响应参数

WARNING

状态码返回0只代表受理业务成功，业务是否成功需要看具体业务的返回信息，不为0表示受理失败，具体响应吗可以参考返回状态码

名称	字段	类型	示例值	描述
状态码	code	Integer	0	默认是0，非0表明请求失败，例如签名错误等
提示信息	msg	String		发生错误时会有数据返回
业务数据	data	Json字符串		json格式数据，不同的接口返回结构不同，可以参考业务公共响应参数
签名	sign	String	sIV4zJVhZ4Uz	返回数据的签名值
响应时间	resTime	String	2024-08-08 12:12:12	数据响应的时间, 如果时间与请求时间相差5分钟以上，请排查网络和安全问题
追踪ID	traceId	String	sIV4zJVhZ4Uz	用于查询日志排查问题时进行快速定位

业务响应参数

提示

业务数据包裹在公共响应参数中的data字段，在code为0时才会有返回数据。

字段名	变量名	必传	类型	示例值	描述
转账号	transferNo	是	String		转账时生成的商户转账号
商户转账号	bizTransferNo	是	String		发起转账时传输的转账号
转账状态	status	是	String		见常量和状态表转账状态相关的描述
提示信息	errorMsg	否	String		转账失败时会返回错误信息

HTTP请求示例

请求参数

响应参数(成功)

响应参数(失败)

SDK请求示例

提示

使用SDK可以简化接入支付的速度