# ACCOUNT

## Assets

```
POST /merchant/core/mcb/account/info
```

**Request**

| Param | Type | Require | Remark |
| ----- | ---- | ------- | ------ |
|       |      |         |        |

**Response**

<table><thead><tr><th width="243">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td>accountId</td><td>String</td><td>true</td><td>Account id</td></tr><tr><td>accountName</td><td>String</td><td>true</td><td>Account Name</td></tr><tr><td>accountType</td><td>String</td><td>true</td><td>Account Type</td></tr><tr><td>currency</td><td>String</td><td>true</td><td>Currency</td></tr><tr><td>totalBalance</td><td>BigDecimal</td><td>true</td><td>Total Balance</td></tr><tr><td>availableBalance</td><td>BigDecimal</td><td>true</td><td>Available balance</td></tr><tr><td>frozenBalance</td><td>BigDecimal</td><td>true</td><td>Freeze Balance</td></tr><tr><td>digital</td><td>Long</td><td>true</td><td>Digital</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "accountId": "19847563867367666",
            "accountName":"wallet9023",
            "accountType":"WALLET",
            "currency": "USD",
            "totalBalance": 100,
            "availableBalance": 100,
            "frozenBalance": 0,
            "digital": 2
        }
    ]
}
```

## Account List

```
POST /merchant/core/mcb/account/list
```

**Request**

| Param     | Type    | Require | Remark                                                                  |
| --------- | ------- | ------- | ----------------------------------------------------------------------- |
| accountId | Long    | false   | AccountId                                                               |
| type      | String  | false   | <p>Account Type: WALLET - Wallet Account<br>MARGIN - Margin Account</p> |
| pageNum   | Integer | true    | Current page. Default is 1                                              |
| pageSize  | Integer | true    | Number of pages per page. Default 10, maximum 10                        |

**Response**

<table><thead><tr><th width="243">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td>accountId</td><td>String</td><td>true</td><td>Account id</td></tr><tr><td>accountName</td><td>String</td><td>true</td><td>Account Name</td></tr><tr><td>accountType</td><td>String</td><td>true</td><td>Account Type</td></tr><tr><td>currency</td><td>String</td><td>true</td><td>Currency</td></tr><tr><td>totalBalance</td><td>BigDecimal</td><td>true</td><td>Total Balance</td></tr><tr><td>availableBalance</td><td>BigDecimal</td><td>true</td><td>Available balance</td></tr><tr><td>frozenBalance</td><td>BigDecimal</td><td>true</td><td>Freeze Balance</td></tr><tr><td>digital</td><td>Long</td><td>true</td><td>Digital</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    {
        "total": 21,
        "records":
        [
            {
                "accountId": "19847563867367666",
                "accountName":"wallet9023",
                "accountType":"WALLET",
                "currency": "USD",
                "totalBalance": 100,
                "availableBalance": 100,
                "frozenBalance": 0,
                "digital": 2
            }
        ]
    }
}
```

## Single Account Query

```
POST /merchant/core/mcb/account/single/query
```

**Request**

| Param     | Type | Require | Remark     |
| --------- | ---- | ------- | ---------- |
| accountId | Long | true    | Account ID |

**Response**

<table><thead><tr><th width="243">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td>accountId</td><td>String</td><td>true</td><td>Account id</td></tr><tr><td>accountName</td><td>String</td><td>true</td><td>Account Name</td></tr><tr><td>accountType</td><td>String</td><td>true</td><td>Account Type</td></tr><tr><td>currency</td><td>String</td><td>true</td><td>Currency</td></tr><tr><td>totalBalance</td><td>BigDecimal</td><td>true</td><td>Total Balance</td></tr><tr><td>availableBalance</td><td>BigDecimal</td><td>true</td><td>Available balance</td></tr><tr><td>frozenBalance</td><td>BigDecimal</td><td>true</td><td>Freeze Balance</td></tr><tr><td>digital</td><td>Long</td><td>true</td><td>Digital</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "accountId": "1996967874372661250",
            "accountName":"Frank's wallet",
            "accountType":"WALLET",
            "currency": "USD",
            "totalBalance": 1000,
            "availableBalance": 1000,
            "frozenBalance": 0,
            "digital": 2
        }
    ]
}
```

## Ledger Transactions

User's financial transaction history

```
POST /merchant/core/mcb/account/transaction
```

**Request**

<table><thead><tr><th width="111.2838134765625">Param</th><th width="95.1292724609375">Type</th><th width="102.907958984375">Require</th><th>Remark</th></tr></thead><tbody><tr><td>pageNum</td><td>Integer</td><td>true</td><td>Current page. Default is 1</td></tr><tr><td>pageSize</td><td>Integer</td><td>true</td><td>Number of pages per page. Default 10, maximum 100</td></tr><tr><td>orderNo</td><td>String</td><td>false</td><td>Transaction id</td></tr><tr><td>accountId</td><td>Long</td><td>false</td><td>Account ID</td></tr><tr><td>bizType</td><td>String</td><td>false</td><td><p>Transaction type<br><code>chain_deposit</code>: Wallet chain deposit<br><code>chain_withdraw</code>: Wallet chain withdrawal<br><code>card_purchase</code>: Card purchase<br><code>card_deposit</code>: Card deposit<br><code>card_withdraw</code>: Card withdraw<br><code>card_cancel</code>: Card cancel<br><code>card_auth_fee_patch</code>: Card authorization fee<br><code>card_auth_cross_board_patch</code>: Card cross-border fee<br><code>gt_transfer</code>: Global transfer<br><code>fixed</code>: Adjustment<br><code>card_overdraft_statement</code>: Card overdraft bill<br><code>gt_transfer_refund</code>: Global transfer refund</p><p><code>card_settlement</code>: Card transaction settlement</p><p><code>card_refund</code>: Card transaction refund<br><code>fund_transfer</code>: Fund transfer<br><code>fund_collection</code>: Fund Collection<br><code>card_decline_fee</code>: Card refusal processing fee</p></td></tr><tr><td>startTime</td><td>Long</td><td>false</td><td><p>Start transaction time. Milliseconds timestamp.</p><p>The time range cannot exceed 30 days. The default query retrieves data from the most recent 30 days.</p></td></tr><tr><td>endTime</td><td>Long</td><td>false</td><td>End transaction time. Milliseconds timestamp.<br>The time range cannot exceed 30 days. The default query retrieves data from the most recent 30 days.</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="137.58331298828125">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td>txId</td><td>Long</td><td>true</td><td>Internal transaction id</td></tr><tr><td>accountId</td><td>String</td><td>true</td><td>account id</td></tr><tr><td>amount</td><td>BigDecimal</td><td>true</td><td>Amount</td></tr><tr><td>beforeBalance</td><td>BigDecimal</td><td>true</td><td>Before balance</td></tr><tr><td>afterBalance</td><td>BigDecimal</td><td>true</td><td>After Balance</td></tr><tr><td>orderNo</td><td>String</td><td>true</td><td>Transaction id</td></tr><tr><td>bizType</td><td>String</td><td>true</td><td><p>Transaction type<br><code>chain_deposit</code>: Wallet chain deposit<br><code>chain_withdraw</code>: Wallet chain withdrawal<br><code>card_purchase</code>: Card purchase<br><code>card_deposit</code>: Card deposit<br><code>card_withdraw</code>: Card withdraw<br><code>card_cancel</code>: Card cancel<br><code>card_auth_fee_patch</code>: Card authorization fee<br><code>card_auth_cross_board_patch</code>: Card cross-border fee<br><code>gt_transfer</code>: Global transfer<br><code>fixed</code>: Adjustment<br><code>card_overdraft_statement</code>: Card overdraft bill<br><code>gt_transfer_refund</code>: Global transfer refund</p><p><code>card_settlement</code>: Card transaction settlement</p><p><code>card_refund</code>: Card transaction refund<br><code>fund_transfer</code>: Fund transfer<br><code>fund_collection</code>: Fund Collection<br><code>card_decline_fee</code>: Card refusal processing fee</p></td></tr><tr><td>direction</td><td>String</td><td>true</td><td>Direction. <code>IN</code>  <code>OUT</code></td></tr><tr><td>remark</td><td>String</td><td>false</td><td>Remark</td></tr><tr><td>createTime</td><td>Long</td><td>true</td><td>Transaction time. Milliseconds timestamp</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "SUCCESS",
    "data":
    {
        "total": 34,
        "records":
        [
            {
                "txId": 517581,
                "accountId": "1979009257233215490",
                "currency": "USD",
                "amount": "4.08",
                "beforeBalance": "99327.04375",
                "afterBalance": "99322.96375",
                "orderNo": "C2C_UZS_2025122307584616966",
                "bizType": "gt_transfer",
                "direction": "OUT",
                "remark": "Global transfer",
                "createTime": 1766480100874
            },
            {
                "txId": 517580,
                "accountId": "1979009257233215490",
                "currency": "USD",
                "amount": "113.93",
                "beforeBalance": "99440.97375",
                "afterBalance": "99327.04375",
                "orderNo": "C2C_TJS_2025122307554166839",
                "bizType": "gt_transfer",
                "direction": "OUT",
                "remark": "Global transfer",
                "createTime": 1766480100707
            }
        ]
    }
}
```

## Create a shared account

```
POST /merchant/core/mcb/account/create
```

**Request**

<table><thead><tr><th>Param</th><th width="106.69873046875">Type</th><th width="112.3602294921875">Require</th><th>Remark</th></tr></thead><tbody><tr><td>accountName</td><td>String</td><td>true</td><td>Shared account name</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="243">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td>accountId</td><td>String</td><td>true</td><td>Account id</td></tr><tr><td>accountName</td><td>String</td><td>true</td><td>Account Name</td></tr><tr><td>accountType</td><td>String</td><td>true</td><td>Account Type</td></tr><tr><td>currency</td><td>String</td><td>true</td><td>Currency</td></tr><tr><td>totalBalance</td><td>BigDecimal</td><td>true</td><td>Total Balance</td></tr><tr><td>availableBalance</td><td>BigDecimal</td><td>true</td><td>Available balance</td></tr><tr><td>frozenBalance</td><td>BigDecimal</td><td>true</td><td>Freeze Balance</td></tr><tr><td>digital</td><td>Long</td><td>true</td><td>Digital</td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data":
    [
        {
            "accountId": "1996967874372661250",
            "accountName":"margin9980",
            "accountType":"MARGIN",
            "currency": "USD",
            "totalBalance": 0,
            "availableBalance": 0,
            "frozenBalance": 0,
            "digital": 2
        }
    ]
}
```

## Fund transfer

```
POST /merchant/core/mcb/account/transfer
```

**Request**

<table><thead><tr><th width="161.10150146484375">Param</th><th width="127.06591796875">Type</th><th width="103.5789794921875">Require</th><th>Remark</th></tr></thead><tbody><tr><td>type</td><td>String</td><td>true</td><td>Operation type: <br><code>TRANSFER</code>: represents transfer;<br><code>COLLECTION</code>: represents collection.</td></tr><tr><td>merchantOrderNo</td><td>String</td><td>true</td><td>Client transaction id. length[20...40]</td></tr><tr><td>amount</td><td>BigDecimal</td><td>true</td><td>Amount of operation</td></tr><tr><td>payerAccountId</td><td>Long</td><td>true</td><td>Payer ID, typically an account ID of type WALLET.</td></tr><tr><td>payeeAccountId</td><td>Long</td><td>true</td><td>Payee ID, usually an account ID of type MARGIN.</td></tr><tr><td>remark</td><td>String</td><td>false</td><td>Remark</td></tr></tbody></table>

**Response**

<table><thead><tr><th width="243">Param</th><th width="119">Type</th><th width="99">Require</th><th>Remark</th></tr></thead><tbody><tr><td></td><td></td><td></td><td></td></tr></tbody></table>

**Example Response**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": true
}
```