Merchant Advice Codes

Galileo supports the use of Mastercard’s merchant advice codes (MACs) to help reduce the number of declined recurring transactions for you or your issuer. The MAC contains information about the actions a merchant needs to take.

Galileo supports the following MAC codes:

MACDescriptionTrigger
03Do not try againAn account is closed and the associated PAN should not be reused or re-opened for the next 120 days.
40The card used is a non-reloadable prepaid cardA non-reloadable prepaid card is used.
41The card is a single-use virtual cardA single-use virtual card is used.
43Useful to inform about specific card types. Indicates that the card used is a multi-use virtual cardA multi-use virtual card (not generated by Mastercard) is used. Only valid for account-status inquiry transactions.

MAC 40 and 41 are important to prevent the storage of card information (card on file) for future transactions, ultimately reducing the likelihood of declines.

To receive MAC decisioning via the Auth API, the GMACD product parameter must be set to Y. In the Auth API payload, merchant_advice_code will contain one of the supported MACs: 03, 40, 41, 43. The field is blank for all other types of transactions.

Contact Galileo if you are interested in enabling MACs for your program.

Override the merchant advice code

You have the option to override the suggested MAC using the Auth API. To override, the MACO product parameter must be set. You provide the new MAC value in merchant_advice_code in the Auth API response.

By choosing to override, you assume the responsibility for ensuring compliance with the MAC program requirements.

Contact Galileo if you are interested in enabling overrides.


Galileo Financial Technologies, LLC 2024

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of Galileo Financial Technologies, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of Galileo Financial Technologies, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.