Transferir valor entre contas virtuais

post

Este endpoint permite transferir fundos de uma conta virtual para outra, seja dentro do seu próprio negócio ou para outro usuário na plataforma.

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

Sucesso

application/json

400

Saldo Insuficiente

application/json

403

Proibido

application/json

422

Validation

application/json

500

Erro Interno do Servidor

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

PreviousTransferência NextDocumentos