Como funciona e qual o prazo de devolução de um recebimento Pix?

A devolução é o recurso que permite estornar, total ou parcialmente, um valor que entrou em sua conta Celcoin. Esse processo é instantâneo e segue as normas do Banco Central para o arranjo Pix.

⏲️ Prazos e Regras Principais

• Prazo Máximo: Você pode iniciar uma devolução em até 90 dias após a data do recebimento original.

• Valor: A devolução pode ser do valor total ou parcial. Você pode realizar múltiplas devoluções parciais, desde que a soma delas não ultrapasse o valor da transação original.

• Velocidade: Assim como o pagamento, a devolução é liquida de forma instantânea na conta de quem enviou o Pix originalmente.

🛠️ Como realizar a devolução via API

Para automatizar as devoluções, sua aplicação precisa estar preparada para capturar os dados do recebimento.

1. O papel do Webhook

A forma mais eficiente de gerir recebimentos é através do webhook RECEIVEPIX.

• Ao receber um Pix, a Celcoin envia uma notificação para sua URL cadastrada.

• Dentro dessa notificação, você encontrará o campo transactionId. Este é o "ID mestre" que vincula o dinheiro à transação original e é obrigatório para processar o estorno.

2. Chamada de Devolução

Com o transactionId em mãos, utilize o endpoint de Devolução de Recebimento Pix preenchendo os seguintes campos:

• transactionId: O identificador da transação original recebido via webhook ou consulta.

• amount: O valor exato que deseja devolver.

• transactionIdentification: Um código único gerado por você para identificar esta solicitação de estorno (evita duplicidade).

• reason: Código que indica o motivo (ex: desistência do cliente, valor incorreto).

• additionalInformation: Um texto livre explicando o motivo, que aparecerá no extrato do recebedor.

📑 Checklist de Segurança

• Saldo em Conta: Certifique-se de que a conta possui saldo disponível suficiente para cobrir o valor da devolução no momento da chamada.

• Origem: Lembre-se que a devolução só pode ser feita para a mesma conta que originou o pagamento inicial. Não é possível devolver um Pix para uma chave ou conta diferente através deste endpoint.