PayZu PaymentsReferência de códigos

Programa de retentativa das bandeiras


Nesta páginaLimites e tarifasRecusas reversíveis e irreversíveisBloqueio da retentativaMastercardExcessive AttemptsMerchant Advice Code Transaction Excellence (MAC)VisaEloRegras de cobrançaDemais bandeiras

Siga as regras de cada bandeira para tentar de novo uma compra negada no mesmo cartão e evite as tarifas por excesso de tentativas.

Uma transação negada pode ser tentada de novo com o mesmo cartão, e cada nova tentativa é uma retentativa. As compras com cartão presente ou não presente e as validações de cartão (Zero Auth) seguem as regras de retentativa das bandeiras.

Limites e tarifas

Cada bandeira define os próprios valores e a quantidade de tentativas permitidas antes de cobrar tarifa, com regras diferentes para cartão presente e cartão não presente, como nas vendas online.

Recusas reversíveis e irreversíveis

O mercado de meios de pagamento, com a ABECS, padronizou os códigos de resposta das transações recusadas com cartão e classificou as recusas em dois tipos.

Irreversível: não tente de novo. Esse tipo de recusa indica que o cartão está cancelado, foi perdido ou roubado, há uma fraude confirmada ou a transação não é permitida para o produto específico. Se uma tentativa de autorização ocorrer após uma recusa irreversível, sem alteração de qualquer dado na solicitação, a transação continuará a ser negada.

Reversível: a retentativa é permitida. Neste caso, o emissor pode, eventualmente, aprovar a transação, mas não o faz naquele momento, devido a problemas temporários como falha no sistema, falta de limite disponível, suspeita de fraude ou um número excessivo de tentativas incorretas de digitação da senha.

Bloqueio da retentativa

O PayZu Payments bloqueia a nova tentativa com um cartão que o emissor recusou em definitivo, ou antes do prazo que ele deu, para que a sua conta não pague a tarifa da bandeira. O bloqueio vale para o mesmo cartão na mesma conta. A tentativa bloqueada responde 422 e não cria cobrança nem chega ao emissor.

No pagamento negado, creditCardPayment.retryAllowed e creditCardPayment.retryAfter dizem o tipo da recusa. Os dois vêm na criação e na consulta por id, e são null quando o pagamento não foi negado.

RecusaretryAllowedretryAfterNova tentativaBloqueio
Definitivafalsenull422 com PZ202; details traz chargeId, returnCode e deniedAt da recusa30 dias
Com prazotrueA data do prazo422 com PZ203; a mensagem traz a data e a hora de Brasília, e details, chargeId, returnCode e retryAfterAté retryAfter
ComumtruenullVai ao emissorNão há
BandeiraRecusa definitivaRecusa com prazo
Visa04, 07, 14, 41, 43, 46, 57, R0, R1 e R3
MastercardMAC 03, 21, 40 e 41, com qualquer código; os códigos 01, 04, 14, 41, 43 e 62, quando o MAC não dá prazoMAC 02 (72 horas), com qualquer código; MAC 24 a 30 (de 1 hora a 10 dias), só com o código 51
Elo12, 41, 43, 46, 56 e 57
Qualquer bandeiraNR (30 dias) e RP (72 horas)

Só entram as recusas do emissor no crédito com cartão não presente. Códigos de senha, saque, função, chip, valor e parcela ficam de fora, assim como as recusas da própria adquirente. Código fora da tabela não bloqueia, mas a nova tentativa continua contando nos limites da bandeira, descritos abaixo.

Mastercard

A bandeira Mastercard possui o programa Transaction Processing Excellence (TPE), que engloba duas categorias:

  1. Excessive Attempts: monitora as retentativas de transações negadas nos ambientes de cartão presente e cartão não presente. Válido tanto para códigos de negadas reversíveis quanto irreversíveis.

  2. Merchant Advice Code Transaction Excellence (MAC): monitora as retentativas de transações negadas, nos ambientes de cartão não presente e que são irreversíveis. Haverá cobrança somente nos MACs 03 e 21.

Excessive Attempts

São cobranças efetuadas quando o estabelecimento comercial excede as regras de retentativas de transações.

A bandeira também realiza o monitoramento para qualquer autorização de valor nominal, aprovada, com estorno subsequente para transações abaixo de 1 unidade de moeda inteira ou o equivalente a US$ 1.

O monitoramento é aplicado para as retentativas de transações de compras negadas e aprovadas, realizadas em ambiente de cartão presente e cartão não presente.

Tabela Excessive Attempts

CategoriasCódigosVigênciaTarifa DomésticaTarifa InternacionalQuando OcorrePermitido Retentar
Cartão presente e cartão não presenteQualquer código de negativa que não está atribuído ao MAC 03 e 21. E também os códigos MAC caso não respeite os limites do “Excessive Attempts"Até 31/01/2023R$ 2,00*A partir 11ª retentativaPermitido retentar em 24h.
Cartão presente e cartão não presenteQualquer código de negativa que não está atribuído ao MAC 03 e 21. E também os códigos MAC caso não respeite os limites do “Excessive Attempts"Nova regra a partir de 01/02/2023R$ 2,00*A partir 8ª retentativaPermitido retentar em 24h.
  • Serão consideradas como retentativas todas as transações de pagamento no mesmo cartão, e mesmo número de estabelecimento;
  • A Mastercard prorrogou a data de vigência para o dia 01/02/2023 referente as novas regras do programa (Excessive Attempts) antes prevista para início do dia 01/11/2022. Confira as mudanças:
  1. O excesso considerado no programa ocorrerá a partir da oitava retentativa dentro do mês de apuração; os valores cobrados sofreram alteração.
  2. E a Mastercard também está introduzindo um limite de 35 tentativas negadas no mesmo cartão e mesmo número de estabelecimento por período contínuo de 30 dias. Mesmo se a loja não ultrapassar o limite de sete retentativas no período de 24h, mas ultrapassar a quantidade do limite mensal, a cobrança será aplicada.

Merchant Advice Code Transaction Excellence (MAC)

São cobranças efetuadas quando o estabelecimento comercial realiza retentativa de envio de autorização para códigos de respostas irreversíveis com um mesmo cartão valido para cartão não presente.

Dentro desse programa de retentativas, há programas que se destinam especificamente ao cenário de “Não tente esta transação novamente”. Para esses casos, a Mastercard identifica as transações com os valores MAC 03 e MAC 21, por exemplo.

Os outros códigos MAC (01, 02, 04, 24, 25, 26, 27, 28, 29, 30, 40 e 41) não entram no programa de cobrança do MAC mas entram na cobrança do programa Excessive Attempts, caso exceda os limites.

Desde 14/10/2022 a Mastercard introduziu novos códigos MAC (24, 25, 26, 27, 28, 29 e 30) quando um emissor recusa uma transação com o código de resposta 51 (insuficiência de fundos) seguido de um dos MAC da tabela a seguir, para que o comerciante tome a melhor ação.

Tabela com toda relação de MACs

MACDescriçãoObservação
01Informações da nova conta disponíveis (ABU)Necessidade de realizar atualização dos dados da conta que está sendo utilizada na transação, usando o ABU, por exemplo.
02Não pode aprovar no momento, tente depoisTente novamente a transação após 72 horas ou tente a transação com um método de pagamento diferente.
03Não é permitido retentarBusque outro meio de pagamento, para evitar o custo de novas autorizações que continuarão recusadas.
04Requisitos de token não atendidos para este token modeloHá necessidade de revisar os requisitos de token, pois os requisitos não foram atendidos para este token modelo enviado na transação.
21Plano canceladoComprador realiza cancelamento de plano e mesmo após o cancelamento, estabelecimento continua enviando solicitação de autorização de compra.
24Tente novamente após 1 horaVálido somente para o código de resposta 51 (insuficiência de fundos).
25Tente novamente após 24 horasVálido somente para o código de resposta 51 (insuficiência de fundos).
26Tente novamente após 2 diasVálido somente para o código de resposta 51 (insuficiência de fundos).
27Tente novamente após 4 diasVálido somente para o código de resposta 51 (insuficiência de fundos).
28Tente novamente após 6 diasVálido somente para o código de resposta 51 (insuficiência de fundos).
29Tente novamente após 8 diasVálido somente para o código de resposta 51 (insuficiência de fundos).
30Tente novamente após 10 diasVálido somente para o código de resposta 51 (insuficiência de fundos).
40Não é permitido retentarCartão pré pago não recarregável para consumo.
41Não é permitido retentarCartão virtual de uso único do consumidor.

Além disso, alguns códigos de retorno deixarão de ser enviados:

  • 04 (Cartão de Captura)
  • 14 (Número de cartão inválido)
  • 43 (Cartão Roubado)
  • 54 (Cartão Expirado)
  • 57 (Transação Não Permitida)
  • 62 (Cartão Restrito)
  • 63 (Violação de Segurança)

Categorização de retornos Mastercard

A Mastercard poderá consolidar alguns códigos de respostas dos emissores, que muitas vezes não indicam ao comerciante se pode ou não retentar, em três códigos de uso exclusivo Mastercard:

  • 79 (Ciclo de vida);
  • 82 (Política);
  • 83 (Fraude/ Segurança).

Os códigos originais serão substituídos pelo Merchant Advice Code (MAC), que acompanharão os códigos 79, 82 e 83 para determinar se a transação pode ou não ser retentada.

Por exemplo:

QuandoEntãoE o código de resposta
O emissor recusar a transação usando o código de resposta 54 (Cartão Expirado)A Mastercard substituirá o código 54 para o código 79 (recusa por ciclo de vida)Acompanha o devido Merchant Advice Code (MAC)

Programa de retentativas MAC 03 e MAC 21

Forma de apuração:

  • Serão consideradas as transações de cartão não presente;
  • São consideradas como retentativas todas as transações de pagamento no mesmo cartão e mesmo número deestabelecimento;São contabilizadas as retentativas no programa MAC com os valores MAC 03 e MAC 21;
  • Valido para qualquer código de resposta;
  • O excesso contabilizado no programa ocorrerá a partir da 1ª retentativa dentro do mês de apuração;
  • O contador é zerado após o período de 30 dias;
  • As retentativas podem ser cobradas nos MACs 03/21 e no Excessive Attempts caso ultrapasse o limite de cada programa;
  • Atualmente é aplicado o valor de tarifa de R$1,25 e esse valor será alterado a partir de 01 de janeiro de 2023, como listado a seguir.

Tabela de valores:

Número de retentativaRegra
A partir 1ª retentativaR$ 2,50 (dois reais e cinquenta centavos) por retentativa, a partir da 1ª retentativa.

Visa

O programa de retentativas instituído pela bandeira Visa gera cobranças quando o estabelecimento comercial excede as regras de retentativas.

O programa quer que credenciadores e estabelecimentos informem as retentativas com precisão e reduzam as novas tentativas desnecessárias.

A bandeira exige que os emissores usem códigos de resposta corretos e não genéricos, para facilitar a identificação do motivo da recusa de uma transação.

A Visa divide esses códigos em reversíveis e irreversíveis, sendo válido tanto para transações com cartão presente e cartão não presente:

  • Códigos reversíveis: são permitidas até 20 tentativas de aprovar uma mesma transação (com mesmo cartão, transação, validade, valor e estabelecimento) no período de 30 dias. Após os 30 dias corridos, a contar da primeira tentativa, qualquer retentativa será cobrada. O limite de 20 tentativas vale desde 25/05/2025; antes eram 15.
  • Códigos irreversíveis: é permitida apenas a 1ª tentativa de aprovar a transação (com mesmo cartão, transação, validade, valor e estabelecimento). Na segunda tentativa, a transação já será cobrada, independente do período em que for realizada.

A Visa cobra uma tarifa por tentativa em excesso.

No doméstico, USD 0,10 + 13,83% de imposto; no estrangeiro, USD 0,25 + 13,83% de imposto.

A cobrança de tarifas é aplicada desde abril de 2021.

A Visa agrupou os códigos de retorno em quatro categorias:

  • Categoria 1: emissor nunca aprovará. Indica que o cartão foi cancelado ou nunca existiu ou que a negativa é resultado de uma restrição permanente ou condição de erro que impedirá uma aprovação futura.
  • Categoria 2: emissor não pode aprovar no momento. Indica que a negativa é resultado de uma condição temporária tal como risco de crédito, controles de velocidade do emissor ou outras restrições do cartão que podem permitir uma retentativa da transação ser aprovada. Em alguns casos, a negativa requer uma ação do portador ou emissor para remover a restrição antes que uma aprovação possa ser obtida.
  • Categoria 3: qualidade de dados. Quando um erro de dados é identificado pelo emissor essa transação é declinada como consequência. Os estabelecimentos devem revalidar dados de pagamentos antes de retentar. Estabelecimentos e credenciadores devem monitorar estes códigos de negativas devido a exposição potencial a fraudes. Atenção: A categoria 3 tem, além dos limites considerados na categoria 2, um limite diferente que é cumulativo. Um estabelecimento pode realizar até 25.000 transações em um período de 30 dias (neste caso considerando apenas o número do estabelecimento e códigos de negadas). Se ultrapassar o limite, todas as transações recusadas por categoria 3 serão tarifadas.
  • Categoria 4: códigos de respostas genéricos. A categoria 4 inclui todos os demais códigos de resposta de recusa que não estão nas categorias 1, 2 e 3, pois pode haver circunstâncias em que não haja valor de código de resposta para uma condição de recusa específica. Emissores podem usar outros valores de códigos de resposta definidos nas Especificações Técnicas VisaNet; no entanto, o uso deve permanecer mínimo.

Os emissores que excederem o limite definido regionalmente receberão a Taxa de Código de Resposta Genérica por base de transação para cada declínio em excesso do limite definido.

Tabela com as regras e códigos de recusa:

As regras da tabela a seguir são válidas tanto para transações de compra, quanto para transações Zero Auth.

CategoriaTipoCódigosRegras
Categoria 1 Emissor não aprovará novas tentativasIrreversível04 - Reter cartão 07 - Reter cartão, condições especiais 12 - Transação inválida 14* - Número de conta inválido 15 - Emissor não existe 41 -Reter cartão (cartão perdido) 43 - Reter cartão (cartão roubado) 46 - Conta encerrada 57 - Transação não permitida ao portador de cartão R0 - Parar ordem de pagamento R1 - Revogação do pedido de autorização R3 - Revogação de todos os pedidos de autorizaçãoCobrança de tarifa a partir da 2ª tentativa.
Categoria 2 Emissor não aprovará no momento; novas tentativas são permitidasReversível03 - Comerciante inválido 19 - Redigitar a transação 39** - Sem conta de crédito 51 - Insuficiência de fundos 52** - Sem conta corrente 53** - Sem conta poupança 59 - Suspeita de fraude 61 - Excede os limites de valor de retiradas 62 - Cartão restrito (cartão inválido na região ou país) 65 - Excede a frequência de retiradas 75 - Excedeu o número permitido de tentativas de digitação de senha 78 - Bloqueado, usado pela primeira vez ou condição especial (a conta está temporariamente bloqueada) 86 - Mal funcionamento no caixa eletrônico 91 - Emissor ou switch inoperante 93 - A transação não pode ser concluída (violação da lei) 96 - Mal funcionamento do sistema N3 - Serviço de saque indisponível N4 - Solicitação de dinheiro excede o limite do emissor Z5*** - Conta válida, mas valor não suportado 5C**** - Transação não suportada/bloqueada pelo emissor 9G**** - Bloqueado pelo portador do cartão (contate o portador do cartão).Cobrança de tarifa a partir da 21ª tentativa: o estabelecimento pode fazer até 20 tentativas da mesma transação. A partir da 21ª tentativa (com mesmo cartão, transação, validade, valor e estabelecimento) num período de 30 dias corridos a partir da 1ª tentativa, a transação será tarifada. Passado o período de 30 dias, a Visa não permite nenhuma nova tentativa. Então, caso haja envio de uma tentativa dessa mesma transação, a cobrança já será aplicada para essa retentativa enviada (daí, a regra de 20 tentativas deixa de ser válida, passado a ser válido o período de 30 dias corridos).
Categoria 3 Qualidade de dadosReversível54 - Cartão vencido 55 - Senha incorreta 70 - Dados de PIN necessários (somente na região da Europa) 82 - Os resultados de CAM,2 dCVV,3 iCVV4 ou CVV on-line foram negativos 1A - Autenticação de cliente adicional necessária (somente na região da Europa) 6P - Falha na verificação (a identificação do titular do cartão não corresponde aos registros do emissor) \ N7 - Recusa decorrente de falha do CVV2 (Visa)Cobrança de tarifa a partir da 21ª tentativa: o estabelecimento pode fazer até 20 tentativas da mesma transação. A partir da 21ª tentativa (com mesmo cartão, transação, validade, valor e estabelecimento) num período de 30 dias corridos a partir da 1ª tentativa, a transação será tarifada. Passado o período de 30 dias, a Visa não permite nenhuma nova tentativa. Então, caso haja envio de uma tentativa dessa mesma transação, a cobrança já será aplicada para essa retentativa enviada (daí, a regra de 20 tentativas deixa de ser válida, passado a ser válido o período de 30 dias corridos).
Categoria 4Códigos de respostas genéricosReversívelCódigos de respostas genéricos não listados nas categorias 1,2,3Cobrança de tarifa a partir da 21ª tentativa: o estabelecimento pode fazer até 20 tentativas da mesma transação. A partir da 21ª tentativa (com mesmo cartão, transação, validade, valor e estabelecimento) num período de 30 dias corridos a partir da 1ª tentativa, a transação será tarifada. Passado o período de 30 dias, a Visa não permite nenhuma nova tentativa. Então, caso haja envio de uma tentativa dessa mesma transação, a cobrança já será aplicada para essa retentativa enviada (daí, a regra de 20 tentativas deixa de ser válida, passado a ser válido o período de 30 dias corridos).

Na categoria 3, o limite é de 25.000 recusas em um ciclo de faturamento de 30 dias.

Até abril de 2023, o limite da contagem total de recusas era de 10.000.

As categorias acima são as do programa da Visa e definem a partir de qual tentativa há tarifa. A página Códigos ABECS traz a classificação da ABECS, que pode divergir: 03, 93 e N3 são reversíveis na Visa, e 93 e N3 são irreversíveis na ABECS.

Elo

As regras apresentadas a seguir entraram em vigor em janeiro de 2025.

A mudança quer reduzir as novas tentativas desnecessárias de estabelecimentos e credenciadores.

O período de apuração das transações ocorre mensalmente, sendo contabilizado do 1º ao último dia corrido do mês de violação.

Confira os valores:

Cobrança
R$0,80 (oitenta centavos) por cada tentativa excedida

Regras de cobrança

A bandeira vai considerar códigos reversíveis e irreversíveis de acordo com grupos separados em três categorias.

GrupoDescriçãoCobrança
Grupo 1Transações de cartão não presente negadas com códigos irreversíveis, considerando o mesmo número de cartão, mesmo CNPJ do estabelecimento e mesmo valor.A cobrança ocorre a partir da 2ª retentativa dentro do mês de apuração.
Grupo 2Transações de cartão não presente negadas com códigos reversíveis.A cobrança ocorre a partir da 16ª retentativa dentro do mês de apuração.
Grupo 3Transações de cartão não presente negadas com características de Ataques de Força Bruta, considerando transações com o mesmo CNPJ Raiz do Estabelecimento Comercial.Ocorre a partir de 10.001 transações negadas (dentro da categoria de códigos) e excedam 5% do total de recusas, a depender do volume de transações de pagamento do CNP envolvido.

Classificação dos Grupos:

Grupo 1 Emissor nunca aprovará IRREVERSÍVELGrupo 2 Emissor não pode aprovar no momento REVERSÍVELGrupo 3 Qualidade de dados, revalidar informação (*)
57 - Não permitida51 - Limite insuficiente54 - Cartão Expirado
14 ou 56 - Cartão Inválido (*)59 - Suspeita de fraude55 - Senha Inválida
58 - Comerciante Inválido04 - Refazer a transação82 - Cartão criptograma inválido
46 - Conta encerrada06 - Consultar credenciador63 - CVE inválido ou não presente
FM - Utilizar o Chip38 - Excedidas tentativas de senha compras-
19- Consultar adquirente61 - Valor em excesso de saque-
12 - Erro no cartão62 - Bloqueio temporário de inadimplência-
30 - Erro de formato Mensageria65 - Quantidade de saque excedida-
13- Valor transação inválido75 - Excedidas tentativas de senha / saque-
23 - Valor da Parcela Inválido78 - Cartão novo sem desbloqueio ou bloqueado pelo cliente APP/NFC/E-COM-
41 - Cartão Perdido91 - Emissor fora do ar-
43 - Cartão Roubado--
64 - Valor mínimo da transação inválido--
83 - Erro de criptografia senha--
76 - Conta destino inválida--
77 - Conta origem inválida--

Demais bandeiras

  • Códigos reversíveis: serão permitidas novas retentativas para o mesmo cliente e cartão. Não há limite e período pré-estabelecido. Importante: antes de realizar uma nova tentativa, siga a orientação recebida na resposta da transação negada.
  • Códigos Irreversíveis: não serão permitidas autorizações para o mesmo cartão ou estabelecimento, depois de receber 1ª resposta de recusa do emissor.