# China

## Required Fields

| Field                  | Format                                                                                                              | Description                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `login`                | String                                                                                                              | Cashouts login                                                                                                   |
| `pass`                 | String                                                                                                              | Cashouts pass                                                                                                    |
| `external_id`          | String (max length: 100)                                                                                            | Transaction's ID on your end                                                                                     |
| `document_id`          | See [document validations](https://docs.lime-pay.com/knowledge-base/countries-specifications#documents-validations) | Beneficiary's document ID                                                                                        |
| `country`              | `CN`                                                                                                                | See [country codes](https://docs.lime-pay.com/knowledge-base/countries-specifications#countries-and-currencies)  |
| `currency`             | `CNY` / `USD`                                                                                                       | See [currency codes](https://docs.lime-pay.com/knowledge-base/countries-specifications#countries-and-currencies) |
| `amount`               | Number with up to 2 decimals                                                                                        | Cashout amount                                                                                                   |
| `bank_account`         | Numeric                                                                                                             | Beneficiary's bank account                                                                                       |
| `bank_code`            | See [bank codes](#bank-code)                                                                                        | Code specifying the beneficiary's bank                                                                           |
| `beneficiary_name`     | String (max length: 100)                                                                                            | Beneficiary's name in Chinese (中文)                                                                               |
| `beneficiary_lastname` | String (max length: 100)                                                                                            | Beneficiary's last name in Chinese (中文)                                                                          |
| `email`                | String (max length: 100)                                                                                            | User's email                                                                                                     |
| `phone`                | String                                                                                                              | <p>Beneficiary's phone number including country code</p><h4 id="bank-account-validations"><br></h4>              |

## Bank Account Validations

<table data-header-hidden><thead><tr><th>Bank name</th><th align="center">Bank code</th><th width="187">Format</th><th>Description</th><th>Regex</th><th>Example</th></tr></thead><tbody><tr><td>Bank name</td><td align="center">Bank code</td><td>Format</td><td>Description</td><td>Regex</td><td>Example</td></tr><tr><td>Others</td><td align="center">-</td><td>Numeric</td><td>Numeric bank account. Length between 3 and 20 digits inclusive</td><td><code>^\d{3,20}$</code></td><td>3374856</td></tr></tbody></table>

## Document Validations

[Click here](https://docs.lime-pay.com/knowledge-base/countries-specifications#documents-validations) to check document types and validations.<br>

## Example Request

```json
{
    "login": "xxxxxxx",
    "pass": "xxxxxxx",
    "external_id": "30000000001",
    "document_id": "873839473123",
    "country": "CN",
    "amount": 100,
    "currency": "USD",
    "bank_code": "149",
    "bank_account": "2837493",
    "bank_branch": "", 
    "beneificiary_name": "名",
    "beneificiary_lastname": "姓",
    "email": "user@email.com",
    "phone": "+8618581234567",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}
```

## Bank Code

{% hint style="info" %}
For the full and most up-to-date list of banks and its codes, please check the [Cashout Bank Code endpoint.](https://docs.lime-pay.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)
{% endhint %}

<table data-header-hidden><thead><tr><th width="374">Bank</th><th>Code</th></tr></thead><tbody><tr><td>Bank of Communications</td><td>301</td></tr><tr><td>China CITIC Bank</td><td>302</td></tr><tr><td>Shanghai Pudong Development Bank</td><td>310</td></tr><tr><td>China Minsheng Bank</td><td>305</td></tr><tr><td>Pingan bank</td><td>903</td></tr><tr><td>Postal Savings Bank of China</td><td>403</td></tr><tr><td>China s Industrial Bank</td><td>309</td></tr><tr><td>China Everbright Bank</td><td>303</td></tr><tr><td>China Construction Bank</td><td>105</td></tr><tr><td>Industrial and Commercial Bank</td><td>102</td></tr></tbody></table>