---
title: Instant Bank Account Verification - China Business
slug: us-apis/instant-bank-account-verification-china-business
createdAt: 2023-12-13T07:24:57.659Z
---

## Introduction

Our instant bank account verification flow is designed to provide secure and efficient account verification services across various countries, including the United Kingdom, India, United States, Indonesia, Vietnam, Nigeria, Nepal, Pakistan, China, Korea, and Bangladesh etc. This process allows businesses and financial institutions to verify bank account details instantly, streamlining the onboarding process and enhancing the overall user experience.

***Currently Unavailable. Please contact your sales administrator for any more details.***

**Use Cases:**

1. **Cross-Border Transactions:**
   - Facilitate cross-border transactions by quickly and accurately verifying bank account details, enabling secure and efficient international money transfers.
2. **Enhanced Onboarding Process:**
   - Streamline the customer onboarding journey by automating the bank account verification process, reducing manual efforts, and minimizing the risk of errors.
3. **Risk Mitigation:**
   - Minimize the risk of fraudulent activities by validating bank account details through a robust and reliable verification process, providing an additional layer of security.
4. **Currency Confirmation:**
   - Obtain information on the currency associated with the provided bank account, allowing businesses to ensure compatibility and accuracy in financial transactions.

### Bank Account Validation Flow

![](https://lh7-us.googleusercontent.com/KC2yqESACsxFSIPo7IUcH_WWXTPCU1vjpVG1DwUQPMx4K_ZUWLdWtKbztxotYMzpAMv85V40cdKL2IEWqb-bQYWb01ndrqQdcp8N1fWfBnU4mBk4QDegUd9e1ZJZGiii3oFFDKGo6qDv267UJtnskravBA=s2048)

![](https://lh7-us.googleusercontent.com/qYlnlGPTIIU0je7nVAEr74YfSd7eTxBFjjd7I8CP0VCn5yMtYpl241BVCh0sv_1JYJpWbNwyXh5AX77iT3LwalPVVOM3OaXVjbMxTMwiN0WC9NrFWavGTheMyuS5oSfoaxbkyQ23_LMIp-GbMtxkz1XysQ=s2048)

## API description

### Sample cURL

:::CodeblockTabs
Pre-production

```curl
curl --location 'https://api-preproduction.signzy.us/api/v3/global-bank-verification/validate-bank-account/cn' \
--header 'Authorization: <----Auth Token---->' \
--header 'Content-Type: application/json' \
--data '{
    "fullName": "ABCD Company",
    "accountNumber": "32187216345",
    "clearingSystemId": "ABOCC342",
    "isBusiness": "true",
    "creditorIdentifier": "91111111ABHY734"
}'
```

Production

```curl
curl --location 'https://api.signzy.us/api/v3/global-bank-verification/validate-bank-account/cn' \
--header 'Authorization: <----Auth Token---->' \
--header 'Content-Type: application/json' \
--data '{
    "fullName": "ABCD Company",
    "accountNumber": "32187216345",
    "clearingSystemId": "ABOCC342",
    "isBusiness": "true",
    "creditorIdentifier": "91111111ABHY734"
}'
```
:::

### Request Data Parameters(For Businesses)

| Parameter          | Description                                                                                                                               | Data Type            | Type   | Required   |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------ | ---------- |
| fullName           | Full name of bank account holder                                                                                                          | Any non-empty string | String | Mandatory  |
| accountNumber      | Account number of bank account                                                                                                            | Alphanumeric         | String | Mandatory  |
| clearingSystemId   | Clearing system codes of financial institutions  associated with the bank accoun&#x74;**(Swift Code for Businesses- First 8 characters)** | Alphanumeric         | String | Mandatory  |
| isBusiness         | Indicates if the account is a business account                                                                                            | boolean              | string | Mandatory  |
| creditorIdentifier | Creditor identifier for the account<br /><br />**`Uniform social credit code (USCC)`**<br />**`(18 char alphanumeric`**<br />**`code)`**  | Alphanumeric         | string | Mandatory  |

:::hint{type="info"}
**Note:-&#x20;**

- &#x20;Very Big names can cause errors. Try removing last few words in case of better results. We are working to upgrade this in coming months. Reachout to us if you face any difficulties
- Clearing system ID only accepts first 8 digits of Swift code. We are in the process of implementing logic to accept the 11-digits in the coming months.
:::

### Sample Response

:::CodeblockTabs
Success (200) - Bank Account Verified

```json
{
    "result": {
        "description": "Bank Account Verified",
        "matchScore": "0.99",
        "matchScoreDescription": "Strong Match",
        "nameMatched": "北京苹果和橙子公司",
        "currency": ""
    }
}
```

Success (200) - Account number not found

```json
{
    "result": {
        "description": "Account number not found",
        "matchScore": "",
        "matchScoreDescription": "",
        "nameMatched": "",
        "currency": ""
    }
}
```

Success (200) - Unable to validate account number

```json
{
    "result": {
        "description": "Unable to validate account number",
        "matchScore": "",
        "matchScoreDescription": "",
        "nameMatched": "",
        "currency": ""
    }
}
```

Success (200) - Clearing System ID invalid

```json
{
    "result": {
        "description": "Clearing System ID invalid",
        "matchScore": "",
        "matchScoreDescription": "",
        "nameMatched": "",
        "currency": ""
    }
}
```

Bad Request (400)

```json
{
    "error": {
        "name": "error",
        "message": "Bad Request",
        "status": 400,
        "reason": "fullName REQUIRED",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

Upstream Down (409)

```json
{
    "error": {
        "name": "error",
        "message": "Upstream Error",
        "reason": "ERROR",
        "type": "Conflict",
        "statusCode": "409"
    }
}
```
:::

### Success Response Body Parameters

| Key                          | Description                                        | Type   |
| ---------------------------- | -------------------------------------------------- | ------ |
| result.description           | Validation description                             | String |
| result.country               | country associated with bank account               | String |
| result.matchScore            | Degree of matching                                 | Float  |
| result.matchScoreDescription | Description reflecting the strength of the match   | String |
| result.nameMatched           | Name that achieved the match                       | String |
| result.currency              | Currency associated with the validated information | String |

### Error Codes

| Error Code | Description                                             |
| ---------- | ------------------------------------------------------- |
| 200        | Success - The request was processed successfully.       |
| 400        | Bad Request - The request was malformed or invalid.     |
| 409        | Conflict - The request conflicts with the server state. |
| 500        | Internal Server Error - An unexpected error occurred.   |

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::

