Transfer amount between virtual accounts

Transfer amount between virtual accounts

post

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
X-API-KeystringRequiredExample: {{API_KEY}}
Body
amountintegerRequired
descriptionstringRequired
external_idstringRequired
from_virtual_account_idstringRequired
to_virtual_account_idstringRequired
Responses
200

Success

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

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