Recommendation codes
Last updated: August 9, 2023
Recommendation Codes provide additional information on how and when you should retry a transaction.
The following table shows the Checkout.com recommendation codes you might receive in a response. These codes apply to all schemes.
Information
You can simulate recommendation code outcomes to test your integration.
| Recommendation code | Recommendation summary | Possible reasons for decline |
|---|---|---|
01 | Updated or additional information required |
|
02 | Try again later |
|
03 | Do not try again |
|
An issuer may decline a recurring payment due to the payment card being expired, being reported lost or stolen, or having insufficient funds. If this happens, the issuer sends a merchant advice code in the response, in the processing.partner_merchant_advice_code field.
The code contains additional details about the reason for the decline, as well as the actions you can take to ensure you can continue to serve recurring payment customers.
Partner merchant advice codes offer more options than the standard recommendation codes, making it easier to carry out analysis. For example, if you're using more than one payment service provider (PSP), they can save you from having to map a standard recommendation code to the PSP's recommendation code.
To activate this feature, contact your Account Manager.
Information
Only transactions processed with MasterCard will return a partner_merchant_advice_code value.
| Recommendation code | Recommendation summary | Possible reasons for decline |
|---|---|---|
24 | Retry after one hour |
|
25 | Retry after 24 hours | |
26 | Retry after two days | |
27 | Retry after four days | |
28 | Retry after six days | |
29 | Retry after eight days | |
30 | Retry after 10 days |