Create Virtual Account

Create Virtual Account

Create new Virtual Account

post

https://api.alignlabs.devhttps://api-sandbox.alignlabs.dev

/v0/customers/{customer_id}/virtual-account

Creates Virtual Account and returns deposit information

Path parameters

customer_idstringRequired

The unique identifier of the customer

Header parameters

AuthorizationstringRequired

Token for authentication

Body

application/json

source_currencystring · enumRequired

The currency for the source

Possible values:

source_railsstring · enumOptional

Required only for USD in case you want to accept SWIFT payments

Possible values:

destination_tokenstring · enumOptional

The currency to be deposited

Possible values:

destination_networkstring · enumRequired

The blockchain network for the destination

Possible values:

destination_addressstringOptional

The blockchain address where the funds will be sent

Responses

201

Successful offramp transfer initiation response (synchronous)

application/json

202

Virtual account creation accepted (asynchronous). This response is returned for AED and USD SWIFT virtual accounts. The virtual account will be created asynchronously and you can fetch the details later via the GET /v0/customers/{customer_id}/virtual-account endpoint.

application/json

post

/v0/customers/{customer_id}/virtual-account

HTTPcURLJavaScriptPython

POST /v0/customers/{customer_id}/virtual-account HTTP/1.1
Host: api.alignlabs.dev
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "source_currency": "usd",
  "source_rails": "swift",
  "destination_token": "usdc",
  "destination_network": "polygon",
  "destination_address": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "active",
  "destination_token": "usdc",
  "destination_network": "polygon",
  "destination_address": "text",
  "deposit_instructions": {
    "payment_rails": [
      "sepa"
    ],
    "currency": "eur",
    "bank_name": "text",
    "bank_address": "text",
    "account_holder_name": "text",
    "iban": {
      "bic": "text",
      "iban_number": "text"
    }
  }
}