System errors

Edited

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.
By default, your business is enabled for the official currency of your country.
For example, NGN is the default currency for Nigerian businesses, and GHS is the default currency for Ghanaian businesses.

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.
If the error persists after waiting for 24 hours to retry the transaction, kindly reach out to the Paystack support team for further assistance.

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.
This could have happened by putting in the wrong API keys or putting in the Secret Keys in place of the Public Keys.

To resolve this, kindly follow these steps:

  1. Simply go to your Dashboard settings and click on the API Keys & Webhooks tab.

  2. Copy your API keys, noting the Public and Secret Keys (Live Keys if your website is Live).

  3. Replace them on the payment settings on your website or app, placing the correct key in the correct field.

  4. If using the API, ensure only the ‘pk_domain_xxxxxx’ part of the public key is used. Do not append anything to the string.

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.
It happens when a customer tries to use the Pay with Bank option at checkout, but the service is temporarily down.

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.
It happens when a customer tries to use the Pay with Bank option at checkout, but the service is temporarily down.

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.
The customer can also use alternative channels on the checkout to complete the transaction.

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.
This error will appear as 'Denied by Fraud System' on your dashboard.

The hotlist typically clears after 24 hours so that the customer can retry the transaction from 24 hours after the last transaction attempt.
If the error persists after waiting for 24 hours to retry the transaction, kindly reach out to the Paystack support team (via email at support@paystack.com or our contact form) for further assistance.

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.
We also support American Express cards for businesses in South Africa and Nigeria.

The customer will need to retry the transaction with a Mastercard, Verve card or VISA card.
Alternatively, the customer can try another payment channel on the checkout.

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.
The customer can also use alternative channels on the checkout to complete the transaction.

 

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.