Create Virtual Account

Create Virtual Account

post

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

/banking/v1/virtual-accounts

This endpoint allows you to register a new virtual bank account where customer payments will be deposited automatically.

scope: virtual-accounts.write

Header parameters

AcceptstringOptionalExample: application/json

Content-TypestringOptionalExample: application/json

X-API-KeystringRequiredExample: {{API_KEY}}

Body

application/json

currencystringRequired

bank_account_idstringRequired

labelstringRequired

Responses

201

Success

application/json

403

Forbidden

application/json

422

Validation

application/json

500

Internal Server Error

application/json

post

/banking/v1/virtual-accounts

HTTP

POST /banking/v1/virtual-accounts HTTP/1.1
Host: api.aurixpay.ws
X-API-Key: text
Content-Type: application/json
Accept: application/json

{
  "currency": "BRL",
  "bank_account_id": "01976540-f21b-72b2-acf0-f0005d032d6f",
  "label": "api teste 1"
}

{
  "merchant_id": "019764e0-4ab4-706a-b399-9c3d541689a3",
  "currency": "BRL",
  "bank_account_id": "01976540-f21b-72b2-acf0-f0005d032d6f",
  "label": "api teste 1",
  "type": "merchant",
  "status": "active",
  "is_default": false,
  "id": "01977a5b-274d-705f-a889-2b03137cb838",
  "updated_at": "2025-06-16T20:08:03.000000Z",
  "created_at": "2025-06-16T20:08:03.000000Z"
}