System errors
System errors occur when there is an issue with the payment gateway used to process the transaction. It also includes timeouts, connection failures and Paystack errors. We’ve highlighted the most common system errors customers experience.
Error message | What it means | How to resolve |
An unknown error has occurred, please contact system administrator | This error means there was a downtime when the transaction was attempted. | You can have the customer retry the transaction later or escalate to the Paystack support team (via email at support@paystack.com or our contact form) if the error persists. |
Customer is blacklisted | This means that Paystack or a Paystack business has blacklisted the customer due to suspicious activity. | Kindly escalate this to the Paystack support team (via email at support@paystack.com or our contact form. |
Currency not supported | This means you are trying to charge them in a currency that your business on Paystack is not enabled for. | If you would like to process payments in other currencies, you will need to ensure the currency is available for your business and then make a request for it to be activated. |
Denied by Fraud System or Blocked by fraud system | This error means that the customer's transaction attempts have been denied by our fraud prevention system due to certain activities surrounding their transaction attempt. | The error typically clears after 24 hours so that they can retry the transaction exactly 24 hours after the last transaction attempt. |
Either remote server cannot be reached or the network connection was reset/broken | This means we were experiencing a downtime when the customer attempted the transaction. | They can retry the transaction later or escalate to the Paystack support team (via email at support@paystack.com or our contact form) if the error persists. |
Error, please try again | This means there was a bank or processor downtime when the transaction was attempted. | You can have the customer retry the transaction later and escalate to the Paystack team if the error persists. |
E5015: Merchant [PAYSTACK PAYMENTS LTD] does not support currency [USD] | This means that we do not route USD payments to the processor used for the transaction. | Kindly escalate this error to the Paystack support team (via email at support@paystack.com or our contact form) if the error persists. |
Failed | This means that the transaction failed due to a network or processor downtime. | Please have the customer ensure they're using a strong network connection and retry the transaction later or escalate to the Paystack support team if the error persists. |
Invalid Merchant selected | If your customers are getting an 'Invalid Merchant selected' error when trying to make payments, it means you haven't properly entered your API keys while setting up your website. | To resolve this, kindly follow these steps:
|
Merchant is not enabled for international transactions | This means that your business cannot receive international transactions via Paystack, and your customer is trying to pay you using an international card. | You'll need to make a request for your business to be enabled for International Payments. |
Pay with Bank is not available at this time | This is a Paystack-generated error. | The customer needs to retry the transaction later or escalate to the Paystack team if the error persists. The customer can also use alternative channels on the checkout to complete the transaction. |
Pay with Bank is not available at this time | This is a Paystack-generated error. | The customer needs to retry the transaction later or escalate to the Paystack team if the error persists. The customer can also use alternative channels on the checkout to complete the transaction. |
This cardholder has defaulted | This response implies that Paystack has tried to charge the customer's card multiple times, and it has returned an "insufficient funds" error. | Please advise your customer to fund their card and retry the transaction after a 24-hour window. If you're attempting the charge from your end, please advise the customer to fund their card and retry it after 24 hours. |
The transaction could not be processed at this time, please try again later | This error means there was a downtime as of when the transaction was attempted. | The customer needs to retry the transaction later or escalate to the Paystack support team if the error persists. |
Timed out | This error typically occurs when we are unable to validate the outcome of a transaction. | Kindly advise your customer to wait for a few minutes and retry the transaction. |
Transaction Not Completed | This means that the transaction could not be completed for various reasons. It could be due to downtime or due to incorrect transaction information. | The customer needs to retry the transaction later or escalate to the Paystack support team if the error persists. |
Transaction not Found | This error is most often generated when we try to requery (determine the final status — whether successful or failed — of a transaction) a transaction that was attempted during a period when a processor is experiencing a timeout. | The customer will need to retry the transaction at a later time. |
Unable to conclude transaction | This error means there was a brief downtime as of when the transaction was attempted. | The customer needs to retry the transaction later or escalate to the Paystack support team (via email: support@paystack.com or our contact form) if the error persists. |
Unable to process transaction | This means that the customer has either used multiple cards to attempt the transaction in a short period of time, or their transaction attempts have failed multiple times in a short period of time, and our fraud prevention system has hotlisted their card. | The hotlist typically clears after 24 hours so that the customer can retry the transaction from 24 hours after the last transaction attempt. |
Unrecognized card type. Please try again with a Mastercard, Verve or VISA | This means that the customer used a card that isn't acceptable on Paystack. Currently, Paystack only supports transactions attempted with Verve, Mastercard and Visa cards. | The customer will need to retry the transaction with a Mastercard, Verve card or VISA card. |
Unspecified Failure | This means the transaction cannot be completed at that time due to downtime. | The customer needs to retry the transaction later or escalate to the Paystack support team (via email: support@paystack.com or our contact form) if the error persists. |
Specific system errors
'Charge attempt cannot be fulfilled' error
If you are getting a 'Charge attempt cannot be fulfilled' error, it means that Paystack's Regulator is blocking that transaction.
Regulator is a charge restriction placed on cards whose transactions have failed consecutively. It’s our way of promoting a fair use policy around how our customers are charged.
Once a card fails ten consecutive transaction attempts on Paystack, the card will be regulated and can only be charged once every twenty-four hours until there's a successful transaction.
If a Paystack business tries to charge a card that has been regulated, the error message below will be returned:
{
"status": false,
"message": "Charge cannot be fulfilled until {time} minutes"
"data": {
"retry_by": "2020-05-01 5:00:00"
}
}
However, if a regulated card is charged successfully, the regulation on the card is reset. This means if nine failed transaction attempts are carried out on a card, and the tenth one is successful, then it will be reset.
For example, if Business A carries out ten failed attempts on a card and Business B wants to charge the card, then Business B has a chance to try the card once. If the charge attempt from Business B works, then the regulation is reset. But if the charge attempt fails, then the card won’t be charged again until another twenty-four hours.
Regulator works only for recurring card transactions. It doesn't affect first-time transactions on Paystack.
Please feel free to reach out to us via email at support@paystack.com or via our contact form if you need any more help.