转账发起
此接口用于向指定账户发起转账,支持支付宝、微信、QQ钱包等多种转账方式。转账前请确保商户余额充足且已开通代付权限。
请求信息
请求URL |
/api/transfer/submit |
请求方式 |
POST |
请求参数
参数名 |
类型 |
必填 |
示例值 |
说明 |
pid |
Int |
是 |
1001 |
商户ID |
out_biz_no |
String |
是 |
2016080615134334919 |
商户转账单号,需保证唯一性 |
type |
String |
是 |
alipay |
转账方式,可选值:alipay(支付宝)、wxpay(微信)、qqpay(QQ钱包) |
account |
String |
是 |
13800138000 |
收款账号,支付宝/微信/QQ号 |
name |
String |
是 |
张三 |
收款方姓名 |
money |
String |
是 |
100.00 |
转账金额,单位:元 |
remark |
String |
否 |
佣金提现 |
转账备注,最长50个字符 |
timestamp |
String |
是 |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
是 |
|
签名字符串,详见签名规则 |
sign_type |
String |
是 |
RSA |
签名类型,默认为RSA |
返回参数
参数名 |
类型 |
示例值 |
说明 |
code |
Int |
0 |
返回状态码,0为成功,其它值为失败 |
msg |
String |
|
返回信息,失败或成功时返回提示 |
out_biz_no |
String |
2016080615134334919 |
商户转账单号 |
orderid |
String |
40001283951815782 |
支付宝/微信返回的转账单号 |
money |
String |
100.00 |
转账金额,单位:元 |
cost_money |
String |
100.50 |
从商户可用余额扣减的金额(包含手续费) |
timestamp |
String |
1721206072 |
当前时间戳,10位整数,单位秒 |
sign |
String |
|
签名字符串,详见签名规则 |
sign_type |
String |
RSA |
签名类型,默认为RSA |
返回示例
成功示例:
{
"code": 0,
"msg": "转账提交成功",
"out_biz_no": "2016080615134334919",
"orderid": "40001283951815782",
"money": "100.00",
"cost_money": "100.50",
"timestamp": "1721206072",
"sign": "xxxxx",
"sign_type": "RSA"
}
失败示例:
{
"code": -1,
"msg": "商户余额不足"
}
其他说明
注意事项
- 接口访问频率限制:每分钟最多10次。
- 转账金额限制:单笔最低0.1元,最高49999元。
- 转账提交后需要调用转账查询接口确认最终转账状态。
- 转账手续费由系统自动计算,计入cost_money中。
- 收款账号和姓名需要相互匹配,否则可能导致转账失败。
- 部分收款账号可能存在限制,建议在转账前进行余额查询。