Status e respostas: Possíveis erros de pagamentos
Na tabela abaixo é possível observar quais são os possíveis retornos do campo rejectionReason, dentro do fluxo de consentimento, que pode ser enviado em cada etapa que envolve o consentimento para o fluxo de pagamento:
Etapas do funil de consentimento | Código |
---|---|
Início da autenticação | FALHA_INFRAESTRUTURA, TEMPO_EXPIRADO_AUTORIZAÇÃO |
Conclusão da autenticação | FALHA_INFRAESTRUTURA, TEMPO_EXPIRADO_AUTORIZAÇAO, REJEITADO_USUARIO |
Autorização do cliente | FALHA_INFRAESTRUTURA, CONTAS_ORIGEM_DESTINO_IGUAIS, CONTA_SALARIO, SALDO_INSUFICIENTE, VALOR_ACIMA_LIMITE, QRCODE_INVALIDO |
Código de autorização emitido | FALHA_INFRAESTRUTURA, TEMPO_EXPIRADO_CONSUMO |
E abaixo estão os retornos possíveis para o mesmo campo rejectionReason, mas para a rejeição empresarial do fluxo de pagamento.
Exemplo: SALDO_INSUFICIENTE
Define o código do motivo pelo qual o pagamento foi rejeitado
SALDO_INSUFICIENTE – A conta selecionada não possui saldo suficiente para efetuar o pagamento.
VALOR_ACIMA_LIMITE – O valor ultrapassa o limite estabelecido [na instituição/no convênio/outro] para permitir ao cliente realizar transações.
VALOR_INVALIDO – O valor enviado não é válido para o QR Code informado.
COBRANCA_INVALIDA – Validação de expiração, validação de expiração ou Status Válido.
NAO_INFORMADO – Não informado/identificado pela instituição titular da conta.
PAGAMENTO_DIVERGENTE_CONSENTIMENTO – Dados de pagamento diferentes dos dados de consentimento.
DETALHE_PAGAMENTO_INVALIDO – Parâmetro [nome_campo] não atende regras de negócio.
PAGAMENTO_RECUSADO_HOLDER – [Descrição do motivo da recusa].
PAGAMENTO_RECUSADO_SPI – [Código de erro conforme tabela de domínio PACS.002 motivo].
FALHA_INFRAESTRUTURA – [Descrição de qual falha na infraestrutura inviabilizou o processamento].
FALHA_INFRAESTRUTURA_SPI – Indica falha no Sistema de Pagamento Instantâneo (SPI).
FALHA_INFRAESTRUTURA_DICT – Indica falha no Diretório de Identificadores de Contas Transacionais (DICT).
FALHA_INFRAESTRUTURA_ICP – Indica falha na Infraestrutura de Chave Pública (PKI).
FALHA_INFRAESTRUTURA_PSP_RECEBEDOR – Indica falha na infraestrutura do Prestador de Serviços de Pagamento (PSP) que recebe o pagamento.
FALHA_INFRAESTRUTURA_DETENTORA – indica falha na infraestrutura da instituição detentora das informações ou recursos.
CONTAS_ORIGEM_DESTINO_IGUAIS – Indica uma tentativa de pagamento onde a conta origem e a conta destino são iguais.
FALHA_INFRAESTRUTURA
O motivo de rejeição FALHA_INFRAESTRUTURA não será excluído, apenas deixará de ser utilizado, permitindo assim retrocompatibilidade e integridade entre os participantes.
Caso você utilize "x-rejection-reason" no header da API /api/smart-keys/payment-initiation/v1/consents/callback, com os valores informados abaixo, o Pix assumirá o status “Reject”.
- SALDO_INSUFICIENTE
- VALOR_ACIMA_LIMITE
- VALOR_INVALIDO
- COBRANCA_INVALIDA
- NAO_INFORMADO
- PAGAMENTO_DIVERGENTE_CONSENTIMENTO
- DETALHE_PAGAMENTO_INVALIDO
- PAGAMENTO_RECUSADO_DETENTORA
- PAGAMENTO_RECUSADO_SPI
- FALHA_INFRAESTRUTURA
- CONSENT_EXPIRED
Junto com o status “Reject”, também será apresentado um bloco rejectionReason, conforme exemplo baixo. Além disso, o CONSENT_EXPIRED deixa o consentimento pendente durante 60 minutos e depois o rejeita.
"rejectionReason": {
"code": "NAO_INFORMADO",
"detail": "Não Informado"
}
Updated about 2 months ago