Bandeiras

Regras regulatórias e particularidades por bandeira na Pagar.me v5.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da Pagar.me v5 (versão clássica). Para projetos novos, explore o API Catalog.

Regras regulatórias exigidas pelas bandeiras

As bandeiras (Visa, Mastercard, Amex, Elo, Hipercard, Diners) impõem regras específicas para validação, captura, parcelamento e disputas. Consulte cada subpágina para detalhes.

Particularidades por bandeira

Visa

  • Novo prazo para captura: transações pré-autorizadas devem ser capturadas em até 7 dias (antes era 30).
  • Programa de Retentativa: retentativas devem respeitar o intervalo mínimo determinado pela rede.

Mastercard

  • MCC validado: transações com MCC inválido para o seller são recusadas.
  • Card Updater: suportado nativamente.

Amex

  • Identificador de modelo de negócio: envio obrigatório no momento do cadastro do sublojista.
  • Enquadramento de tiqueteiras: modelo específico para venda de ingressos.

Elo / Hipercard / Diners

  • Captura e estorno suportados, sem regras específicas adicionais.

Funcionalidades relacionadas

  • Programa de Retentativa das Bandeiras — reprocessamento automático conforme regras.
  • Regra de validação de MCC — verificação do Merchant Category Code antes de submeter à rede.
  • Token de bandeira — tokenização específica por rede para wallet/recurring.
  • Banco Central — exigências do Bacen para arranjos de pagamento.
Migração para a API Unificada

A Stone aplica essas regras automaticamente — você raramente precisa conhecer todos os detalhes. Para casos específicos, abra um chamado no Suporte ou consulte o time técnico via Stone Partner Tech.