Skip to main content
A Reval opera sobre o Mercado Pago, e isso implica restrições reais que vale a pena entender antes de ir para produção. As limitações que você encontra nesta página não são bugs nem itens pendentes no roadmap: são consequências de como funciona o sistema de mandatos do Mercado Pago e, em alguns casos, da regulação financeira do país onde você opera. Algumas funcionalidades de referência de apps globais como Skio ou Recharge são genuinamente impossíveis sobre o Mercado Pago, e a Reval as modela com honestidade em vez de simulá-las. Documentá-las de frente faz parte do posicionamento do produto.
Um mandato do Mercado Pago só pode debitar nas datas do próprio ciclo: não é possível executá-lo sob demanda, antecipá-lo nem reprogramá-lo. Essa é a origem da maioria das limitações que detalhamos a seguir, e não é uma decisão da Reval.Na Argentina existe além disso uma restrição regulatória: não é possível cobrar um cartão salvo sem que o titular esteja presente na transação. É o marco dentro do qual operam todos os processadores de pagamento do país. Se você opera em outro mercado, verifique quais regras se aplicam ao seu.

Limitações atuais

O que significa: você não pode iniciar uma cobrança em qualquer momento que precisar. Não existe um botão “cobrar agora” para uma assinatura ativa fora do ciclo programado.Por que essa limitação existe: os mandatos do Mercado Pago foram desenhados para cobranças periódicas em datas predefinidas, não para cobranças arbitrárias sob demanda do lojista. Em mercados como a Argentina soma-se uma restrição regulatória: cobrar um cartão salvo exige a presença ativa do titular.A alternativa disponível: todas as cobranças acontecem automaticamente nos ciclos programados do mandato. Se você precisa cobrar um item pontual fora do ciclo, use a funcionalidade de add-ons: o cliente os adiciona pelo portal, a cobrança é executada na hora com a participação ativa dele, e o produto é enviado no próximo ciclo.
O que significa: o cliente pode pular a próxima entrega pelo portal (se você habilitar em Configuração → Pedidos e estoque), mas a data da cobrança seguinte pode se deslocar alguns dias em relação à que prometemos a ele.Por que essa limitação existe: o Mercado Pago não tem “pular”: não é possível omitir uma cobrança nem mover a data da próxima (next_payment_date é somente leitura). A Reval resolve isso pausando o débito e reativando-o automaticamente um ciclo depois. É a mesma assinatura — mesmo preço, mesmos produtos, mesmo cartão, mesmo histórico — mas a data exata da cobrança posterior é decidida pelo Mercado Pago ao reativar o mandato, e não por nós.O que você vê na prática: ao pular, o portal mostra na hora a data prevista. Quando o débito é reativado, a Reval lê a data real do Mercado Pago e atualiza o portal se ela for diferente. O ciclo que o cliente pulou nunca é cobrado.Se você preferir não oferecer: deixe o interruptor desligado (ele vem desligado por padrão) e o botão não aparece no portal. Para interrupções mais longas, pausar continua sendo a ferramenta indicada: o cliente pausa e retoma quando quiser, sem perder configuração nem histórico.
O que significa: a data do próximo ciclo é fixada pelo mandato e não é editável diretamente pelo portal nem pelo painel do lojista.Por que essa limitação existe: a data de cobrança está vinculada à estrutura do mandato no Mercado Pago. Modificá-la ao vivo implicaria criar um novo mandato ou alterar um existente de formas que o MP não suporta sem afetar a integridade do ciclo.A alternativa disponível: se o cliente precisa de uma data de cobrança diferente, o fluxo é: cancelar a assinatura atual e assinar de novo. Ao criar uma nova assinatura, a primeira cobrança acontece na hora, o que estabelece uma nova data base para todos os ciclos seguintes. A Reval guia o cliente por esse processo a partir do portal.
O que significa: se um cliente assinou um plano mensal, ele não pode mudar para um plano bimestral ou semanal sem cancelar a assinatura atual.Por que essa limitação existe: a frequência de cobrança é um atributo imutável do mandato do Mercado Pago. Uma vez criado com periodicidade mensal, esse mandato sempre cobrará mensalmente. Não existe uma operação de “atualizar frequência” na API do MP.A alternativa disponível: cancelar a assinatura vigente e criar uma nova com a frequência desejada, pela página do produto. O cliente precisa informar os dados do cartão novamente, porque cada mandato precisa de um token novo.
O que significa: cada assinatura tem um único cartão associado. Você não pode configurar um segundo cartão como respaldo automático para quando o principal falhar.Por que essa limitação existe: o modelo de mandato do Mercado Pago não contempla cartões de respaldo. Cada mandato está vinculado a um único token de cartão. Gerenciar múltiplos cartões por mandato exigiria uma lógica de fallback que o MP não suporta nativamente e que introduziria uma complexidade operacional significativa.A alternativa disponível: não há fallback automático, mas o cliente pode trocar o meio de pagamento pelo portal em qualquer momento — inclusive durante as novas tentativas de uma cobrança recusada, antes de o mandato ser cancelado. E se o mandato já foi cancelado pelas cobranças falhadas, o portal oferece reativar a assinatura com um cartão novo (é criada uma assinatura nova com os mesmos produtos e endereço, a preço de tabela atual). A troca e a reativação exigem que o titular informe os dados do novo cartão (os tokens do Mercado Pago são de uso único e só podem ser emitidos com o titular presente), e por isso não podem ser feitas pelo admin em nome dele.

Estas limitações cobrem casos de uso específicos do ciclo de cobrança. Para todo o resto —pausar uma assinatura, retomá-la, trocar de produto, ajustar quantidades, adicionar itens de uma única vez, editar o endereço de entrega, trocar o meio de pagamento ou cancelar informando o motivo—, o portal de autoatendimento dá ao cliente controle completo sem precisar da sua intervenção.