转账申请
请求地址
[POST] /v1/mid-open-api/transfer/apply需要验证签名
接口描述
通过该接口可以给指定客户的指定账户进行转账，支持同币种和错币种。
提示
平台接收到转账请求，如果错币种，会校验汇率是否在有效期，如果校验失败，会通知转账失败。
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| partner_order_id | string(64) | M | 客户订单号 ,需要保证唯一 |
| client_id | string(64) | M | 客户ID |
| transfer_type | string(64) | M | 当前支持同机构下客户间转账，见下方说明 |
| pay_account_no | string(64) | M | 转出方账户ID |
| pay_currency | string(3) | M | 转出币种 |
| pay_amount | decimal(18,2) | M | 转出金额，最多两位小数 |
| rate_id | string(64) | C | 汇率ID，跨币种必填 |
| rate | decimal(18,9) | C | 汇率，跨币种必填 |
| receiver_client_id | string(64) | M | 转入方客户ID |
| receiver_account_no | string(64) | M | 转入账户ID |
| target_currency | string(3) | M | 转入币种 |
| target_amount | decimal(18,2) | M | 转入金额，最多两位小数 |
| remark | string(128) | O | 备注信息 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| partner_order_id | string(64) | M | 客户订单号 |
| order_id | string(64) | M | 平台订单号 |
| status | string(64) | M | 状态，见下方说明 |
返回示例
- 成功
- 失败
{
"success": true,
"code": 200,
"message": "SUCCESS",
"data": {
"status": "PROCESSING",
"partner_order_id": "test_01d998df4de0",
"order_id": "OT2309060002496458"
}
}
{
"success": false,
"code": 900002,
"message": "pay_currency can't be empty,receiver_client_id can't be empty",
"data": null
}
transfer_type说明
其他转账场景，需要联系平台产品经理沟通确定。
| 值 | 说明 |
|---|---|
| INNER_TRANSFER | 内部客户转账 |
错误码
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong技术人员核查 |
| 900002 | illegal param | 参数有误，请根据提示更正信息 |
status状态值
| 状态值 | 描述 |
|---|---|
| PROCESSING | 处理中 |
| SUCCESS | 成功 |
| FAILED | 失败 |