Boa tarde @jp3dr tudo certo?
Em relação ao cartão essas informações são informadas no momento da criação da cobrança. Nesse momento ocorre a análise imediata e o retorno da API já inclui um campo com motivo de recusa se for o caso
Exemplo:
js
{
"code": 200, // retorno HTTP "200" informando que o pedido foi bem sucedido
"data": {
"installments": 1, // número de parcelas em que o pagamento deve ser dividido
"installment_value": 5990, // valor da parcela. Por exemplo: 8900 (equivale a R$ 89,00)
"charge_id": numero_charge_id, // número da ID referente à transação gerada
"status": "unpaid", // Indica que o pagamento foi reprovado.
"refusal": {
"reason": "Sistema de segurança: Os dados e comportamentos de utilização do cartão se assemelham a práticas e cenários de alto risco para pagamentos online. Utilize outro cartão ou outro meio de pagamento.", // Mensagem que contém o motivo da recusa da transação.
"retry": true // Indica se é possível tentar novamente a transação.
},
"total": 5990, // valor, em centavos. Por exemplo: 8900 (equivale a R$ 89,00)
"payment": "credit_card" // forma de pagamento associada à esta transação ("credit_card" equivale a "cartão de crédito")
}
}
Em relação ao Pix:{
"code": 200, // retorno HTTP "200" informando que o pedido foi bem sucedido
"data": {
"installments": 1, // número de parcelas em que o pagamento deve ser dividido
"installment_value": 5990, // valor da parcela. Por exemplo: 8900 (equivale a R$ 89,00)
"charge_id": numero_charge_id, // número da ID referente à transação gerada
"status": "unpaid", // Indica que o pagamento foi reprovado.
"refusal": {
"reason": "Sistema de segurança: Os dados e comportamentos de utilização do cartão se assemelham a práticas e cenários de alto risco para pagamentos online. Utilize outro cartão ou outro meio de pagamento.", // Mensagem que contém o motivo da recusa da transação.
"retry": true // Indica se é possível tentar novamente a transação.
},
"total": 5990, // valor, em centavos. Por exemplo: 8900 (equivale a R$ 89,00)
"payment": "credit_card" // forma de pagamento associada à esta transação ("credit_card" equivale a "cartão de crédito")
}
}
Nossa API segue os padrões estabelecidos pelo BACEN para consumo e retorno das informações.
E atualmente esses padrões estabelecem que só é disparado webhook quando a cobrança é de fato paga. No caso de expiração não é disparado nenhuma informação.
Dessa forma, sempre que receber o acionamento do webhook é que de fato o pagamento ocorreu.
Entretanto, ao https://dev.efipay.com.br/docs/api-pix/cobrancas-imediatas#consultar-cobrança">consultar uma cobrança Pix, você consegue visualizar o status atual dessa cobrança.
Os status possíveis para uma cobrança Pix são:
- ATIVA: A cobrança foi gerada com sucesso e está apta para pagamento.
- CONCLUÍDA: A cobrança foi gerada com sucesso e já está paga.
- REMOVIDA_PELO_USUARIO_RECEBEDOR: A cobrança foi gerada com sucesso, mas foi removida pelo usuário recebedor.
- REMOVIDA_PELO_PSP: A cobrança foi gerada com sucesso, mas foi removida pelo PSP.
A gestão de cobranças expiradas deve ser feita pelo próprio sistema do cliente, de acordo com o tempo de expiração que ele definiu para cada cobrança.