Not all payments will succeed - they may fail for a variety of reasons, such as insufficient funds, a billing address that doesn't match, the card has been blocked, etc. Asperato will sanitise all error responses across payment service providers to one of a set of values. This enables you to easily automate different flows off the back of specific failure reasons, rather than failures in general.
The sanitised responses we currently support are listed here:
| NOT_COMPLETED | The payment gateway authorisation screen was not completed correctly. |
| DECLINED | Transaction declined, a reason was not given. Please try again. If no luck, try a different payment method. |
| DECLINED_AUTH_NOT_FOUND | A repeat payment was attempted using an authorisation, but the gateway did not have a record of this authorisation. |
| DECLINED_NAME | Transaction declined, a valid name was not provided. |
| DECLINED_FRAUD | Transaction declined. A reason was not given. |
| DECLINED_AVS | Declined, billing address does not match the address held by the bank. Please check the address entered. |
| DECLINED_AVS_MISSING_INFO | Declined, required billing information not specified. Please check you have completed all required fields. |
| DECLINED_ABA | Declined, routing number was incorrect |
| DECLINED_CARD_DETAILS | Declined, card details were incorrect. Please check the card details entered. If the problem persists please contact your card issuer or try a different payment method. |
| DECLINED_MANDATE_ERROR | Mandate is failed, cancelled or expired |
| DECLINED_DUPLICATE | Declined, duplicate transaction. Please do not try again as payment has most likely already been collected. Please contact the company you are trying to make payment to. |
| DECLINED_CV2 | Declined, card security code was incorrect. Please check the last 3 digits on the reverse of card and try again. |
| DECLINED_ISSUE | Invalid issue number. Please check and try again. If the problem persists please contact your card issuer. |
| DECLINED_START_DATE | Declined, start date is in the future. Please enter a start date that is in the past. |
| DECLINED_EXPIRY_DATE | Declined, card expired. Please use a different card or contact your bank. |
| DECLINED_INVALID_AMOUNT | Declined, invalid amount. Please check the amount and try again. If the problem persists, please contact the company you are trying to make payment to. |
| DECLINED_INVALID_EMAIL | Declined, the email address is mandatory and a valid one was not provided. Please try again and enter your email address. |
| DECLINED_UNSUPPORTED_CARD_TYPE | Declined, the card you used isn't supported. Please try with a different card or contact the company you are trying to make payment to. |
| DECLINED_WRONG_CARD_TYPE | Declined, the card type you specified does not match the card number. Please check the card details entered. |
| DECLINED_UNSUPPORTED_CURRENCY_TYPE | Declined, the currency you used isn't supported. |
| DECLINED_UNSUPPORTED_CURRENCY_TYPE_ASP | Declined, no payment service provider has been set up for this currency. |
| DECLINED_AMOUNT_TOO_LARGE | Declined, the amount is too large. |
| DECLINED_INSUFFICIENT_FUNDS | Declined, there are insufficient funds on this account. |
| DECLINED_PAYER_DECEASED | Declined, this account belongs to someone who is deceased. |
| DECLINED_GATEWAY_ERROR | Declined, the gateway encountered an error. Please try again in a few minutes. If the problem persists, please contact the company you are trying to make payment to. |
In addition we also provide you with the RAW PSP response messages form each PSP.
Asperato passes through the raw response message from connected Payment Service Providers. This provides further detail in understanding the outcome of payments / authorisations.
This is not seen as a replacement for our sanitised error codes and responses.
To enable:
Update the Payment object -> Page Layout
Add field “Raw Error Message from PSP”
Update the Authorisation object -> Page Layout
Add field “Raw Error Message from PSP”
Update the Refund object -> Page Layout
Add field “Raw Error Message from PSP”