Realizando um saque PIX para uma chave fixa

Este endpoint permite realizar saques PIX para chaves PIX fixas (CPF, CNPJ, EMAIL, PHONE, RANDOM). A operação é processada de forma assíncrona e o status é atualizado via webhooks.

Obs.: O envio deve ser feito para uma conta bancária com o mesmo CPF ou CNPJ do usuário, caso seja conta Cripto. Em contas do tipo Pagamento, você pode enviar de qualquer CPF ou CNPJ.

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

Explicação dos campos:

Campo	Tipo	Obrigatório	Descrição
amount	number	✅	Valor em centavos (mín: 100, máx: 50.000.000)
pixKey	string	✅	Chave PIX destino (deve ser válida para o tipo especificado)
pixKeyType	enum	✅	Tipo da chave PIX (EMAIL, CPF, CNPJ, PHONE, RANDOM)
description	string	❌	Descrição da operação (máx: 500 caracteres)

Tipos de Chave PIX Suportados:

Tipo	Formato	Exemplo
EMAIL	Email válido	`"user@example.com"`
CPF	11 dígitos	`"12345678901"`
CNPJ	14 dígitos	`"12345678000199"`
PHONE	Telefone com DDD	`"11999999999"`
RANDOM	Chave aleatória	`"550e8400-e29b-41d4-a716-446655440000"`

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

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido e ajuste os valores conforme necessário.

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

Explicação da resposta:

Campo	Tipo	Descrição
`status`	string	Status atual da transação (Ex: CONFIRMED, PENDING)
`pixId`	string	ID único da transação PIX no provedor
`transactionId`	string	ID interno da transação no sistema
`e2e`	string	ID End-to-End da transação PIX
`amount`	number	Valor líquido do saque em centavos
`feeAmount`	number	Valor da taxa aplicada em centavos
`totalDebited`	number	Valor total debitado da conta (amount + feeAmount)
`executedAt`	string	Data/hora de execução da transação (ISO 8601)

Status da Transação:

Status	Descrição
PENDING	Transação criada, aguardando processamento
PROCESSING	Transação sendo processada pelo provider
CONFIRMED	Transação confirmada pelo provider
COMPLETED	Transação finalizada com sucesso
FAILED	Transação falhou
CANCELED	Transação cancelada
REFUNDED	Transação reembolsada

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	Valor inválido, saldo insuficiente ou campo obrigatório faltando
401	Unauthorized	Token inválido ou ausente
500	Internal Server Error	Erro interno do serviço

🎯 Como usar o saque PIX

Após receber a resposta, você pode:

Monitorar o status: Verifique o campo status para acompanhar o processamento
Aguardar confirmação: O saque é processado de forma assíncrona
Receber webhook: Configure webhooks para receber atualizações automáticas
Verificar execução: Use o campo executedAt para saber quando foi processado

⏰ Processamento assíncrono

Criação: Transação criada imediatamente com status PENDING
Enfileiramento: Adicionada à fila de processamento
Processamento: Provider processa a transação
Webhook: Status atualizado via webhook do provider
Finalização: Transação marcada como COMPLETED ou FAILED

🛡️ Limitações e restrições

✅ FAÇA:

Use valores entre R$ 1,00 (100 centavos) e R$ 500.000,00 (50.000.000 centavos)
Verifique se tem saldo suficiente + taxas
Use chaves PIX válidas e pertencentes ao usuário
Configure webhooks para receber atualizações

❌ NÃO FAÇA:

Usar valores fora dos limites permitidos
Tentar saques sem saldo suficiente
Usar chaves PIX de outros usuários
Ignorar o processamento assíncrono

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se o valor está dentro dos limites (R$ 1,00 a R$ 500.000,00)
Confirme se tem saldo suficiente
Verifique se a chave PIX é válida

“O saque não está sendo processado!”

Verifique se a chave PIX pertence ao usuário
Confirme se o status não está como FAILED
Aguarde o processamento assíncrono

“Erro 401!”

Verifique se o token de autenticação é válido
Faça uma nova autenticação se necessário

📞 Suporte

Se nada funcionar:

Verifique os valores e limites
Confirme a autenticação está válida
Entre em contato com nossa equipe de suporte

Mais informações sobre esse endpoint:

Acesse aqui