Virtual Accounts

Virtual accounts requires an existing primary account as a parent, and it uses the same currency and safe-guarding relationship as the parent account.

You can create multiple virtual accounts linked with the same primary account, and move funds between:

• Virtual account to virtual account

• Virtual account to parent primary account

• Parent primary account to virtual account

You need an existing Primary Account in order to create a virtual account

Create Virtual Account

Create a virtual account

POSThttps://api.algbralabs.com/v1/partner/accounts/virtual

Header parameters

Body

application/json

idempotencyKey*string (uuid)

A unique idempotency key to prevent duplicate operations

parentAccountId*string (uuid)

The parent account id for the account requested

productCode*string

The product code for the account requested

Example: "FIAT_ACCOUNT_UK_V1"

Response

200

Account successfully created

Body

application/json

id*string (uuid)

partnerId*string (uuid)

primaryAccountId*nullable string (uuid)

type*enum

PRIMARYVIRTUAL

currencyCode*enum

Example: "GBP"

AFNEURALLDZDUSDAOAXCDARSAMDAWGAUDAZNBSDBHDBDTBBDBYNBZDXOFBMDINRBTNBOBBOVBAMBWPNOKBRLBNDBGNBIFCVEKHRXAFCADKYDCLPCLFCNYCOPCOUKMFCDFNZDCRCHRKCUPCUCANGCZKDKKDJFDOPEGPSVCERNSZLETBFKPFJDXPFGMDGELGHSGIPGTQGBPGNFGYDHTGHNLHKDHUFISKIDRXDRIRRIQDILSJMDJPYJODKZTKESKPWKRWKWDKGSLAKLBPLSLZARLRDLYDCHFMOPMKDMGAMWKMYRMVRMRUMURXUAMXNMXVMDLMNTMADMZNMMKNADNPRNIONGNOMRPKRPABPGKPYGPENPHPPLNQARRONRUBRWFWSTSTNSARRSDSCRSLLSGDXSUSBDSOSSSPLKRSDGSRDSEKCHECHWSYPTWDTJSTHBTOPTTDTNDTRYTMTUGXUAHAEDUSNUYUUYIUYWUZSVUVVESVNDYERZMWZWLXBAXBBXBCXBDXTSXXXXAUXPDXPTXAGAFAFIMADPESPFRFAOKAORRURATSAYMAZMBYBBYRBECBEFBELBADBRBBRRBGJCYPCSKECSECVGQEEEKXEUGEKDDMDEMGHCGHPGRDGWEITLIEPLVLZALLTLLUCLUFLULMGFMLFMTLMROMZENLGPLZPTEROKSTDCSDSKKSITRHDESAESBSDDSRGTJRTPETRLTMMUAKUSSVEBVEFYUDZRNZMKZWNZWR

createDate*string (date-time)

identifiers*array of PartnerAccountIdentifierResponse (object)

state*PartnerAccountStateResponse (object)

balance*PartnerAccountBalanceResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.algbralabs.com/v1/partner/accounts/virtual', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "parentAccountId": "123e4567-e89b-12d3-a456-426614174000",
      "productCode": "FIAT_ACCOUNT_UK_V1"
    }),
});
const data = await response.json();

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "partnerId": "123e4567-e89b-12d3-a456-426614174000",
  "primaryAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "type": "PRIMARY",
  "currencyCode": "GBP",
  "createDate": "2024-12-21T16:49:11.973Z",
  "identifiers": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "UK_ACCOUNT",
      "beneficiary": "text",
      "bankAddress": "text",
      "data": {
        "type": "UK_ACCOUNT",
        "sortCode": "010102",
        "accountNumber": "12345678"
      },
      "createDate": "2024-12-21T16:49:11.973Z"
    }
  ],
  "state": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "INITIALIZING",
    "lastUpdated": "2024-12-21T16:49:11.973Z",
    "createDate": "2024-12-21T16:49:11.973Z"
  },
  "balance": {
    "currency": "GBP",
    "availableBalance": 0,
    "ledgerBalance": 0,
    "pendingCredits": 0
  }
}