Possíveis Erros de Pagamento

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

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

"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_"
  }
}