Request a virtual account | Redpin

This will initiate the process of creating a virtual account for the customer.

Using the Response: The response includes a unique_identifier that you can use to retrieve the virtual account details. After creating a virtual account, use the unique_identifier from the response with the unique-ref query parameter in the View a virtual account endpoint to get the complete virtual account details.

Example:

$ # Step 1: Create virtual account
> POST /v1/customers/{customer_id}/virtual-accounts
> Response: { "unique_identifier": "6d23072a-ac3e-4146-9b83-7ad384d65707" }
> 
> # Step 2: Get virtual account details using unique_identifier
> GET /v1/customers/{customer_id}/virtual-accounts?unique-ref=6d23072a-ac3e-4146-9b83-7ad384d65707

Authentication: Bearer token required

Virtual accounts are unique, bank routing instructions which are assigned to an individual customer (can be a personal customer or a business customer). Virtual Accounts will be available in a number of currencies. Please contact your Account Manager or Implementation Manager for more information. Virtual accounts can be requested for registered and active customers. This will initiate the process of creating a virtual account for the customer. **Using the Response:** The response includes a `unique_identifier` that you can use to retrieve the virtual account details. After creating a virtual account, use the `unique_identifier` from the response with the `unique-ref` query parameter in the [View a virtual account](/api-reference/customers/api-integration/virtual-accounts/get-virtual-account-by-vban#request.query.unique-ref) endpoint to get the complete virtual account details. **Example:** ```bash # Step 1: Create virtual account POST /v1/customers/{customer_id}/virtual-accounts Response: { "unique_identifier": "6d23072a-ac3e-4146-9b83-7ad384d65707" } # Step 2: Get virtual account details using unique_identifier GET /v1/customers/{customer_id}/virtual-accounts?unique-ref=6d23072a-ac3e-4146-9b83-7ad384d65707 ``` **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

customer_idstringRequired

Unique Customer Identifier

Request

This endpoint expects an object.

currencystringRequired=3 characters

Three-letter currency code as per ISO 4217.

Three-letter currency code as per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

vban_countrystringOptional=3 characters

Three-letter country code as per ISO 3166-1 alpha-3. Mandatory for EUR & GBP virtual accounts.

Three-letter country code as per [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3). Mandatory for EUR & GBP virtual accounts.

Response

Ok. A virtual account creation process has been initiated.

unique_identifierstring

Unique identifier to identify this virtual account in future. Use this identifier with the unique-ref query parameter in the View a virtual account endpoint to retrieve the complete virtual account details including account number, bank details, and status.

Usage Example:

$ GET /v1/customers/{customer_id}/virtual-accounts?unique-ref={unique_identifier}

Unique identifier to identify this virtual account in future. Use this identifier with the `unique-ref` query parameter in the [View a virtual account](/api-reference/customers/api-integration/virtual-accounts/get-virtual-account-by-vban#request.query.unique-ref) endpoint to retrieve the complete virtual account details including account number, bank details, and status. **Usage Example:** ```bash GET /v1/customers/{customer_id}/virtual-accounts?unique-ref={unique_identifier} ```

Errors

This will initiate the process of creating a virtual account for the customer.

Example:

$ # Step 1: Create virtual account
> POST /v1/customers/{customer_id}/virtual-accounts
> Response: { "unique_identifier": "6d23072a-ac3e-4146-9b83-7ad384d65707" }
> 
> # Step 2: Get virtual account details using unique_identifier
> GET /v1/customers/{customer_id}/virtual-accounts?unique-ref=6d23072a-ac3e-4146-9b83-7ad384d65707

Authentication: Bearer token required

1	import requests
2
3	url = "https://sandbox.currenciesdirect.com/v1/customers/cust_123456789/virtual-accounts"
4
5	payload = {
6	"currency": "EUR",
7	"vban_country": "USA"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

$	# Step 1: Create virtual account
>	POST /v1/customers/{customer_id}/virtual-accounts
>	Response: { "unique_identifier": "6d23072a-ac3e-4146-9b83-7ad384d65707" }
>
>	# Step 2: Get virtual account details using unique_identifier
>	GET /v1/customers/{customer_id}/virtual-accounts?unique-ref=6d23072a-ac3e-4146-9b83-7ad384d65707