English
Create Receive Account
- Method:
POST - Path:
/coin/v1/receive-account/create - Parameters: JSON Body
Required pay_info fields differ by pay_method.
Request fields
| Field | Type | Required | Constraint | Description |
|---|---|---|---|---|
currency | string | Yes | pay_method=1 only BRL; =2 only USDT | Currency |
pay_method | int32 | Yes | See Pay method | 1 PIX; 2 on-chain |
description | string | No | Length 0~255 | Description |
pay_info | object | Yes | Fields vary by pay_method | See below |
pay_info (pay_method=1 PIX)
| Field | Type | Required | Description |
|---|---|---|---|
payee_name | string | Yes | Payee name |
tax_type | string | Yes | CPF / CNPJ |
tax_value | string | Yes | Tax ID |
pix_type | string | Yes | CPF / CNPJ / EMAIL / PHONE / EVP |
pix_value | string | Yes | PIX Key |
pay_info (pay_method=2 on-chain)
| Field | Type | Required | Description |
|---|---|---|---|
payee_name | string | No | Defaults to {network} · {address} if omitted |
network | string | Yes | Only TRC20 / ERC20 |
address | string | Yes | TRC20: starts with T, 34 chars; ERC20: starts with 0x, 42 chars |
Response fields (data)
| Field | Type | Description |
|---|---|---|
receive_account_no | string | Receive account number (MWA prefix; used by withdraw APIs) |
currency | string | Currency |
pay_method | int32 | Payment method |
account | string | Stored account value |
description | string | Description |
status | int32 | Status (newly created defaults to active 1) |
pay_info | object | Fields corresponding to pay_method |
Success response example (on-chain)
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"
}
}
}Success response example (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"
}
}
}