Posso desligar a parada em recusa irreversível?

Pode, mas não recomendamos. Desligar significa pagar por tentativa que o emissor já informou que não aprovará, e as bandeiras têm programa de penalidade para excesso de tentativa. O mesmo vale para desligar o respeito ao pedido do emissor.

Cobrança avulsa também é retentada?

Não. Fatura avulsa recusada não agenda retentativa: ela não tem acordo de recorrência com o portador, então quem tenta de novo é o cliente, pelo link de pagamento. A fatura segue em aberto esperando por ele.

Onde vejo a tabela completa?

Na documentação de códigos de recusa, com as 50 situações do Anexo I, a reversibilidade por bandeira e a ação recomendada de cada uma.

Recuperação de receita

Tentar de novo só quando o emissor ainda pode aprovar

O Minstrel lê o motivo da recusa segundo o Normativo nº 021 da ABECS e decide sozinho: saldo insuficiente volta no dia certo, cartão perdido não volta mais e suspensão de recorrência cancela a assinatura.

50 situações classificadas
O pedido do emissor tem precedência
Zero tentativa inútil

Testar no sandbox Documentação de retentativa

Como funciona

1
A recusa chega
A adquirente devolve o código bruto do emissor, que varia por bandeira e por parceiro.
2
O Minstrel classifica
A tabela do Anexo I traduz o código em motivo canônico, reversibilidade e ação recomendada, considerando a bandeira.
3
A política decide a data
Se a ação permite nova tentativa, a política define quando. Se o emissor pediu um intervalo maior, o dele vale.
4
O resultado vira evento
A tentativa, o motivo e a decisão ficam no detalhe da transação e saem por webhook para o seu sistema.

No painel

O rastro da transação

Cada tentativa mostra a conta usada, o código bruto, o motivo canônico, a reversibilidade e a ação. No fim, o motivo de ter parado: recusa irreversível, tentativas esgotadas ou candidatos esgotados.

Detalhe de uma transação recuperada na segunda tentativa, com a classificação de cada recusa.

No painel

A política

Número de tentativas, intervalo entre elas, janela máxima e horário local. As duas travas de segurança ficam ligadas por padrão: respeitar o pedido do emissor e parar em recusa irreversível.

Política de retentativa: quatro tentativas em dez dias, às 10h de Brasília.

O que está incluído

Três campos em toda recusa
O motivo canônico é igual para todas as bandeiras e serve para decidir e agrupar relatório. O código bruto fica junto, para você falar com o adquirente.
decline.reason · decline.reversibility · decline.retryAction
Só três das sete ações retentam sozinhas
Reagendar em dias e falha transitória geram nova tentativa automática. Trocar o cartão, falar com o portador, alterar algum campo ou encerrar não geram: insistir ali é custo sem chance de aprovação.
RETRY_LATER · RETRY_SOON · DO_NOT_RETRY · STOP_RECURRING
Suspensão de recorrência cancela a assinatura
Os códigos R0, R1 e R3 da Visa e o Merchant Advice Code 21 da Mastercard são determinação do emissor, não recusa. A assinatura é cancelada, fica marcada como cancelada pelo emissor e um evento avisa o seu sistema. Não existe configuração que sobreponha isso.
subscription.canceled_by_issuer
O intervalo do emissor só aumenta o seu
A Mastercard informa o prazo no Merchant Advice Code: tentar em 1 hora, em 24 horas, em 2, 4, 6, 8 ou 10 dias. Se a sua política pede 24 horas e o emissor pede 4 dias, esperamos 4 dias. O contrário não acontece.
A bandeira muda a classificação
O mesmo código não quer dizer a mesma coisa em todo lugar: o 57 é irreversível na Visa e na Elo e reversível na Mastercard. A tabela trata as 50 situações do anexo com a bandeira junto.
Política com janela, fuso e hora preferida
A padrão faz uma cobrança e três retentativas em sete dias, em datas distintas de crédito do portador. Você ajusta o número de tentativas, os intervalos e o horário local.
maxAttempts · schedule · windowDays · preferredHourLocal

Recusa classificada

{  "object": "payment",  "status": "failed",  "decline": {    "reason": "INSUFFICIENT_FUNDS",    "reversibility": "REVERSIBLE",    "retryAction": "RETRY_LATER"  },  "attempts": [    {      "attemptNumber": 1,      "connector": "cielo",      "rawResponseCode": "51",      "declineReason": "INSUFFICIENT_FUNDS",      "reversibility": "REVERSIBLE",      "retryAction": "RETRY_LATER"    }  ]}

Documentação de retentativa

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de retentativa.

Posso desligar a parada em recusa irreversível?
Pode, mas não recomendamos. Desligar significa pagar por tentativa que o emissor já informou que não aprovará, e as bandeiras têm programa de penalidade para excesso de tentativa. O mesmo vale para desligar o respeito ao pedido do emissor.
Cobrança avulsa também é retentada?
Não. Fatura avulsa recusada não agenda retentativa: ela não tem acordo de recorrência com o portador, então quem tenta de novo é o cliente, pelo link de pagamento. A fatura segue em aberto esperando por ele.
Onde vejo a tabela completa?
Na documentação de códigos de recusa, com as 50 situações do Anexo I, a reversibilidade por bandeira e a ação recomendada de cada uma.

Continua em

Veja funcionando no sandbox

Gratuito, ilimitado e sem prazo. Dá para simular aprovação, cada recusa da ABECS e falha de rede antes de credenciar a primeira adquirente.

Primeiros passos Ver preços