Now self-serveAccess PayOS data to make better payment decisions, no sales call needed.Start building →
‹Card Data

Merchant Advice Codes

Issuer declines carry an instruction: update credentials, retry later, or stop. PayOS surfaces it.

Start using PayOS, pay per use. No sales call required.

What a Merchant Advice Code tells you.

Authorization response
Response05 · Do not honor
Merchant advice01
MeaningNew account info
→Update credentials, then retry
MAC 01
New account information
Update the stored credential, then retry.
MAC 02
Cannot approve at this time
Retry later, on a schedule.
MAC 03
Do not try again
Stop. Retrying may incur network fees.
MAC 21
Payment cancellation
The cardholder stopped the recurring payment.

Merchant Advice Codes before authorization.

STEP 1
Stored card
Visa •••• 4242
STEP 2
PayOS check
Before the authorization
STEP 3
MAC 01 found
New account information
STEP 4
Credential updated
Authorization approved

Decide with confidence.

Fewer excessive retries
Stop retrying cards the issuer will not approve.
Higher approval rates
Update credentials before you authorize.
Network program alignment
Supports Mastercard excessive-retry program requirements.
Smarter retry timing
Retry when the issuer says to, not on a fixed schedule.

Merchant Advice Codes across your stored cards.

STORED CARDS · 12,480
No advice code
Ready to charge
68%Charge
MAC 01
Update credentials
14%Refresh
MAC 02
Retry later
11%Schedule
MAC 03 / 21
Stop retrying
7%Stop
BEFORE YOUR NEXT BILLING RUN
Know which cards to charge, refresh, reschedule or stop.
Illustrative portfolio. Your mix will vary.