Webhooks de pagamento do desembolso

Pagamento do Desembolso

Os eventos de webhook relacionados ao pagamento do desembolso de uma CCB informam o resultado de uma transação financeira.
O resultado do pagamento do desembolso pode resultar em três possíveis cenários:

• Sucesso
• Falhas ativas
• Falhas passivas

Sucesso do Desembolso

Envio de informações da confirmação de pagamento do desembolso realizado para CCBs enviadas e processadas na Giro.Tech.
São informados os dados do pagamento e as CCBs associadas ao pagamento. Para mais informações, avalie o payload do webhook.

Para cadastrar o envio desses eventos, efetue o cadastro selecionando o tipo de evento SUCESSO_DESEMBOLSO.

⚠️ O evento de sucesso de Desembolso foi revisado e sua estrutura foi atualizada. Caso queira avaliar os dados do evento legado, avalie o payload do webhook v1. Fique tranquilo, será mantida a compatibilidade do fluxo antigo até segundo aviso. Mesmo assim, recomendamos que avalie uma oportunidade para atualizar para a nova versão do evento.

Falhas do Desembolso

Para os cenários de falhas, temos duas categorias:

• Os cenários que vão aguardar uma ação ativa por parte do contratante da CCB, denominados "falhas ativas", onde a CCB originadora do pagamento precisa ser revisada para que o pagamento possa ser efetivado.
• Os cenários em que as informações do pagamento de desembolso foram identificadas como consistentes, mas o pagamento não pôde ser concluído, denominados "falhas passivas".

⚠️ Os eventos de falha são processados de forma isolada. Um evento de falha ativa não será notificado como falha passiva, mesmo que ocorra uma falha na entrega ou se apenas um tipo de falha estiver cadastrado. Em caso de falha no envio de um tipo de evento, não será tentado reenviar como outro tipo de evento. Para garantir que você receba todas as notificações de falha, certifique-se de cadastrar todos os tipos de eventos relacionados a falhas.

Falhas Ativas

Para o cenário de falhas que requerem atuação por parte do contratante, temos a falha no pagamento devido a alguma inconsistência na conta de desembolso informada na formalização de uma CCB. Um exemplo seria a conta informada não pertencer ao favorecido da CCB.

Nesses cenários de falha no pagamento devido à conta de desembolso, é esperado que seja informada uma nova conta para efetuar o pagamento do desembolso dessa CCB. Para efetuar esse processo, deve ser utilizado o fluxo de revisão da conta de desembolso.

Para mais informações, avalie o payload do webhook.

Para cadastrar o envio desses eventos, efetue o cadastro selecionando o tipo de evento REVISAO_DESEMBOLSO.

Falhas Passivas

Essas falhas não requerem uma atuação direta por parte do contratante; elas serão avaliadas pela equipe da Giro.Tech para identificar a melhor resolução para o problema. Poderá ser aplicada uma nova tentativa de pagamento para casos de instabilidades, por exemplo, ou a equipe entrará em contato para identificar alternativas para o pagamento desse desembolso.

Para mais informações, avalie o payload do webhook.

Para cadastrar o envio desses eventos, efetue o cadastro selecionando o tipo de evento FALHA_DESEMBOLSO.