Ao realizar uma requisição de pagamento via Pix, a API da Celcoin retornará um código de status que indica o resultado imediato da transação. Os principais retornos são:
| Status (code) | Descrição | Ação Recomendada |
|---|---|---|
SUCCESS | O pagamento foi processado e liquidado com sucesso no Banco Central. | Transação concluída. O comprovante está disponível. |
SUCCESSFUL_WITH_ERROR | O pagamento foi liquidado com sucesso, mas houve uma falha técnica ao gerar o arquivo do comprovante. | Não reenvie o pagamento. A transação é válida; tente baixar o comprovante novamente via API de consulta. |
ALREADY_PAID | O pagamento foi bloqueado para evitar duplicidade, pois o clientCode ou endToEndId já foi utilizado. | Verifique seu controle interno. O pagamento já existe na base da Celcoin. |
ALREADY_PAID_WITH_ERROR | Similar ao ALREADY_PAID, o sistema identificou uma tentativa duplicada de um pagamento que já foi processado, mas que teve erro na geração do comprovante. | Não reenvie. O recurso já saiu da conta. Consulte o status da transação original. |
📢 Importante: O papel do Webhook
Nos casos de sucesso (SUCCESS ou SUCCESSFUL_WITH_ERROR), o sistema da Celcoin disparará um Webhook de confirmação para a sua URL cadastrada.
Fique atento: O Webhook é a sua garantia final de conciliação. Mesmo que a resposta da API sofra um timeout, o Webhook confirmará se o dinheiro saiu da conta ou se houve algum erro posterior.
🛡️ Segurança contra duplicidade
A Celcoin utiliza o campo clientCode (que você envia) para garantir a idempotência das transações. Se você tentar enviar dois pagamentos com o mesmo clientCode, o segundo será automaticamente rejeitado com o status ALREADY_PAID, protegendo o saldo da sua conta contra cobranças indevidas por cliques duplos ou erros de loop.
Comentários
0 comentário
Artigo fechado para comentários.