Transfer amount between virtual accounts
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
400
Insufficient Balance
application/json
403
Forbidden
application/json
422
Validation
application/json
500
Internal Server Error
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"
}