Update Virtual Account

Update Virtual Account

put

https://api.aurixpay.wshttps://sandbox.api.aurixpay.ws

/banking/v1/virtual-accounts/{virtual_account_id}

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

AcceptstringOptionalExample: application/json

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

/banking/v1/virtual-accounts/{virtual_account_id}

HTTP

PUT /banking/v1/virtual-accounts/01977a5b-274d-705f-a889-2b03137cb838 HTTP/1.1
Host: api.aurixpay.ws
X-API-Key: text
Content-Type: application/json
Accept: application/json

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