Update Virtual Account

Reactivate an expired single_use virtual account with a new expiry, optionally changing its account name, wallet or amount. All three conditions must hold: the account is single_use, it was provisioned with wema (globus accounts are fixed once created), and it has already expired. Omitted optional fields keep their current values. A supplied wallet_id must belong to the authenticated business.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

reference*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

expires_at*string

New expiry. Must be in the future and within the configured expiry window (24 hours by default).

Formatdate-time

account_name?|

Length3 <= length <= 250

wallet_id?|

Collection wallet the account settles into. Must belong to this business.

amount?|

Fixed amount expected on this account.

Formatfloat

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/virtual-account/update-by-reference/VA_A1B2C3D4E5F6" \  -H "Content-Type: application/json" \  -d '{    "expires_at": "2026-07-21 12:00:00"  }'

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-07-20 09:15:00",
  "message": "Virtual account updated successfully.",
  "statusCode": 200,
  "data": {
    "id": "019a1639-ce25-70b7-ab20-16fcb2bac023",
    "businessId": "019a1639-ce25-70b7-ab20-16fcb2bac024",
    "businessState": "TEST",
    "amount": {
      "value": 5000,
      "currency": "NGN",
      "formatted": "NGN5000"
    },
    "reference": "VA_A1B2C3D4E5F6",
    "walletId": "019a1639-ce25-70b7-ab20-16fcb2bac025",
    "sourceReference": "src_1234567890",
    "accountNumber": "1234567890",
    "accountName": "Acme Store",
    "providerName": "wema",
    "accountType": "single_use",
    "status": "active",
    "currency": "NGN",
    "expiresAt": "2026-07-21 12:00:00",
    "createdAt": "2026-07-20 09:15:00"
  }
}

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-07-20 09:15:00",
  "message": "Virtual account not found.",
  "statusCode": 404
}

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-07-20 09:15:00",
  "message": "Virtual account not found.",
  "statusCode": 404
}

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-07-20 09:15:00",
  "message": "Virtual account not found.",
  "statusCode": 404
}

{
  "requestId": "abcd1234-5678-90ef-ghij-1234567890kl",
  "requestTimestamp": "2026-07-20 09:15:00",
  "message": "Virtual account not found.",
  "statusCode": 404
}

Update Virtual Account

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`