Payout Errors

This page contains the errors that you can encounter while using Fincra Payout Endpoints

Error TypeMessageAction to take
NO_ENOUGH_MONEY_IN_WALLETYou don't have enough money in your wallet to make this payoutPlease ensure your balance is funded and retry the payout
INVALID_QUOTEInvalid quote suppliedPlease generate a new quote and retry the payout
RESOURCE_NOT_FOUNDPayout not foundPlease requery the transaction until you get a definitive response status(processing, failed, successful) from Fincra
RESOURCE_NOT_FOUNDQuote not found. Kindly do a re-quote to continuePlease re-generate a new quote and re-initiate the payout.
QUOTE_NOT_GENERATEDError occurred while generating a quotePlease retry the request
TOO_MANY_REQUESTSThe volume of requests sent to the endpoint has exceeded the limit( 200 transaction requests per second per merchant).Kindly ensure that you are not sending over 200 transaction requests per second.
DUPLICATE_CUSTOMER_REFERENCECannot continue, Duplicate Customer Reference PassedPlease retry the request with a unique customer reference
UNPROCESSABLE_ENTITYQuote Reference not specified, Kindly generate a quote first to continue.Happens when you initiate a cross-currency payout. Please generate a quote first and supply the reference when re-initiating the payout
UNPROCESSABLE_ENTITYDestination currency (${destinationCurrency}) not supportedplease check the API documentation for supported currencies you can payout to
UNPROCESSABLE_ENTITYPayment destination ${paymentDestination} not supported for currency ${destinationCurrency}, kindly supply a valid payment destination.please check the API documentation for supported payment destinations
UNPROCESSABLE_ENTITY${currency} currency not supportedplease check the API documentation for supported currencies
UNPROCESSABLE_ENTITYBeneficiary country is requiredHappens when you initiate an international payout. Please supply the beneficiary country in the payload
SERVICE_UNAVAILABLEError occurred during operation. Please try again later.Please requery the transaction until you get a definitive response status(processing, failed and successful) from Fincra
INTERNAL_SERVER_ERRORError occured during operation. We're currently checking why this is happening.Please requery the transaction until you get a definitive response status(processing, failed and successful) from Fincra
VALIDATION_FAILEDValidation failedplease re-check the request payload sent for validation error and try again
ACCESS_DENIEDAccess denied to requested resourcePlease contact Fincra support team
OPERATION_FORBIDDENOperation forbiddenPlease contact Fincra support team