Charge

Charge attempt cannot be fulfilled until X minutes

Meaning: You're trying to charge a card that has been regulated. If a card fails 10 consecutive times across Paystack businesses, the card will be regulated and can only be charged once every twenty-four hours until there’s a successful transaction.
Solution: Wait for the indicated time period (represented by X above) before attempting to charge the card again

Amount must be an integer

Meaning: Amount must be a positive integer (a whole number greater than zero, but not a fraction or decimal fraction)
Solution: Ensure that you're passing your amount correctly. It should be a number greater than zero, with no decimal places

Watch your spending. Amount cannot be processed online... (What did you expect?).

Meaning: You're attempting to charge the customer an amount that is above the allowed limit fortransactions on Paystack
Solution: Reduce the amount you're attempting to charge the customer

Too many attempts. You have to wait for X minutes to try again

Meaning: You have provided the incorrect OTP too many times, so have to wait the specified amount of time before trying again
Solution: Wait the specified amount of time (represented by 'X' above) and try again with the correct OTP

Duplicate charge request for reference

Meaning: You're attempting to use a transaction reference that has previously been used for a transaction
Solution: Try and create the Transaction or Charge with a new reference

Currency not supported by merchant

Meaning: The currency you're attempting to charge in is not enabled for this integration
Solution: Ensure you're passing the currency code for a currency enabled on your integration

Provided registration token is invalid

Meaning: The OTP provided for the mobile money transaction is incorrect
Solution: Show the error to the customer and ask for correct OTP.

One of Authorization code, card object, bank object, ussd object, mobile money object, qr object, or EFT object should be passed.

Meaning: You've attempted to create a charge without passing an object to charge
Solution: Pass an authorization code, Card object, Bank object, USSD object, Mobile Money object, QR object, or EFT object

Email address is required to create charge

Meaning: You need to pass a valid email address when attempting to create a charge
Solution: Ensure you're passing the email parameter when creating the charge

Please wait a few minutes and try again.

Meaning: You've been rate-limited. This means you've made too many API requests in a short timeframe.
Solution: Wait a few minutes and try the API call again

PIN must be of length: 4

Meaning: The card PIN must be a 4 digit code
Solution: Validate the length of the PIN from the customer before passing it to the charge API

Please pass card cvv for validation

Meaning: Card CVV is required to charge a card
Solution: Pass the CVV to the API when attempting a charge

Please pass card number to charge

Meaning: The card number is missing to complete a charge
Solution: Provide the appropriate card number we want to charge

Email address does not match authorization code

Meaning: You are using a different email that belongs to an authorization code
Solution: Ensure that you're passing the right email associated with the authorization code

Expired Card

Meaning: The customer card you're trying to charge is no longer valid
Solution: Inform the customer to try another card

Email does not match Authorization code. Authorization may be inactive or belong to a different email. Please confirm.

Meaning: The email provided does not correspond to the authorization code provided.
Solution: Verify that the authorization code being passed belongs to the email address you're passing

Sample generic error

1{
2  "status": "false",
3  "message": "[string]"
4}

Not sure where to look? Try search

Type the error or keywords into the search bar above. If you don’t find what you’re looking for, contact us, we’re happy to help.