---
title: "Create a virtual bank account"
method: POST
path: "/payment_methods/virtual_bank_accounts"
---

# Create a virtual bank account

`POST /payment_methods/virtual_bank_accounts`

[Available in Production/Sandbox environment] Create a virtual bank account to accept payments.

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `referenceId` string, required — Your internal reference ID, e.g. customer ID or invoice ID. Please note that it has to be unique for each request.<br>Regex: `/^\s*.{1,191}\s*$/`
      - `currency` 'SGD' | 'USD' — Currency of the virtual bank account to be created. To create a USD virtual bank account, it is compulsory to pass in `USD`.
      - `bankShortCode` string — The bank that the end-customer will be making a transfer to. This field can be ignored for USD virtual bank account.<br><b>Supported options:</b><br>FAZZ<br>
      - `network` 'fast' | 'meps' | 'swift' — Payment rail for the virtual bank account. <br><br><strong>Note:</strong><ul><li>`fast`: Supported only for SGD virtual bank accounts. This is the default value for SGD.</li><li>`meps`: Available for SGD virtual bank accounts only.</li><li>`swift`: Available for both SGD and USD. This is the default value for USD.</li></ul>

## Response `200`

200

- union
  - object
    - `data` object
      - `id` string — Virtual bank account ID.
      - `type` string — Request type.
      - `attributes` object
        - `referenceId` string — Your internal reference ID, e.g. customer ID or invoice ID.
        - `instructions` object
          - `bankShortCode` string — The bank that the end-customer will be making a transfer to.
          - `accountNo` string — Virtual bank account number.
          - `recipient_name` string — Recipient name for bank transfers.
          - `bank_payee_name` string — Bank-registered payee name.
  - object
    - `data` object
      - `id` string — Virtual bank account ID.
      - `type` string — Request type.
      - `attributes` object
        - `referenceId` string — Your internal reference ID, e.g. customer ID or invoice ID.
        - `currency` string — Currency of the virtual bank account to be created.
        - `status` string — Virtual bank account's status.

---

[API](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url.md) · [All operations](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straitsx/straitsx-sandbox-base-url/versions/9ceee2969aeb/schema)