Principais dúvidas sobre o fluxo dos callbacks
Listamos abaixo algumas das principais dúvidas e exemplos práticos do envio dos callbacks para os casos de recebimento de uma notificação:
Qual callback é enviado quando ocorre o recebimento de uma notificação?
O primeiro terá o status de OPEN e o segundo o status de AMOUNT_BLOCKED, informando que o valor foi bloqueado.
Qual seria a forma de saber que a notificação recebida foi dada pelo seu PSP como "Procede"?
Para esse cenário vamos ter um callback referente ao fechamento da notificação e o valor continua bloqueado.
O callback referente ao fechamento de notificação de infração, terá os seguintes parâmetros:
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"CLOSED"
Qual seria a forma de saber que a notificação recebida foi dada pelo seu PSP como "Não Procede"?
Nesse cenário, você terá o valor desbloqueado e o envio de dois callbacks.
O primeiro informando o fechamento da notificação (mesmo do procede) e um segundo informando o desbloqueio.
Primeiro callback informa que a notificação foi fechada, sendo o mesmo do procede:
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"CLOSED"
Segundo callback informa o desbloqueio do valor. Essa vai ser a diferença em comparação com o procede.
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"AMOUNT_RELEASE"
"totalAmount":0
Obs: No callback de desbloqueio o campo totalAmount tem o valor zerado.
Qual seria a forma de saber que a sua conta recebeu uma solicitação de devolução por fraude, após o "Procede" da notificação, e que o dinheiro saiu de sua conta?
O valor será desbloqueado da conta do cliente e será realizada uma devolução PIX com a retirada do dinheiro.
Para esse cenário vão ser enviados 3 callbacks.
O primeiro para notificar o desbloqueio, o segundo para notificar a devolução do PIX e um terceiro e último com a notificação da abertura de devolução já realizada:
Primeiro callback (Referente ao desbloqueio)
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"AMOUNT_RELEASE"
"totalAmount":0
Obs: No callback de desbloqueio o campo totalAmount tem o valor zerado.
Segundo callback (Referente a devolução PIX, indica que o dinheiro saiu da conta)
"callbackType":"WITHDRAW_INSTANT_PAYMENT_RETURN"
"status":"Approved"
"receivedAmount":7.95
Terceiro callback (Referente a notificação de devolução que foi aberta)
"callbackType":"MED"
"infractionType":"FRAUD"
"status":"OPEN"
"totalAmount":7.95
Obs: No callback de devolução, o infractionType vai ser o motivo informado no cadastro da devolução.
Caso o recebimento do MED seja por falha operacional e não por fraude, o fluxo é o mesmo?
Nesse caso o fluxo se mantém o mesmo porém o infractionType será OPERATIONAL_FLAW
"callbackType": "MED",
"infractionType": "OPERATIONAL_FLAW",
"status": "OPEN",
"description": "Falha operacional",
Caso a notificação seja cancelada existe alguma alteração no fluxo do callback?
Caso ocorra o cancelamento da notificação, ocorrerá a notificação via callback informando o status de CANCELLED e o desbloqueio dos valores.
Primeiro callback (Referente ao cancelamento)
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"CANCELLED"
"totalAmount":0
Segundo callback (Referente ao desbloqueio de saldo)
"callbackType":"MED"
"infractionType":"REFUND_REQUEST"
"status":"AMOUNT_RELEASE"
"totalAmount":0
Como fazer a abertura de um MED pela Flagship?
Para solicitar a abertura de um MED, basta abrir um chamado no portal, fornecendo o máximo de informações possíveis sobre o ocorrido e anexando o Boletim de Ocorrência, além da identificação da transação. Após isso, nossa equipe realizará uma análise para verificar se a solicitação se enquadra em um cenário de MED e procederá com a abertura do pedido.
Qual o prazo de análise e devolução após a abertura da notificação?
A instituição recebedora tem o prazo de até 7 dias para realização da análise e julgamento, em caso de procedente, tem o prazo de mais 3 dias para realização da devolução caso haja saldo preservado na conta.
Qual seria a forma de saber que, após uma solicitação de devolução aberta, o dinheiro caiu em sua conta?
Nesse cenário o cliente receberá uma deposit instant payment, referente a devolução pix.
Serão enviados dois callbacks. O primeiro com a notificação da abertura de devolução e o segundo para notificar o deposito.
Primeiro callback (Referente a abertura de devolução)
"callbackType":"MED"
"infractionType":"FRAUD"
"status":"OPEN"
"endToEndId":"E12109247202112281220zsdONQvYZxy"
"totalAmount":5.95
Obs: No callback de devolução, o infractionType vai ser o motivo informado no cadastro da devolução.
Segundo callback (Uma deposit referente a devolução PIX, nesse momento o dinheiro caiu na conta do cliente)
"callbackType":"DEPOSIT_INSTANT_PAYMENT"
"status":"Approved"
"receivedAmount":5.95