Transfer amount between virtual accounts

Transfer amount between virtual accounts

post

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

/banking/v1/virtual-accounts/transfer

This endpoint allows you to transfer funds from one virtual account to another, either within your own business or to another user on the platform.

scope: virtual-accounts.transfer

Header parameters

AcceptstringOptionalExample: application/json

Content-TypestringOptionalExample: application/json

X-API-KeystringRequiredExample: {{API_KEY}}

Body

application/json

amountintegerRequired

descriptionstringRequired

external_idstringRequired

from_virtual_account_idstringRequired

to_virtual_account_idstringRequired

Responses

200

Success

application/json

400

Insufficient Balance

application/json

403

Forbidden

application/json

422

Validation

application/json

500

Internal Server Error

application/json

post

/banking/v1/virtual-accounts/transfer

HTTP

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

{
  "amount": 10,
  "description": "description pix",
  "external_id": "external_id2",
  "from_virtual_account_id": "01976559-1fdf-7093-8d5c-2a54ac47a83b",
  "to_virtual_account_id": "01976540-f222-718d-97f6-335f6aef1db4"
}

{
  "success": true,
  "data": {
    "transaction_id": "01977f48-446c-7015-b4f0-3244720f605b",
    "amount": 10,
    "status": "approved",
    "reference": "external_id2",
    "from_virtual_account_id": "01976559-1fdf-7093-8d5c-2a54ac47a83b",
    "to_virtual_account_id": "01976540-f222-718d-97f6-335f6aef1db4",
    "created_at": "2025-06-17T19:05:32.000000Z"
  },
  "message": "Transfer completed successfully"
}