Referência grátis · Mercado Pago
Códigos de rejeição do Mercado Pago
(status_detail) explicados
Quando um pagamento é rejeitado, o campo status_detail diz por quê. Esta é a lista da documentação oficial do Mercado Pago para Argentina e Brasil, com o que cada código significa e o que fazer, seja você o comprador, o vendedor ou o desenvolvedor.
Pagamentos rejeitados
status é rejected. O pagamento não foi aceito.
| status_detail | O que significa |
|---|---|
| bank_error | O pagamento foi feito por transferência bancária e foi rejeitado por um erro no banco. |
| cc_rejected_3ds_mandatory | O pagamento foi rejeitado porque não passou pelo challenge 3DS, que era obrigatório. |
| cc_rejected_bad_filled_card_number | O número do cartão parece incorreto. O Mercado Pago pede ao comprador que o revise. |
| cc_rejected_bad_filled_date | A data de vencimento parece incorreta. O Mercado Pago pede ao comprador que a revise. |
| cc_rejected_bad_filled_other | A documentação só diz para revisar os dados, sem indicar qual está errado. |
| cc_rejected_bad_filled_security_code | O código de segurança do cartão parece incorreto. O Mercado Pago pede ao comprador que o revise. |
| cc_rejected_blacklist | O Mercado Pago não conseguiu processar o pagamento. A documentação não dá nenhum motivo, então não invente um para o comprador. |
| cc_rejected_call_for_authorize | O comprador precisa autorizar este pagamento, deste valor, junto ao provedor da forma de pagamento para que possa ser aceito. |
| cc_rejected_card_disabled | Ligue para o emissor (payment_method_id) para ativar seu cartão. |
| cc_rejected_card_error | O Mercado Pago não conseguiu processar o pagamento. A documentação não dá nenhum motivo e usa o mesmo texto de cc_rejected_blacklist. |
| cc_rejected_duplicated_payment | O comprador já fez um pagamento com esse mesmo valor. |
| cc_rejected_high_risk | O pagamento foi recusado. A documentação não dá o motivo; recomenda escolher outra forma de pagamento, de preferência em dinheiro. |
| cc_rejected_insufficient_amount | A forma de pagamento não tem saldo suficiente para este pagamento. |
| cc_rejected_invalid_installments | A forma de pagamento não processa pagamentos no número de parcelas que foi pedido. |
| cc_rejected_max_attempts | O comprador atingiu o limite de tentativas permitido. A documentação indica escolher outro cartão ou outra forma de pagamento. |
| cc_rejected_other_reason | A forma de pagamento não processou o pagamento. A documentação não dá um motivo mais específico. |
| cc_amount_rate_limit_exceeded | O pagamento foi rejeitado porque superou o limite da forma de pagamento, chamado CAP (Capacidade Máxima Permitida). |
| rejected_insufficient_data | O pagamento foi rejeitado porque faltavam informações obrigatórias na requisição. O código não indica qual campo está faltando. |
| rejected_by_bank | O banco recusou a operação. A documentação não dá um motivo. |
| rejected_by_regulations | O pagamento foi recusado devido a regulamentações. A documentação não diz qual regulamentação se aplica. |
| insufficient_amount | O pagamento foi rejeitado por valores insuficientes. A documentação não explica mais; para um cartão sem saldo suficiente ela lista outro código, cc_rejected_insufficient_amount. |
| cc_rejected_card_type_not_allowed | O pagamento foi rejeitado porque o usuário não tem a função crédito habilitada em seu cartão múltiplo (débito e crédito). Este código consta na documentação do Mercado Pago do Brasil e não nas páginas da Argentina. |
Pagamentos pendentes
status é pending. O pagamento aguarda uma ação do comprador.
| status_detail | O que significa |
|---|---|
| pending_waiting_transfer | Pagamento por transferência bancária: fica pendente enquanto o comprador conclui o processo de pagamento no banco. |
| pending_waiting_payment | Pagamento offline: fica pendente até que o comprador realize o pagamento. |
| pending_challenge | Pagamento com cartão de crédito: há uma confirmação pendente por causa de um challenge. |
Pagamentos em processamento
status é in_process. O Mercado Pago ainda está processando o pagamento.
| status_detail | O que significa |
|---|---|
| offline_process | Por falta de processamento online, o pagamento está sendo processado de maneira offline. |
| pending_contingency | O Mercado Pago está processando o pagamento. Segundo a documentação, em menos de 2 dias úteis o comprador é avisado por e-mail se ele foi creditado. |
| pending_review_manual | O Mercado Pago está processando o pagamento. Segundo a documentação, em menos de 2 dias úteis o comprador é avisado por e-mail se ele foi creditado ou se é preciso mais informação. |
O que esta lista cobre
Lista todos os valores de status_detail dos status rejected, pending e in_process que constam nas páginas oficiais "resultados da criação de um pagamento" do Mercado Pago para Argentina e Brasil em 2026-11-04; as páginas de outros países podem diferir. cc_rejected_card_type_not_allowed consta apenas na documentação do Brasil. Pagamentos approved e authorized ficam de fora. A Orders API documenta o seu próprio conjunto de valores de status_detail, diferente, em outra página, e ele não é coberto aqui.
Fonte: documentação para desenvolvedores do Mercado Pago, verificada em 2026-11-04. Resultados da criação de um pagamento (Mercado Pago)
Perguntas sobre os códigos de rejeição do Mercado Pago
O que é status_detail no Mercado Pago?+
É o campo de um pagamento que dá o motivo por trás do seu status. Um pagamento rejeitado, por exemplo, vem com um status_detail como cc_rejected_other_reason ou cc_rejected_high_risk que explica por que foi rejeitado.
Um status_detail pending ou in_process significa que o pagamento falhou?+
Não. Códigos como pending_waiting_payment ou pending_review_manual descrevem um pagamento que ainda não foi resolvido. Mantenha o pedido pendente e espere o status final em vez de criar um segundo pagamento.
Esses são todos os códigos que o Mercado Pago pode devolver?+
São todos os códigos rejected, pending e in_process listados nas páginas oficiais "resultados da criação de um pagamento" do Mercado Pago para Argentina e Brasil em 2026-11-04; as páginas de outros países podem diferir. O Mercado Pago também pode mudar a documentação, então confira o link da fonte em cada página.
| Preço | Founder $99 ou Lifetime $199, pagamento único (sem assinatura) |
|---|---|
| Licença | Código-fonte completo, uso comercial, projetos ilimitados. O Founder é uma versão congelada; o Lifetime inclui todas as versões futuras. |
| Stack | Frontend em Next.js, API em Express, runtime Bun, Prisma, BetterAuth |
| Autenticação | BetterAuth: sessões, 2FA, magic links, redefinição de senha |
| Multi-tenancy e RBAC | Organizações com membros, convites, papéis e permissões |
| Pagamentos | Polar: cobrança completa (checkout, portal do cliente, webhooks, sincronização de planos). MercadoPago: pagamentos únicos com Checkout Pro e webhooks assinados; as assinaturas ainda não são suportadas. Stripe: scaffold de adapter, ainda não cobra. |
| Guardrails para agentes de IA | Camadas de arquitetura forçadas com ESLint, hooks do Claude Code e um AGENTS.md |
| Reembolso | 14 dias |
| Teste: conta grátis | Cadastre-se grátis e explore o dashboard: organizações, papéis, cobrança, log de auditoria. A licença é comprada por dentro. https://usedeploy.dev/register |
| Docs | Documentação em inglês, com traduções para espanhol e português dos guias principais |