转账发起
平台需开通代付功能,且在商户后台开启代付API接口开关,才能调用本接口发起转账
请求地址:
api/transfer/submit
请求方式:
POST
请求参数说明:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户ID | pid | 是 | Int | 1001 | |
| 转账方式 | type | 是 | String | alipay | 转账方式列表 |
| 收款方账号 | account | 是 | String | alipay@alipay.com | 支付宝账号/微信OpenId/银行卡号 |
| 收款方姓名 | name | 否 | String | 张三 | 选填,传入则校验账号与该姓名是否匹配 |
| 转账金额 | money | 是 | String | 1.00 | 单位:元 |
| 转账备注 | remark | 否 | String | 选填 | |
| 转账交易号 | out_biz_no | 否 | String | 2016080615134334917 | 传入后可避免出现重复请求转账 必须为19位纯数字,且以日期时间开头 |
| 当前时间戳 | timestamp | 是 | String | 1721206072 | 10位整数,单位秒 |
| 签名字符串 | sign | 是 | String | 参考签名规则 | |
| 签名类型 | sign_type | 是 | String | RSA | 默认为RSA |
返回参数说明:
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|
| 返回状态码 | code | Int | 0 | 0为成功,其它值为失败 |
| 错误信息 | msg | String | 失败时返回转账失败原因 | |
| 转账状态 | status | Int | 0:正在处理 1:转账成功 | |
| 转账交易号 | out_biz_no | String | 2016080615134334917 | 可用于后续转账查询 |
| 接口转账单号 | orderid | String | 40001283951815782 | 支付宝微信返回的转账单号 |
| 转账完成时间 | paydate | String | 2024-07-01 16:47:32 | |
| 转账花费金额 | cost_money | String | 从商户可用余额扣减的金额 | |
| 当前时间戳 | timestamp | String | 1721206072 | 10位整数,单位秒 |
| 签名字符串 | sign | String | 参考签名规则 | |
| 签名类型 | sign_type | String | RSA | 默认为RSA |
转账方式列表
| 状态值 | 描述 |
|---|---|
| alipay | 支付宝 |
| wxpay | 微信支付 |
| qqpay | QQ钱包 |
| bank | 银行卡 |
其他说明:
- 如果返回的转账状态status=0,则需稍后调用转账查询接口查询转账状态。
