Response codes

When a payment cannot be completed, Afara returns a response code and a message. This page explains the codes in plain language.

The response code tells you whether the request worked. It is not the same as the status of the payment itself. To know if a payment succeeded, check its status.

Card payment codes

Every code in this table starts with PAY_ENG_, for example PAY_ENG_005.

Code	Name	What it means
`00`	SUCCESS	The request worked.
`001`	PAYMENT_STILL_IN_PROGRESS	The payment is still being processed. Wait and check again.
`002`	TRANSACTION_REFERENCE_USED	This reference has already been used. Use a new, unique reference.
`003`	FRAUD_DETECTED	The payment was stopped by fraud checks.
`004`	NO_VALID_RESPONSE_FROM_CARD_SERVICE	The card service did not respond. Try again.
`005`	UNABLE_TO_CREATE_MASTER_CARD_SESSION	A card session could not be started. Try again.
`006`	UNABLE_TO_UPDATE_MASTER_CARD_SESSION	The card session could not be updated. Try again.
`007`	FAILED_TO_INITIATE_MASTER_CARD_AUTHENTICATION	Card authentication could not be started.
`008`	INVALID_PROCESSOR	The payment processor is not valid for this request.
`009`	TRANSACTION_FAILED	The payment failed.
`010`	SECURE_3D_AUTH_FAILED	The customer did not pass 3-D Secure authentication.
`011`	USSD_PENDING	A USSD payment is waiting for the customer to approve it.
`012`	VIRTUAL_PENDING	A bank transfer payment is waiting for the customer’s transfer.

Payment link and checkout codes

Every code in this table starts with PAY_ENG_WEB_, for example PAY_ENG_WEB_005.

Code	Name	What it means
`00`	SUCCESS	The request worked.
`001`	INVALID_PAYMENT_LINK_REF	The payment link reference is not valid.
`002`	PAYMENT_LINK_EXPIRED	The payment link has expired.
`003`	PAYMENT_LINK_USED	The payment link has already been used.
`004`	INVALID_PAYMENT_CODE	The payment code is not valid.
`005`	API_KEY_NOT_FOUND_FOR_MERCHANT	No API key was found for this merchant.
`006`	INVALID_API_KEY	The API key is not valid. Check you copied it in full.
`007`	TRANSACTION_NOT_FOUND	No payment was found for this reference.
`008`	FEE_CONFIGURATION_NOT_DONE	Fees have not been set up yet. Contact support.
`009`	FEE_CONFIGURATION_NOT_DONE_FOR_PROCESSOR	Fees are not set up for this payment processor.
`010`	INVALID_AMOUNT	The amount is not valid. Remember it is in kobo.
`011`	BANK_USSD_CODE_NOT_FOUND	No USSD code was found for this bank.
`012`	BANK_USSD_CODE_PROFILE_NOT_DONE	USSD is not set up for this bank.
`013`	SUB_MERCHANT_NOT_FOUND	The sub-merchant was not found.
`014`	QR_CODE_NOT_GENERATED	The QR code could not be created.
`015`	NQR_MERCHANT_ACCOUNT_NOT_CREATED	The QR merchant account is not set up.
`016`	PAYMENT_ATTEMPT_NOT_FOUND	The payment attempt was not found.
`017`	INVALID_PAYMENT_ID	The payment ID is not valid.
`018`	OPERATION_NOT_SUPPORTED	This action is not supported.
`019`	TRANSACTION_NOT_INITIALIZED	The payment has not been started yet.
`020`	UNABLE_TO_TOKENIZE_CARD	The card could not be securely stored for this payment.
`021`	FEE_CONFIGURATION_NOT_DONE_FOR_MERCHANT	Fees are not set up for your account. Contact support.
`022`	NETHONE_EMAIL_NOT_FOUND	The customer email needed for fraud checks was not found.
`023`	NETHONE_WEB_PROFILING_PENDING	Fraud profiling is still running. Try again shortly.
`024`	PAYMENT_PROGRESS_ALREADY	A payment is already in progress for this order.
`025`	PAYMENT_ATTEMPT_THRESHOLD_REACHED	Too many attempts were made for this payment.
`026`	AFRIGO_PROCESSOR_NOT_ACTIVE	This payment processor is not currently active.

The plain-language meanings above are written from the code names. If one does not match what you see in practice, please tell us so we can correct it.

Get started

Payment widget

Accept payments

Test and go live

Card payment codes

Payment link and checkout codes

​Card payment codes

​Payment link and checkout codes

Card payment codes

Payment link and checkout codes