Validar pagamento por código - Belluno
A Belluno possui um mecanismo antifraude chamado validação por código. Em algumas compras, em vez de aprovar ou recusar a transação imediatamente, a Belluno coloca o pagamento em aguardando validação e solicita uma confirmação adicional. O cliente precisa provar que é o dono do cartão.
O código de 4 dígitos aparece no final do nome da loja na fatura do cartão. Apenas quem tem acesso à fatura consegue ver o código, garantindo a posse do cartão. O cliente insere esse código na tela de conclusão do pedido e a compra segue para aprovação.
Pré-requisitos
- Integração Belluno previamente configurada
Para habilitar essa funcionalidade, você deve solicitar à Belluno a configuração prévia do seu gateway.
Quando a tela de validação aparece
A validação é acionada somente quando:
- Pagamento feito através do cartão de crédito Belluno
- Belluno devolve o status de aguardando validação para a transação.
Para outros meios de pagamento (Pix, boleto, etc.), o cliente vê a tela de confirmação normal, sem solicitar código.
Validação do código - Cliente
Tela: “Seu pagamento aguarda uma validação”
O cliente verá:
- Um box Validação de Segurança com a instrução:
"Localize esse pagamento na sua fatura do cartão e informe o código numérico que aparece no final do nome do estabelecimento." - Um campo para digitar os 4 dígitos.
- Um botão Enviar Código.
- Um aviso: se a confirmação não for feita, a compra poderá ser estornada.
- Link de ajuda: Veja mais detalhes sobre como encontrar o código de validação, com instruções:
Enviando o código
- Localizando a transação na fatura, por exemplo: LojaExemplo6789 — os últimos 4 dígitos (6789) são o código.
- Digite os 4 dígitos no campo e clique em Enviar Código.
Resultado do envio
Situação | O que acontece |
| Código correto | Mensagem verde: "Código enviado com sucesso! Aguarde a confirmação do pagamento. Você receberá um e-mail quando o pagamento for aprovado." + botão Visualizar Pedido |
| Código errado | Mensagem vermelha informando que o código é inválido e quantas tentativas restam. O campo é limpo para nova tentativa |
| Tentativas esgotadas | Após 3 erros, o formulário trava e aparece o botão Voltar para o Site |
Regras importantes
- Tentativas: o cliente tem até 3 tentativas de inserir o código. Cada erro mostra quantas restam. Esgotadas as tentativas, o formulário é bloqueado.
- Formato do código: aceita apenas números, com exatamente 4 dígitos. Letras, espaços ou números diferentes são recusados.
- Localização do código: o código aparece na fatura do cartão, não é enviado por e-mail ou SMS. Pode demorar para aparecer na fatura dependendo do banco.
- Confirmação de envio: "Código enviado com sucesso" não significa pagamento aprovado. A transação é liberada para aprovação, mas a confirmação final chega por e-mail.
- Sem validação: se o cliente não concluir a validação, a Belluno estornará a transação.




