Update Virtual Account

Update Virtual Account

put

This endpoint updates the configuration of an existing virtual account, allowing you to modify the destination bank account for automatic payments from sales.

scope: virtual-accounts.write

Path parameters

virtual_account_idstring · uuidRequiredExample: 01977a5b-274d-705f-a889-2b03137cb838

Header parameters

Content-TypestringOptionalExample: application/json

X-API-KeystringRequiredExample: {{API_KEY}}

Body

application/json

labelstringOptional

Responses

200

Success

application/json

400

Not Found

application/json

403

Forbidden

application/json

422

Validation

application/json

500

Internal Server Error

application/json

put

HTTPcURLJavaScriptPython

PUT /banking/v1/virtual-accounts/{virtual_account_id} HTTP/1.1
Host: api.aurixpay.ws
X-API-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "label": "Main Virtual Account 2"
}

{
  "id": "01977a5b-274d-705f-a889-2b03137cb838",
  "merchant_id": "019764e0-4ab4-706a-b399-9c3d541689a3",
  "currency": "BRL",
  "balance": 0,
  "type": "merchant",
  "bank_account_id": "01976540-f21b-72b2-acf0-f0005d032d6f",
  "label": "Main Virtual Account 2",
  "status": "active",
  "is_default": true,
  "created_at": "2025-06-16T20:08:03.000000Z",
  "updated_at": "2025-06-16T20:14:16.000000Z",
  "deleted_at": null,
  "merchant": {
    "id": "019764e0-4ab4-706a-b399-9c3d541689a3",
    "name": "Aurix"
  },
  "bank_account": {
    "id": "01976540-f21b-72b2-acf0-f0005d032d6f",
    "account_number": "123456",
    "bank_code": "001"
  }
}