O que fazer quando uma transferência Pix não é concluída?

Se uma transferência Pix (Cash-out) não foi concluída com sucesso, o primeiro passo é entender se a transação foi rejeitada ou se ela está pendente.

1. Verifique o Status via API 

Utilize o endpoint de Consulta de Status de Pix. Ele é o seu "painel de controle" para saber o que aconteceu nos sistemas da Celcoin e do Banco Central.

• Status REJECTED/ERROR: A transação falhou. O motivo (reason) virá detalhado no JSON.

• Status PENDING: A transação ainda está sendo processada pelo Banco Central ou pelo banco de destino.

2. Causas Comuns de Rejeição

Antes de abrir um chamado, verifique se a falha ocorreu por um destes motivos:

• Saldo Insuficiente: Verifique se sua conta bolsão Celcoin tem saldo disponível no momento exato do envio.

• Dados Incorretos: Chaves Pix inválidas ou dados bancários (agência/conta) que não pertencem ao CPF/CNPJ informado causam rejeição imediata.

• Limites Excedidos: A transação pode ter ultrapassado os limites de segurança (diários ou por transação) configurados para sua conta.

• Erro na Instituição de Destino: O banco do recebedor pode estar com instabilidade momentânea ou a conta de destino pode estar inativa/bloqueada.

3. E se o Webhook não chegou?

Se a consulta via API mostra a transação como SUCCESS, mas você não recebeu o Webhook:

• Confira se o seu servidor está operante e retornando HTTP 200.

• Aguarde o ciclo de retentativas automáticas da Celcoin.

• Use a consulta de status como sua fonte da verdade para atualizar o saldo do seu cliente enquanto o Webhook não chega.

💡 Dica Técnica

Sempre armazene o clientCode que você enviou na requisição inicial. Ele é a chave mais rápida para realizar a consulta de status e entender o motivo exato de uma não conclusão sem precisar de intervenção manual do suporte.

Para saber mais sobre o processo de verificação, consulte nossa documentação de consulta de status.