Skip to main content
O endpoint POST /v1/pix/out/transfer realiza uma transferência PIX a partir do saldo da sua conta.
O cabeçalho X-Idempotency-Key é obrigatório. Ele garante que a mesma requisição nunca seja processada duas vezes — se você reenviar a mesma chave, a transferência já criada é retornada.

​
Criar a transferência

curl -X POST 'https://api.avanttifinance.com/v1/pix/out/transfer' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'X-Idempotency-Key: transfer_20241201_001' \
  -d '{
    "pixKey": "brunoribeirovale@gmail.com",
    "amount": 300,
    "password": "111111"
  }'
​
amount
integer
required
Valor da transferência em centavos (300 = R$ 3,00).
​
password
string
required
Senha transacional de 6 dígitos.
​
pixKey
string
Chave PIX de destino (email, telefone, CPF/CNPJ ou aleatória).
​
X-Idempotency-Key
string
required
Chave única por transferência.

​
Resposta

{
  "success": true,
  "data": {
    "id": "clxyz123abc",
    "status": "pending_analysis",
    "amount": 300
  }
}

​
Consultar um saque

Use GET /v1/transfers/{transfer_id} para verificar o status de uma transferência. 
curl --request GET \
  --url 'https://api.avanttifinance.com/v1/transfers/SEU_TRANSFER_ID' \
  --header 'Authorization: Bearer SEU_TOKEN'

​
Resposta

{
  "success": true,
  "data": {
    "amount": 300,
    "createdAt": "2026-06-16T12:00:00.000Z",
    "pixKey": "brunoribeirovale@gmail.com",
    "status": "completed"
  }
}

​
Status possíveis

pending, queued, processing, pending_analysis, banking_processing, banking_refused, banking_error, manual_analysis, canceled, refused, completed, error.