v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Virtual Accounts V2

Child Address Account Update

patch/v2/wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}

Path parameters

walletIdstring uuid required

Wallet identifier.

addressIdstring uuid required

Child address identifier.

virtualAccountIdstring uuid required

Virtual account identifier.

Request body

isActiveboolean required

Set false to deactivate or true to reactivate the virtual account.

codestring

passkeyResponseobject

Response

Successful response.

statusCodeinteger required

messagestring required

Human-readable result.

Example response

{
  "statusCode": 200,
  "message": "Virtual account fetched successfully",
  "data": {
    "id": "3e8fcd73-4067-4386-8c1e-9929e6a768d7",
    "reference": "va_01J2X8JQ4V9N0P7K2M6C3F5R8T",
    "accountNumber": "0123456789",
    "accountName": "Acme Ltd / Ada Okafor",
    "bankName": "Example Bank",
    "bankCode": "999",
    "currency": "NGN",
    "assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
    "providerId": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
    "isActive": true,
    "status": "active",
    "type": "AUTO_FUNDING",
    "label": "Ada collection account",
    "createdAt": "2026-07-19T12:30:00.000Z",
    "updatedAt": "2026-07-19T12:30:00.000Z"
  }
}