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 consentimentoCódigo
Início da autenticaçãoFALHA_INFRAESTRUTURA, TEMPO_EXPIRADO_AUTORIZAÇÃO
Conclusão da autenticaçãoFALHA_INFRAESTRUTURA, TEMPO_EXPIRADO_AUTORIZAÇAO, REJEITADO_USUARIO
Autorização do clienteFALHA_INFRAESTRUTURA, CONTAS_ORIGEM_DESTINO_IGUAIS, CONTA_SALARIO, SALDO_INSUFICIENTE, VALOR_ACIMA_LIMITE, QRCODE_INVALIDO
Código de autorização emitidoFALHA_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"
      }