Home / Wiki / M / Merchant Advice Code (MAC)

Merchant Advice Code (MAC)

Cards and IssuanceUpdated 16 Nov 2026

A merchant advice code (MAC) is a value that Mastercard adds to the response for a declined card transaction, telling the merchant whether and when it may try again. It sits alongside the issuer's decline code, which says why the payment failed, and matters most for recurring payments and card-on-file charges such as subscriptions. Widely used values include 01 (new account information available), 02 (cannot approve now, try again later), 03 (do not try again) and 21 (the cardholder has cancelled the recurring payment). Visa gives similar guidance through decline categories.

Merchants are expected to follow the advice: stop after a hard decline, refresh card details through a card account updater, and space out attempts after a soft decline. The networks limit how often a declined transaction may be resubmitted and charge excess retry fees when merchants go over, so payment teams build MAC handling into their retry logic.

Last updated 16 Nov 2026