Your Fincra account can be used to send money across different countries and currencies. Fincra provides different options to match your use case. With Fincra you can transfer to bank accounts, mobile money wallets, and other Fincra accounts.

Learn how you can make payments to:

Local Payout vs Cross Border Payout

The Payout API lets you transfer money to an account in the same currency as well as to an account in a different currency. Both bank account transfers and mobile money transfers have this feature available.
You can perform these transfers both through your portal and using the API.

Learn how you can make :

Making Payouts On Your Portal

You must have a Fincra account in order to make payments from your portal. After successfully registering, all you have to do is navigate to the payout tab of the portal and make the payout. The video below will walk you through all you need to know about making payments on your portal.

Making Payouts Using Payout API

If you are technically savvy and can code in any programming language, all you have to do is follow the payment instructions to:

Note: As you can see in the video, when you try to make payments using the payout API, we ask for information such as payout schemes and destinations. In the following section, we will go over payment schemes and payment destinations in detail.

Payment Destination

This is the type of account you want to send your payments to. Find the payment destinations we currently support at Fincra below

Payment destinationAPI value
Bank accountsbank_account
Mobile money walletmobile_money_wallet
Fincra Accountwallet
Cash PickUpcash_pick_up

List Of Currencies Supported For Payouts

Please read this section to access all currencies to which you can make payouts.

Payout Status

A Payout request can have any of the statuses we support on Fincra. Please see the table below for more descriptions of the statuses we support.

๐Ÿ“˜

Note

Kindly update your transactions status ONLY when you get the below status explicitly from our end. Any other status should be disregarded.

S/NstatusDescription
1successfulThe payout is successful
2processingThe payout is neither successful or failed
3failedThe payout has failed

Payout Errors

Below are lists of errors that can be encountered on calling 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
QUOTE_NOT_GENERATEDError occurred while generating a quotePlease retry the request
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

Beneficiary Types

A beneficiary is a person or organization whom you want to send money or make payments to

Beneficiary TypeDescription
individualAn individual that is the sole beneficiary of the payment.
corporateAn organization or company that is the sole beneficiary of the payment.