MasterCard: Campo MAC

Merchant Advice Code — código complementar de recusa para orientar retentativas.

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.

A Mastercard disponibilizou o recurso MAC (Merchant Advice Code) para auxiliar na gestão de tentativas de pagamento não autorizadas. Este código complementa o código de recusa da Abecs e indica se transações podem ser retentadas após uma recusa ou se a recusa é definitiva.

Implementação

O campo foi implementado em novembro de 2023 e está disponível exclusivamente para clientes no modelo Gateway. A Pagar.me incluiu o objeto retry_info nas respostas de autorização com informações específicas baseadas na adquirente utilizada.

Formatos por adquirente

Rede, PagSeguro, Cielo, SafraPay e Getnet

O campo brand_failure_return_code retorna códigos MAC como:

Código 3 — Não Tente Novamente (Irreversível)
Código 21 — Cancelamento de Pagamento (Irreversível)
Códigos 24-30 — Instruções de retentativa em períodos específicos para insuficiência de fundos (Reversível)

Stone

Implementa dois campos:

transaction_date_limit — quantidade de vezes possível retentar
transaction_limit — data limite para retentativa

Conformidade obrigatória

A conformidade com estas regras é obrigatória para evitar multas por excesso de retentativas das bandeiras.