Comorando Começar grátis →

⚠️ Erro conhecido do Mercado Pago

Cartão Recusado pelo Mercado Pago: Entenda e Corrija

Guia técnico para desenvolvedores sobre o erro de 'Cartão Recusado' no Mercado Pago, com soluções práticas.

Por que esse erro ocorre?

O erro 'Cartão Recusado' no Mercado Pago geralmente indica uma falha na comunicação entre o seu sistema e os servidores do Mercado Pago durante o processo de autorização. Essa falha pode ser causada por diversas razões, como limitação de crédito no cartão, dados inválidos, restrições de segurança impostas pelo emissor do cartão ou problemas temporários na infraestrutura do Mercado Pago. A complexidade da validação de cartões e a diversidade de regras dos bancos emitem frequentemente essa mensagem.

Código de exemplo

import { MercadoPagoConfig, Payment } from 'mercadopago';

const client = new MercadoPagoConfig({
  accessToken: process.env.MP_ACCESS_TOKEN,
});
const payment = new Payment(client);

const info = await payment.get({ id: paymentId });
if (info.status === 'rejected') {
  // status_detail revela la causa exacta:
  // cc_rejected_insufficient_amount, cc_rejected_call_for_authorize,
  // cc_rejected_bad_filled_security_code, cc_rejected_high_risk, etc.
  console.warn('Pago rechazado:', info.status_detail);
  await scheduleRetry(paymentId, info.status_detail);
}