O que é código de recusa? Definição, fluxo de pagamento e exemplos
O código de recusa é o código que indica a categoria do motivo ou a orientação de tratamento quando a transação não é aprovada, e a explicação mostrada ao usuário costuma ser simplificada. Este guia explica o papel do código de recusa no fluxo real de pagamentos, seus limites e os equívocos mais comuns.
Pontos principais
- Definição: O código de recusa é o código que indica a categoria do motivo ou a orientação de tratamento quando a transação não é aprovada, e a explicação mostrada ao usuário costuma ser simplificada.
- Posição no fluxo: O lojista envia a solicitação de autorização, e o lado emissor devolve uma aprovação ou uma recusa com base na conta, no valor, nas credenciais, no risco e nas regras do produto.
- Não confunda: Código de recusa / Recusa temporária
Como entra no fluxo de pagamento
No caso do código de recusa, o fluxo é o seguinte: o lojista envia a solicitação de autorização, e o lado emissor devolve uma aprovação ou uma recusa com base na conta, no valor, nas credenciais, no risco e nas regras do produto. O código de autorização, os dados da resposta e o código de recusa são informações dessa decisão e não equivalem à captura, ao lançamento nem ao recebimento final dos recursos pelo lojista.
Ao avaliar o código de recusa, observe o seguinte: diante de uma recusa, o lojista deve agir conforme as informações retornadas e as regras da bandeira, sem mostrar ao usuário detalhes internos sensíveis. Uma recusa temporária pode permitir uma verificação complementar adequada ou uma nova tentativa; já uma recusa definitiva, em geral, não se resolve com envios repetidos.
Exemplo prático
Depois de uma recusa, o lojista usa o código de recusa para decidir se mostra uma mensagem, pede uma verificação ou para de tentar. A mensagem ao consumidor deve dizer o que fazer, sem revelar detalhes que ajudem atacantes a testar cartões.
Diferenças em relação a termos parecidos
| Termo | Definição |
|---|---|
| Código de recusa | é o código que indica a categoria do motivo ou a orientação de tratamento quando a transação não é aprovada, e a explicação mostrada ao usuário costuma ser simplificada |
| Recusa temporária | é a recusa que pode ser resolvida com uma autenticação complementar, a correção dos dados ou uma nova tentativa mais tarde, mas a possibilidade de tentar de novo depende do motivo específico |
| Recusa definitiva | é a recusa que, em geral, não deve ser seguida de novas tentativas imediatas e repetidas com a mesma credencial e pode envolver conta inválida, restrições ou uma decisão de risco explícita |
Em essência, o código de recusa é o código que indica a categoria do motivo ou a orientação de tratamento quando a transação não é aprovada, e a explicação mostrada ao usuário costuma ser simplificada; já a recusa temporária é a recusa que pode ser resolvida com uma autenticação complementar, a correção dos dados ou uma nova tentativa mais tarde, mas a possibilidade de tentar de novo depende do motivo específico. Os dois conceitos podem aparecer na mesma transação, mas respondem a perguntas diferentes.
Uso, riscos e limites
O código de recusa tem um limite importante: repetir tentativas às cegas pode gerar autorizações duplicadas, acionar o controle de risco ou piorar a experiência do cliente. Além disso, a aprovação é só um pré-requisito para as etapas seguintes; a entrega do pedido e a contabilização final precisam ser confirmadas à parte.
Perguntas frequentes
A seguir, as respostas para as duas dúvidas mais comuns de quem pesquisa sobre código de recusa.
É a mesma coisa que recusa temporária?
Não. O código de recusa é o código que indica a categoria do motivo ou a orientação de tratamento quando a transação não é aprovada, e a explicação mostrada ao usuário costuma ser simplificada. A recusa temporária é a recusa que pode ser resolvida com uma autenticação complementar, a correção dos dados ou uma nova tentativa mais tarde, mas a possibilidade de tentar de novo depende do motivo específico. Para diferenciar, verifique separadamente o objeto, a etapa do fluxo e a parte responsável.
Receber um código de autorização significa que o lojista já recebeu o dinheiro?
No caso do código de recusa, não. O código de autorização está ligado à decisão de aprovação; o registro dos valores e a liquidação entre as partes costumam acontecer depois, nas etapas de captura, compensação e liquidação.
As fontes primárias abaixo servem para conferir a definição e o fluxo do código de recusa; as regras específicas de cada produto e região seguem os documentos oficiais vigentes.
Tradução assistida por IA; o texto original foi revisado por Steven Cai.