Informações Gerais - Webhook - v1.0.0-rc.2
- Diego Augusto Amorim Santos Camurri
Nessa sessão será possível encontrar orientações sobre quais eventos de resposta que a detentoras de conta devem repassar para iniciadora de pagamentos referente ao processamento de um pagamento na máquina de estado do pagamento: Consentimento e na máquina de estado do pagamento: Arranjo Pix na adoção do Webhook.
Obrigatoriedade do Webhook
Adoção do Webhook pelas instituições e para o ecossistema geram diversos benefícios, quando relacionados ao número de chamadas gerando otimização do ecossistema do Open Finance Brasil.
A implementação da funcionalidade das notificações por Webhook é:
Obrigatória para as detentoras de conta
Opcional para as iniciadoras de pagamento. Quando a iniciadora optar por implementar as notificações por Webhook deverá realizar o cadastro da URL no diretório central e demais procedimentos detalhados no guia do diretório.
Notificação sobre consentimento: POST /payments/[Versão da API]/consents/{consentId}
Os eventos que acionarão notificações na máquina de estados do consentimento do pagamento serão os status REJECTED e CONSUMED.
Notificação sobre pagamento: POST /payments/[Versão da API]/pix/payments/{paymentId}
Os eventos que acionarão as notificações via Webhook na máquina de estados pagamento: Arranjo Pix da API de Iniciação de Pagamentos serão: ACSC, RJCT, CANC, PATC, PDNG e SCHD.
Notificações do Webhook
O consumo de informações pelos participantes do Open Finance Brasil é feito através de diversas consultas (polling), onde um participante busca avaliar se houve alguma atualização no estado de um recurso, dessa maneira eleva-se de forma significativa o consumo da infraestrutura das instituições participantes do Open Finance Brasil.
No diagrama de exemplo abaixo, é possível identificar como será o comportamento da Iniciadora de pagamentos no processo de consulta de um pagamento.
A detentora de contas envia uma notificação à instituição iniciadora de pagamento informando que ocorreu uma mudança significativa da máquina de status da API e que a mesma deverá consultar o pagamento para obter mais informações.
Exemplo:
Premissas
O payload será composto pela informação do timestamp do momento da alteração da situação do pagamento;
A detentora de conta deve encaminhar o paymentId para iniciadora pela URL.
Em caso de falha de notificação
Detentora
A detentora de conta fará no máximo 3 tentativas de notificação:
A primeira tentativa de notificação do evento, pela detentora de conta, deverá ocorrer em até 1,5 segundo após o evento;
A segunda e a terceira tentativas só ocorrerão em caso de falha;
A segunda tentativa deverá ocorrer 10 segundos após a falha da primeira tentativa;
A terceira tentativa deverá ocorrer 60 segundos após a falha da segunda tentativa.
ITP
A iniciadora de pagamentos, ao perceber que não está recebendo as notificações oriundas da detentora de contas, poderá utilizar os endpoints de consulta para obter informações sobre o andamento de uma determinada transação do consentimento e/ou pagamento.