简体中文
添加收款账号
- 方法:
POST - 路径:
/coin/v1/receive-account/create - 参数:JSON Body
pay_method 不同时, pay_info 需要的字段不同。
请求字段
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
currency | string | 是 | pay_method=1 仅 BRL;=2 仅 USDT | 币种 |
pay_method | int32 | 是 | 见 收款方式 | 1 PIX;2 链上 |
description | string | 否 | 长度 0~255 | 说明 |
pay_info | object | 是 | 字段随 pay_method 变化 | 见下 |
pay_info(pay_method=1 PIX)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
payee_name | string | 是 | 收款人姓名 |
tax_type | string | 是 | CPF / CNPJ |
tax_value | string | 是 | 税号 |
pix_type | string | 是 | CPF / CNPJ / EMAIL / PHONE / EVP |
pix_value | string | 是 | PIX Key |
pay_info(pay_method=2 链上)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
payee_name | string | 否 | 不传则为 {network} · {address} |
network | string | 是 | 仅 TRC20 / ERC20 |
address | string | 是 | TRC20:T 开头 34 位;ERC20:0x 开头 42 位 |
响应字段(data)
| 字段 | 类型 | 说明 |
|---|---|---|
receive_account_no | string | 收款账号编号(MWA 前缀,提现接口使用) |
currency | string | 币种 |
pay_method | int32 | 支付方式 |
account | string | 落库账号 |
description | string | 说明 |
status | int32 | 状态(新建默认已激活 1) |
pay_info | object | 按 pay_method 返回对应字段 |
成功响应示例(链上)
json
{
"status": 200,
"msg": "SUCCESS",
"data": {
"receive_account_no": "MWAxxxxxxxxxxxUT",
"currency": "USDT",
"pay_method": 2,
"account": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"description": "TRC 出款地址",
"status": 1,
"pay_info": {
"network": "TRC20",
"address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"payee_name": "TRC20 · TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}成功响应示例(PIX)
json
{
"status": 200,
"msg": "SUCCESS",
"data": {
"receive_account_no": "MWAxxxxxxxxxxxBR",
"currency": "BRL",
"pay_method": 1,
"account": "12345678901",
"description": "巴西收款",
"status": 1,
"pay_info": {
"payee_name": "Joao Silva",
"tax_type": "CPF",
"tax_value": "12345678901",
"pix_type": "CPF",
"pix_value": "12345678901"
}
}
}