Na tabela abaixo é possível observar quais são os possíveis retornos do campo Rejection Reason , dentro do fluxo de consentimento, que pode ser enviado em cada etapa envolvida com 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.
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 rejeita.
"rejectionReason": { "code": "NAO_INFORMADO", "detail": "Não Informado" }
Jornada expirada por timeout ou cancelada pelo usuário
A partir desta atualização do produto, você conta com o cenário de expiração da jornada whitelabel, na qual um usuário que tenha cancelado o fluxo, antes de ser redirecionado para a instituição de confirmação da operação, ou ultrapasse o timeout de geração do token, tente retornar para a mesma jornada que foi gerada (mesmo JourneyID). Uma tela de erro é apresentada, conforme o exemplo abaixo, e o usuário é redirecionado para o mesmo endpoint cadastrado no campo URL de Redirect, em sua aplicação.
Exemplo de retorno sobre evento de cancelamento da jornada, no webhook
{ "event": "journey:cancel", "eventDate": "2023-11-22T18:55:54.335Z", "data": { "journeyId": "FlxcMSUD4q_tTiCipuCOrSwfBKhbUP0_" } }
Exemplo de retorno sobre evento de expiração da jornada, no webhook
{ "event": "journey:expired", "eventDate": "2023-11-22T18:55:54.335Z", "data": { "journeyId": "FlxcMSUD4q_tTiCipuCOrSwfBKhbUP0_" } }