Realizando um saque PIX para uma chave fixa

Este endpoint permite realizar saques PIX para chaves externas pré-existentes (CPF, CNPJ, EMAIL, PHONE ou RANDOM). A operação é processada de forma assíncrona para garantir a segurança e a liquidação correta, com atualizações enviadas via webhooks.

[!IMPORTANT] ⚠️ Regras de Titularidade:

Contas Cripto: O envio deve ser feito obrigatoriamente para uma conta bancária com o mesmo CPF ou CNPJ do titular da conta Ether.
Contas de Pagamento: É permitido enviar para qualquer CPF ou CNPJ de terceiros.

📍 Endpoint

POST https://api.etherglobalassets.com/pix/withdraw/pix-key

🧾 Cabeçalhos obrigatórios (Headers)

Cabeçalho	Valor	Descrição
`Authorization`	`Bearer <token>`	Token JWT de autenticação.
`Content-Type`	`application/json`	Formato do corpo da requisição.

🧰 Corpo da Requisição (JSON)

{
  "amount": 10000,
  "pixKey": "user@example.com",
  "pixKeyType": "EMAIL",
  "description": "Saque PIX para conta pessoal",
  "favoritePixKey": false
}

Explicação dos campos:

Campo	Tipo	Obrigatório	Descrição
`amount`	number	✅	Valor em centavos (Mín: `100`
`pixKey`	string	✅	Chave PIX de destino.
`pixKeyType`	enum	✅	Tipo da chave (`EMAIL`, `CPF`, `CNPJ`, `PHONE`, `RANDOM`).
`description`	string	❌	Descrição que aparecerá no extrato do recebedor (Max 500 chars).
`favoritePixKey`	boolean	❌	Salvar esta chave PIX como favorita após a transferência.

📌 Exemplo com curl

curl https://api.etherglobalassets.com/pix/withdraw/pix-key \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 10000,
    "pixKey": "user@example.com",
    "pixKeyType": "EMAIL",
    "description": "Saque PIX para conta pessoal"
  }'

✅ Resposta esperada (HTTP 200 - OK)

{
  "status": "CONFIRMED",
  "pixId": "p1x2i3d4-e5f6-7890-abcd-ef1234567890",
  "transactionId": "t1r2a3n4-s5a6-c7t8-i9o0-n1i2d3e4f5g6",
  "e2e": "E12345678920260114141322873459636",
  "amount": 500,
  "feeAmount": 1,
  "totalDebited": 501,
  "executedAt": "2026-01-14T14:13:24.000Z"
}

Entendendo a Resposta:

status: Situação imediata da transação.
totalDebited: O valor total que será retirado do seu saldo (amount + feeAmount).
e2e: Identificador único da transação no Banco Central (útil para suporte).

📊 Status da Transação

Status	Descrição
`PENDING`	⏳ Criada e aguardando processamento.
`PROCESSING`	⚙️ Sendo enviada ao Banco Central.
`CONFIRMED`	✅ Sucesso! Valor enviado ao destino.
`FAILED`	❌ Falha (ex: chave inválida ou problema no banco destino).
`REFUNDED`	🔄 Valor devolvido ao seu saldo original.

⚠️ Possíveis erros

Código	Erro	Causa comum
`400`	Bad Request	Saldo insuficiente, valor fora dos limites ou chave inválida.
`401`	Unauthorized	Token inválido ou expirado.
`500`	Internal Server Error	Falha de comunicação com o provedor bancário.

🛡️ Limitações e Boas Práticas

✅ FAÇA:

Verifique se o saldo disponível em conta cobre o valor do saque + as taxas.
Monitore o status via webhooks para saber exatamente quando a transação for concluída.
Utilize o campo description para facilitar a conciliação do seu lado.

❌ NÃO FAÇA:

⚠️ Tentar saques de titularidade diferente em contas do tipo Cripto (isso causará estorno).
Enviar valores abaixo de R$ 1,00 ou acima de R$ 500.000,00 por operação.

Suporte Técnico

Caso a transação fique em PROCESSING por mais de 30 minutos, entre em contato via suporte@etherglobalassets.com.br enviando o transactionId.

Criando um PIX dinâmico para depósito na conta

Realizando um saque PIX via QR Code