Set Default

Set Default

post

This endpoint sets a specific virtual bank account as the default account for your merchant, allowing automatic receipt of 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}}

Responses

200

Success

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post

HTTPcURLJavaScriptPython

POST /banking/v1/virtual-accounts/{virtual_account_id}/set-default HTTP/1.1
Host: api.aurixpay.ws
X-API-Key: text
Accept: */*

{
  "success": true,
  "message": "Virtual account set as default successfully.",
  "data": {
    "id": "01977a5b-274d-705f-a889-2b03137cb838",
    "merchant_id": "01977f6d-5c06-7228-86f6-f4fc01305143",
    "currency": "BRL",
    "balance": 150000,
    "type": "merchant",
    "bank_account_id": "01977f6d-5c06-7228-86f6-f4fc01305143",
    "label": "Main Account",
    "status": "active",
    "is_default": true,
    "created_at": "2025-01-15T10:30:00.000000Z",
    "updated_at": "2025-01-15T12:45:00.000000Z",
    "deleted_at": null,
    "merchant": {
      "id": "01977f6d-5c06-7228-86f6-f4fc01305143",
      "name": "Example Company LTDA"
    },
    "bank_account": {
      "id": "01977f6d-5c06-7228-86f6-f4fc01305143",
      "account_number": "12345678",
      "bank_code": "001"
    }
  }
}