Transfers

System Malfunction

Meaning: This generally means there was an unspecified error with the customer bank.
Solution: The transfer should be retried

Bank code is invalid

Meaning: The bank code passed does not exist or is invalid
Solution: Ensure that you're passing the correct bank code. Use the List Banks Endpoint to get the list of all available banks and their corresponding bank codes

Invalid 'from' date

Meaning: The 'from' parameter of your query is in the incorrect date format
Solution: Ensure you're passing the 'from' parameter in ISO 8601 format

Please provide a unique reference. Reference already exists on a transfer

Meaning: This reference has already been used on a prior transfer
Solution: Create a new reference for the new transfer

bank_code is required

Meaning: This endpoint expects that you pass a bank_code parameter in your API Request
Solution: Ensure that you're passing the correct bank code. Use the List Banks Endpoint to get the list of all available banks and their corresponding bank codes

You cannot initiate third party payouts as a starter business

Meaning: The Transfers product is only available to Registered Paystack businesses
Solution: You'll need to upgrade your business to a Registered Business.

Account number is required

Meaning: You need to pass a valid account number in your API Request
Solution: Ensure you're passing an account number

Sorry, we can't make the transfer to this recipient at the moment

Meaning: The account number of the recipient is on a fraud watchlist and transfers to that account have been disabled.
Solution: The customer should reach out to the bank and clear the issues raised.

You need to disable the OTP requirement to use this feature.

Meaning: OTP requirement has to be disabled to use the Bulk Transfers API
Solution: You'll need to disable the OTP for Transfers requirement from your Dashboard. You can find the Transfer Confirmation option under Settings -> Preferences and disable it

Your balance is not enough to fulfill this request

Meaning: You don't have sufficient funds in your Paystack balance to complete the transfer or refund request
Solution: Topup your Paystack Balance and try again.

Your reference contains illegal special characters

Meaning: The transfer reference passed to the API contains illegal special characters
Solution: Ensure that the reference contains only lowercase alphanumeric characters and the only special characters are hyphen ("-") and underscore ( "_")

Recipient specified is invalid

Meaning: The transfer recipient is not correct or the param name has a typo.
Solution: Provide a valid recipient. Ensure you are passing the recipient code in the recipient param

Account closed

Meaning: The customer's account has been closed by the bank
Solution: The customer should reach out to the bank if they did not close the account

Cannot resolve account

Meaning: The bank code and account number don't match
Solution: Use the Fetch Bank endpoint to get a list of banks and their respective codes. Also confirm that the account number is correct.

Transfer ID/code specified is invalid.

Meaning: You are trying to fetch a transfer with the wrong transfer ID or code
Solution: Kindly ensure you are using the right transfer ID or code

Your balance is not enough to fulfil this request

Meaning: This is a paid endpoint and you do not have sufficient funds in your Paystack balance to fulfill the request
Solution: You can use the Top Up option on your dashboard to add funds to your Paystack balance

Account number is invalid

Meaning: The account number provided is invalid
Solution: Please confirm the length and value of the account number provided.Also check the bank code provided belongs to the correct bank.

Invalid entries found

Meaning: The reference parameter contains unsupported characters.
Solution: Checkout the Transfer Docs on supported characters that are allowed.

Transfer not found

Meaning: No transfer could be found with this transfer code
Solution: Ensure that you're passing the id or code of a transfer that exists on this integration

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.