v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Virtual Accounts V2

Master Wallet Account Update

patch/v2/wallets/{id}/virtual-accounts/{virtualAccountId}

Path parameters

idstring uuid required

Wallet 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"
  }
}