---
updatedAt: 2026-09-21T15:44:28.000Z
agentTools:
  projectIndex: https://developers.korapay.com/llms.txt
---

# Accepting payments with USD Virtual Bank Accounts

<Callout icon="🚧" theme="warn">
  ### **Beta Disclaimer**

  Please note that **this service is currently only available to merchants participating in our beta program**. If you have any feedback or questions, please [contact us](https://korahq.com/contact-us).
</Callout>

A USD Virtual Bank Account allows you to receive payments in USD at any time from your customers. Each account is “fixed” - there’s no need to generate a new one for every transaction. Every USD Virtual Bank Account is dedicated to a single customer, ensuring that all payments made to that account are automatically associated with them.

### Use Case

Virtual USD bank accounts give businesses a simple way to receive cross-border payments. Businesses can create these accounts for their customers, enabling them to make payments directly on the platform. This provides a seamless, global payment experience for both the business and its customers.

***

There are four main steps to note when accepting USD payments from your customers with Virtual Bank Accounts:

1. **Create Virtual Bank Account Holders for your customers:** To create a virtual bank account holder, make a POST request to the [Create Virtual Bank Account Holder](https://docs.korapay.com/#8f1e91d9-0137-4935-9568-4518586d73b6) endpoint.
2. **Create Virtual Bank Accounts for your customers:** To create virtual bank accounts for your customers, make a request to the [Create Fixed Virtual Bank Account](https://docs.korapay.com/#758aa9ef-c9cd-41b0-86d7-b71f53990f74) API. These accounts can be used to accept payments immediately after they are created. To retrieve details of a virtual account, make a request to the [Virtual Bank Account Query](https://docs.korapay.com/#972e66eb-d625-4510-ad60-67e9709b7d04) API. By default, you can only create one fixed virtual bank account per account holder.
3. **Set up Webhooks:** Since payments to virtual accounts are initiated outside your application, you can only be notified when the payment is complete. Therefore, set up webhooks so that Kora can notify you when your customers make payments.
4. **Verify Payments:** After you receive a webhook notification, verify the payment by making a request to our [Transaction Query](https://docs.korapay.com/#8a602daa-6e83-4118-9ff3-ba8c09ab6f48) API.

<br />

## Creating a USD Virtual Bank Account Holder via API

To create of a virtual bank account holder, make a POST request to the [Create Virtual Bank Account Holder](https://docs.korapay.com/#8f1e91d9-0137-4935-9568-4518586d73b6) endpoint:

`{{baseurl}}/api/v1/virtual-bank-account/account-holders`

**Request Parameters**:

| Parameter                                 | Type   | Required | Description                                                                                                           |
| :---------------------------------------- | :----- | :------- | :-------------------------------------------------------------------------------------------------------------------- |
| `first_name`                              | String | `True`   | The *first name* of the customer/account holder.                                                                      |
| `last_name`                               | String | `True`   | The *last name* of the customer/account holder.                                                                       |
| `use_case`                                | String | `True`   | This is the *use case* for which the account holder and the related accounts are created                              |
| `type`                                    | String | `True`   | The type of account holder to be created for the customer. This can be `individual` or `corporate`                    |
| `email`                                   | String | `True`   | The email address of the customer                                                                                     |
| `date_of_birth`                           | String | `False`  | The date of birth of the customer                                                                                     |
| `nationality`                             | String | `True`   | The nationality of the customer                                                                                       |
| `occupation`                              | String | `True`   | The customer's job occupation                                                                                         |
| `phone`                                   | String | `True`   | The phone number of the customer (should include country code)                                                        |
| `source_of_inflow`                        | String | `True`   | This is the customer's source of income                                                                               |
| `source_of_inflow_document.reference`     | String | `True`   | This should be the file reference from the generated file upload.                                                     |
| `selfie.reference`                        | String | `True`   | This should be the file reference from the generated file upload.                                                     |
| `identification.type`                     | String | `True`   | This is the type of identification document. Currently, only passport is accepted.                                    |
| `identification.document_front.reference` | String | `True`   | This should be the file reference from the generated file upload.                                                     |
| `identification.issued_date`              | String | `True`   | This is the issue date of the identification document, in the format `YYYY-MM-DD`.                                    |
| `identification.expiry_date`              | String | `True`   | This is the expiry date of the identification document, in the format `YYYY-MM-DD`.                                   |
| `identification.country`                  | String | `True`   | This is the country of the identification document.                                                                   |
| `proof_of_address.type`                   | String | `True`   | This is the type of document submitted for the proof of address. It can either be `bank_statement` or `utility_bill`. |
| `proof_of_address.document.reference`     | String | `True`   | This should be the file reference from the generate file upload.                                                      |
| `address.county`                          | String | `True`   | This is the country of residence.                                                                                     |
| `address.zip`                             | String | `True`   | This is the address' ZIP code.                                                                                        |
| `address.address`                         | String | `True`   | This is the address line of the residential address.                                                                  |
| `address.state`                           | String | `True`   | This is the state of the residential address.                                                                         |
| `address.city`                            | String | `True`   | This is the city of the residential address.                                                                          |
| `employment.status`                       | String | `True`   | This is the status of employment for the account holder. This can either be `employer` or `employee`.                 |
| `employment.employer`                     | String | `True`   | This is the employer name.                                                                                            |
| `employment.description`                  | String | `True`   | This is the description of the employment.                                                                            |
| `metadata`                                | Object | `False`  | This is any additional information you may want to share.                                                             |

<br />

The request format would look like this:

```json Sample Request 
{
  "first_name": "Sarah",
  "last_name": "Doe",
  "use_case": "Personal",
  "type": "individual",
  "date_of_birth": "1988-04-04",
  "nationality": "NG",
  "occupation": "Entrepreneur",
  "email": "sarah.doe@example.com",
  "phone": "+2348133443000",
  "bank_id_number": "12332435200",
  "source_of_inflow": "bank_statement",
  "source_of_inflow_document": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
   },
  "selfie": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
   },
  "identification": {
     "type": "passport",
     "number": "A11111111",
     "document_front": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
     },
     "issued_date": "2010-01-01",
     "expiry_date": "2030-01-01",
     "country": "NG"
  },
  "proof_of_address": {
    "type": "bank_statement",
    "document": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
    }
  },
  "address": {
    "country": "NG",
    "zip": "12345",
    "address": "Freedom Way St",
    "state": "Lagos",
    "city": "Lagos"
  },
  "employment": {
    "status": "employer",
    "employer": "Google",
    "description": "I am an employer"
  },
  "metadata": {
    "key1": "value1"
  }
}

```

The response to this request would have the following parameters and format:

| Parameter        | Type    | Required | Description                                                                                               |
| :--------------- | :------ | :------- | :-------------------------------------------------------------------------------------------------------- |
| `status`         | Boolean | True     | This is the request status                                                                                |
| `message`        | String  | True     | This is the request message                                                                               |
| `data.reference` | String  | True     | This is the account holder reference                                                                      |
| `data.email`     | String  | True     | This is the account holder email                                                                          |
| `data.status`    | String  | True     | This is the account holder status. It can either be `pending`, `approval`, `suspended` and `deactivated`. |
| `data.metadata`  | Object  | False    | This is the metadata object that was passed when creating the account.                                    |

```json Sample Response
{
    "status": true,
    "message": "Virtual account holder creation requested successfully",
    "data": {
        "reference": "KPY-AH-CGAXuc6jZwDA8TJ",
        "email": "example@example.com",
        "status": "pending",
        "metadata": {
            "key1": "value1"
        }
    }
}
```

### Sandbox Testing Data

These test the data.

| **BA**        | **BANK CODE&#xA0;** |
| ------------- | ------------------- |
| `IdNumber`    | 11111111111         |
| `FirstName`   | Sarah               |
| `LastName`    | Doe                 |
| `MiddleName`  | James               |
| `DateOfBirth` | 1988-04-04          |

### Generating a File Upload URL

Before uploading a file, you must first generate a pre-signed upload URL. This process ensures secure and authenticated file uploads. To generate a pre-signed upload URL make a POST request to the Generate [File Upload Url ](https://docs.korapay.com/#c55a25d9-138f-4812-b980-307ee235f689:~:text=POST-,Generate%20File%20Upload%20Url,-Mobile%20Money)endpoint:

`{{baseurl}}/api/v1/files/generate-upload-url`

**Here are the steps for uploading a file while creating an account holder:**

* Generate Upload URL: Call the Generate Pre-signed URL endpoint to obtain both the file reference (korapay\_reference) and the upload\_url.
* Upload the File: Use the returned upload\_url to upload the file directly.
* Reference the File: Include the file\_reference in the relevant field (e.g., selfie.reference`,  `identification.document\_front.reference, \`source\_of\_inflow\_document.reference) when calling the Create Account Holder endpoint.

**Request Parameters**:

| Parameter      | Type   | Required | Description                                                                  |
| :------------- | :----- | :------- | :--------------------------------------------------------------------------- |
| `reference`    | String | True     | This is merchant unique reference for this file                              |
| `purpose`      | String | True     | The reason for the file upload. It can be in these formats e.g kyc\_document |
| `content_type` | String | True     | The file content type e.g image/jpeg, application/pdf                        |

**Request format**:

```javascript

{
    "reference": "merchant-file-reference",
    "purpose": "kyc_document",
    "content_type": "application/pdf"
}
```

**Response format**:

```javascript
{
    "status": true,
    "message": "File upload url created successfully",
    "data": {
        "korapay_reference": "KPY-FILE-20250052iYVynj14842",
        "owner_reference": "REF-JGSJHVVV122200",
        "purpose": "kyc_document",
        "upload_url": "https://kpy-exported-files-staging.s3.amazonaws.com...",
        "upload_url_expires": "2025-08-29T14:14:14.849Z"
    }
}
```

<Callout icon="💡" theme="default">
  The details of an Account Holder can also be viewed on your Merchant dashboard. To view details, navigate to the list of Virtual Accounts and select the Account Holder for the chosen foreign currency. You would also be able view the Account Holder’s account number, along with their transaction history and KYC information.

  A webhook notification will be sent to your application once your account holder creation request has been approved or rejected.
</Callout>

<br />

#### Account Holder Approval Process

All created Account Holders go through an approval process, which is typically completed within 24 hours. Once reviewed, a webhook notification will be sent to you indicating whether the Account Holder has been approved or rejected, so you can take the next steps.

**If approved:** You can immediately create individual Virtual Bank Accounts using the
[Create Individual FVBA](https://docs.korapay.com/#758aa9ef-c9cd-41b0-86d7-b71f53990f74) API.

**If rejected:** You can re-upload the KYC information and re-submit the request using the [KYC Update](https://docs.korapay.com/#3582a488-295b-4c84-a846-eaa19d3019a6) API.

<br />

### Updating the KYC details of a USD Virtual Bank Account Holder (Individual)

If a USD Virtual Bank Account Holder’s KYC needs to be updated or is *rejected*, you can update their details by sending a PATCH request to the **[KYC Update](https://docs.korapay.com/#3582a488-295b-4c84-a846-eaa19d3019a6)** endpoint.

`{{baseurl}}/api/v1/virtual-bank-account/account-holders/:reference/update-kyc`

These are the request parameters:

| Parameter                                 | Type   | Required | Description                                                                                                  |
| :---------------------------------------- | :----- | :------- | :----------------------------------------------------------------------------------------------------------- |
| `first_name`                              | String | False    | This is the *first name* of your customer                                                                    |
| `last_name`                               | String | False    | This is the *last name* of your customer                                                                     |
| `source_of_inflow`                        | String | True     | This should either be `payslip` or `bank_statement`.                                                         |
| `source_of_inlow_document.reference`      | String | True     | This should be the file reference from the generate file upload.                                             |
| `selfie.reference`                        | String | True     | This should be the file reference from the generate file upload.                                             |
| `identification.type`                     | String | True     | This is the type of identification document, which can either be `nin`, `voters_card`, or `passport`.        |
| `identification.number`                   | String | True     | This is the identification number.                                                                           |
| `identification.document_front.reference` | String | True     | This should be the file reference from the generate file upload.                                             |
| `identification.issue_date`               | String | True     | This is the issue date of the identification document, in the format `YYYY-MM-DD`.                           |
| `identification.expiry_date`              | String | True     | This is the expiry date of the identification document, in the format `YYYY-MM-DD`.                          |
| `identification.country`                  | String | True     | This is the country on the identification document.                                                          |
| `proof_of_address.type`                   | String | True     | This is the type of document for the proof of address. Either `bank_statement` or `utility_bill` is allowed. |
| `proof_of_address.document.reference`     | String | True     | This should be the file reference from the generate file upload.                                             |

Here's a sample request format:

```javascript Sample Request
{
  "first_name": "Sarah",
  "last_name": "Doe",
  "source_of_inflow": "bank_statement",
  "source_of_inflow_document": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
   },
  "selfie": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
   },
  "identification": {
     "type": "passport",
     "number": "A11111111",
     "document_front": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
     },
     "issued_date": "2010-01-01",
     "expiry_date": "2030-01-01",
     "country": "NG"
  },
  "proof_of_address": {
    "type": "bank_statement",
    "document": {
     "reference": "KPY-FILE-202509091525ocHUp9oxwrt4lICRJ63S35963"
   }
  },
}

```

<br />

A response to this request could look like this:

```json Sample Response
{
    "status": true,
  "message": "Virtual bank account holder update kyc requested successfully",
    "data": {
        "reference": "KPY-AH-WveCyyYAvKh107Y",
        "first_name": "Sarah",
        "last_name": "Doe",
        "status": "pending"
    }
}
```

<br />

### Retrieving the details of a Virtual Account Holder

The details of a Virtual Bank Account can be retrieved at any time after creating the account. To retrieve the details of the account holder, initiate a GET request to the [Fixed Virtual Bank Account Holder Query](https://docs.korapay.com/#67c517c1-29e1-4b48-a04b-7eeb07ebf7ab) endpoint.

`{{baseurl}}/api/v1/virtual-bank-account/account-holders/:accountHolderReference/details`

Here's an example of a response you'd receive for your request:

```json Sample Response
{
    "status": true,
    "message": "Virtual account holder retrieved successfully",
    "data": {
        "reference": "KPY-AH-WveCyyYAvKh107Y",
        "account_type": "individual",
        "first_name": "Sarah",
        "last_name": "Doe",
        "email": "iemaple@example.com",
        "phone_number": "+2348100000000",
        "occupation": "Software Engineering",
        "status": "pending",
        "metadata": {
            "key1": "value1"
        },
        "date_created": "2024-03-22T13:27:17.000Z",
        "country": "NG",
        "date_of_birth": "1988-04-04T00:00:00.000Z",
        "address": {
            "zip": "12345",
            "city": "Lagos",
            "state": "Lagos",
            "address": "Freedom Way St",
            "country": "NG"
        },
        "documents": {
            "identification_front": "base64String",
            "identification_back": "base64String",
            "proof_of_address": "base64String",
            "selfie": "base64String",
            "source_of_inflow": "base64String"
        }
    }
}
```

***

## Creating a USD Virtual Bank Account (for Individual)

After successfully creating the account holder, you can now create a Virtual Bank Account for your customer by making a POST request to the [Create Virtual Bank Account](https://docs.korapay.com/#758aa9ef-c9cd-41b0-86d7-b71f53990f74) API endpoint.

`{{baseurl}}/api/v1/virtual-bank-account`

The request parameters include:

| Parameter                  | Type   | Required | Description                                                                             |
| :------------------------- | :----- | :------- | :-------------------------------------------------------------------------------------- |
| `currency`                 | String | True     | This is the currency for which you want to create the Virtual Bank Account, e.g, `USD`. |
| `account_holder_reference` | String | True     | This is the unique reference returned after creating the account holder.                |
| `account_reference`        | String | True     | This is your unique reference which would be used to identify the virtual account.      |

Here's how the format of this request could look:

```json Sample Request
{
    "currency": "USD",
    "account_holder_reference": "KPY-AH-EKf82jtn6z3696V",
    "account_reference": "AcmWYgVOoq3xkm51"
}
```

And, the response would have the following format and parameters:

```json Sample Response
{
    "status": true,
    "message": "Virtual bank account created successfully",
    "data": {
        "tier": 1,
        "account_reference": "your-account-reference",
        "unique_id": "kora-unique-reference",
        "account_status": "pending",
        "created_at": "2024-06-04T07:35:06.782Z",
        "currency": "USD",
        "account_holder_reference": "KPY-AH-WveCyyYAvKh107Y"
    }
}
```

| Parameter                       | Type   | Required | Description                                                                                        |
| :------------------------------ | :----- | :------- | :------------------------------------------------------------------------------------------------- |
| `status`                        | String | True     | This is the request status.                                                                        |
| `message`                       | String | True     | This is the request message.                                                                       |
| `data.tier`                     | Number | True     | This is the virtual account tier.                                                                  |
| `data.account_reference`        | String | True     | This is the virtual account reference that you passed when creating the account.                   |
| `data.unique_id`                | String | True     | This is the unique reference for the virtual account.                                              |
| `data.account_status`           | String | True     | This is the virtual account's status. It can be `pending`, `active`, `suspended` or `deactivated`. |
| `data.created_at`               | String | True     | This is the date on which the virtual account was created.                                         |
| `data.currency`                 | String | True     | This is the virtual account currency, e.g., `USD`.                                                 |
| `data.account_holder_reference` | String | True     | This is the account holder reference.                                                              |

<Callout icon="🚧" theme="warn">
  **Please note** that, by default, you can only create a total of one (1) virtual bank account per account holder for each currency.
</Callout>

<br />

<br />

These accounts can be used to accept payments immediately they are created.
The details of a USD Individual Virtual Bank Account can also be viewed on your Merchant dashboard. To view, simply click on the list of Virtual Accounts and explore by Account Numbers for the to view its details.

In the details page, you would see an account summary showing the status, account number and bank, account name, account reference and date created. You can click on any of the virtual accounts to view more details about that virtual account number, the account deposit details through which the payments will be made into the account, as well as other important information on the account. You would also see a list of all the transactions made through the virtual account in the Transaction section.

<br />

## Retrieving the details of a USD Individual Virtual Bank Account:

The details of a Virtual Bank Account can be retrieved at any time after creating the account. To do this, you’ll need to initiate a GET request to the [Fixed Virtual Bank Account Query](https://docs.korapay.com/#972e66eb-d625-4510-ad60-67e9709b7d04) endpoint.

`{{baseurl}}/api/v1/virtual-bank-account/:accountReference`

The format for the response received could look like this:

```json Sample Response
{
    "status": true,
    "message": "Virtual bank account retrieved successfully",
    "data": {
        "account_name": null,
        "account_number": "579076548910",
        "account_status": "pending",
        "account_reference": "DSU2-hfyycZ2625126c1",
        "unique_id": "KPY-VA-WSCtv7FNlJ9ZBGt",
        "iban": null,
        "tier": 1,
        "payment_schemes": {
            "swift": {
                "account_holder_name": "Sarah Doe",
                "account_number": "579076548910",
                "memo": "UNHZMBE",
                "bank_name": "Bank of the Lakes",
                "account_holder_address": {
                    "city": "Lagos",
                    "postal_code": "12345",
                    "country_code": "NG",
                    "address_line1": "Freedom Way St"
                },
                "bank_address": {
                    "city": "Duluth",
                    "state": "MN",
                    "postal_code": "55812",
                    "country_code": "US",
                    "address_line1": "123 Cherry Street",
                    "address_line2": ""
                },
                "swift_code": "LAKEUS41"
            },
            "ach": {
                "account_holder_name": "Sarah Doe",
                "account_number": "579076548910",
                "routing_code": "021001208",
                "memo": "XR6MYQ5",
                "bank_name": "Bank of the Lakes"
            },
            "fedwire": {
                "account_holder_name": "Sarah Doe",
                "account_number": "579076548910",
                "routing_code": "021001208",
                "memo": "2Z2T3UV",
                "bank_name": "Bank of the Lakes",
                "account_holder_address": {
                    "city": "Lagos",
                    "postal_code": "12345",
                    "country_code": "NG",
                    "address_line1": "Freedom Way St"
                },
                "bank_address": {
                    "city": "Duluth",
                    "state": "MN",
                    "postal_code": "55812",
                    "country_code": "US",
                    "address_line1": "123 Cherry Street",
                    "address_line2": ""
                }
            }
        },
        "account_type": "individual",
        "email": "jonney.doee40111191@example.com",
        "pending_upgrade_request": false,
        "account_holder": {
            "reference": "KPY-AH-AcmWYgVOoq3xkm5"
        },
        "bank_code": null,
        "currency": "USD",
        "created_at": "2024-04-30T09:47:20.000Z",
        "customer": {
            "name": "Sarah Doe",
            "email": "james.jerry1993@example.com"
        }
    }
}
```

<br />

## Getting notified of payments

After a payment has been made into your Virtual Bank Account, we send a webhook notification to your webhook notification URL. The reference in the notification payload will be used to get the details of the payment.
You can read more about how to handle webhook notifications [here](https://developers.korapay.com/docs/webhooks)

More details on the payments made to Virtual Bank Account can also be viewed from the Pay-ins page of your dashboard. Simply:

* [Log in](https://merchant.korapay.com/auth/login) to your dashboard. [Create an account](https://merchant.korapay.com/) if you don’t already have one.
* Navigate to the **Pay-ins** page.
* Search for the transaction using the transaction reference.
* Click on the transaction to view further details.

<br />

## Fetching transactions on a USD Fixed Virtual Bank Account

You can fetch the details of transactions carried out on a USD Virtual Bank Account. To do this, you’ll need to initiate a GET request to the [Get Virtual Bank Account Transactions](https://docs.korapay.com/#2f5c46cc-9e4c-44be-bbed-cb5330dde3f9) endpoint.

`{{baseurl}}/api/v1/virtual-bank-account/transactions?account_number={{accountNumber}}`

This is an example of how the response to this request would look like:

```json Sample Response
{
    "status": true,
    "message": "Virtual bank account transactions retrieved successfully",
    "data": {
        "total_amount_received": null,
        "account_number": "470492276567",
        "currency": "USD",
        "transactions": [
            {
                "reference": "KPY-PAY-OkFLnGJycmRmmDA",
                "status": "success",
                "amount": "150.00",
                "fee": "2.00",
                "currency": "USD",
                "description": "Payment to Test by Sarah Doe",
                "payer_bank_account": {
                    "account_number": "81191697",
                    "account_name": "simulate test",
                    "bank_name": "Auto Loan Account"
                }
            },
            {
                "reference": "KPY-PAY-OkFLnGJycmRmmDB",
                "status": "flagged",
                "amount": "150.00",
                "fee": "2.00",
                "currency": "USD",
                "description": "Payment to Test by Sarah Doe",
                "payer_bank_account": {
                    "account_number": "81191697",
                    "account_name": "simulate test",
                    "bank_name": "Auto Loan Account"
                }
            }
        ],
        "pagination": {
            "page": 1,
            "total": 2,
            "pageCount": 1,
            "totalPages": 2
        }
    }
}
```

***

# Account Management on the Kora Dashboard

You can manage your USD Virtual Bank Accounts and Account Holders directly from the merchant dashboard. This includes suspending, reactivating, and deactivating accounts as needed.

<br />

## Account holder management

1. **Suspending an account holder**
   1. Virtual Bank Account Holders can be suspended at any time after they have been created.
   2. When an Account Holder is suspended, all Virtual Bank Accounts linked to that Account Holder will also be suspended automatically.
   3. While suspended, the Account Holder cannot create new Virtual Bank Accounts, and existing accounts cannot receive payments.
   4. Any incoming payment attempts will be flagged and not settled into your balance. For flagged transactions, please contact <support@korapay.com>.

2. **Reactivating a suspended account holder**

   1. To reactivate a suspended Account Holder, navigate to the **Manage Account** settings on the USD Account Holder details page and click **Request Reactivation**. This request will be sent to the Kora admin team for approval.
   2. Once reactivated, all associated Virtual Bank Accounts will also be reactivated.
   3. If an individual Virtual Bank Account was suspended independently, you must request its reactivation separately.
   4. Requests to reactivate an Account Holder are reviewed by our team before approval.

   <Callout icon="🚧" theme="warn">
     Note that your request to reactivate a suspended account holder will be sent to our team to review before approval.
   </Callout>

3. **Deactivating an account holder**
   1. Account Holders can also be deactivated at any time.
   2. Be cautious, ***deactivation is final***. Once done, the Account Holder and all associated Virtual Bank Accounts cannot be reactivated.
   3. Payments to a deactivated account will be flagged and not settled.

## Account number management

1. **Suspending a virtual bank account**
   1. Individual USD Virtual Bank Accounts can be suspended at any time.
   2. While suspended, no payments can be made into the account. Any detected payment will be flagged and not settled.

2. **Reactivating a Suspended Virtual Bank Account**

   1. To reactivate a suspended account, navigate to the **Manage Account** settings on the USD Virtual Bank Account details page and click **Request Reactivation**.
   2. This request will be sent to the Kora support team for approval.

   <Callout icon="🚧" theme="warn">
     Your request to reactivate a USD account number will be sent to our team to review before approval.
   </Callout>

3. **Deactivating a Virtual Bank Account**
   1. A Virtual Bank Account can be deactivated at any time.
   2. Take caution because ***deactivation is final***. Once deactivated, the Virtual Bank Account cannot be reactivated.
   3. Payments to a deactivated account will be flagged and not settled.

***

## Crediting a Virtual Bank Account in the Sandbox Environment

Fixed Virtual Accounts on the sandbox environment can be credited with test payments. To do this, you need to make a POST request to the [Credit Sandbox VBA](https://docs.korapay.com/#531895f9-87b9-4f2b-95e8-bfc7a7872deb) endpoint.

`{{baseURL}}/api/v1/virtual-bank-account/sandbox/credit`

The request parameters are as follows:

| Parameter        | Type   | Required | Description                                                                 |
| :--------------- | :----- | :------- | :-------------------------------------------------------------------------- |
| `account_number` | String | True     | This is the account number of the fixed virtual bank account.               |
| `amount`         | Number | True     | This is the amount that you want to credit to the account.                  |
| `currency`       | String | True     | This is the currency of the account. This field only accepts `USD` for now. |

The response to the request would be:

```json Sample Response
{
  "status": true,
  "message": "Virtual bank account credited successfully",
  "data": null
}
```

***

# Definition of supported payment collection schemes:

1. **ACH**: Automated Clearing House interbank payment system, or the ACH network, is an interconnected computer system that communicates with each other to help transfer or receive payments. The ACH payment system is native to the US and is used to complete transactions in USD among financial institutions with bank accounts in the US.
2. **FEDWIRE**: Fedwire, also known as Federal Reserve Wire Network, is a payment system local to the United States, allowing entities to execute time-sensitive, large-value transactions. Fedwire is a well-known payment network for entities as it processes transactions in real-time (immediate fund transfers) with high transactional security.
3. **SWIFT**: SWIFT (Society for Worldwide Interbank Financial Telecommunication) is a global messaging network that facilitates secure communication of financial transactions between institutions worldwide. Transfers can take a few days depending on where it's coming from.