API Reference

Mondia Pay Gateway Errors

In the case of any errors in the response of a request, the response body will always include metadata about that specific error. Whenever an error is returned in the redirect URL, the error metadata is always part of the query parameter.

Below is a table showing all the Errors, HTTPStatus and HTTP Codes that you might receive, along with a Generic Description to help you in mapping the error.

HTTP Status CodeHTTPStatusStatus/ErrorGeneric Description
400BAD_REQUESTAMOUNT_NOT_VALIDInvalid Charge Amount
400BAD_REQUESTINVALID_MSISDNInvalid msisdn
400BAD_REQUESTINVALID_PARAMETERSInvalid Parameters
400BAD_REQUESTPURCHASE_REQUEST_NOT_VALIDPurchase request not valid (might have been expired)
400BAD_REQUESTVOUCHER_NOT_VALIDInvalid Voucher
401UNAUTHORIZEDINCORRECT_OTPIncorrect OTP
402PAYMENT_REQUIREDINSUFFICIENT_FUNDSUser doesn't have sufficient balance
403FORBIDDENAUTHORIZATION_FAILEDAuthorization Failed
403FORBIDDENEXPIRED_OTPOTP has expired
403FORBIDDENPAYMENT_TEMPORARILY_BLOCKEDUser is temporarily blocked from any further payment, most likely because of an existing payment transaction in progress
403FORBIDDENPERMISSION_DENIEDPermission denied
403FORBIDDENUSER_BLOCKED_BY_PROVIDERUser is blocked by provider
403FORBIDDENUSER_DECLINED_PURCHASE_DURING_CONFIRMATIONUser declined purchase during confirmation
403FORBIDDENUSER_IS_BLACKLISTEDUser is blacklisted
403FORBIDDENUSER_IS_BLOCKEDUser is blocked
403FORBIDDENUSER_NOT_ACTIVEUser not active
403FORBIDDENUSER_NOT_ELIGIBLEUser not eligible for the service
404NOT_FOUNDNO_SUBSCRIPTION_FOUNDNo subscription found for the user {0} for the subscription type id {1}
404NOT_FOUNDSUBSCRIPTION_ATTRIBUTES_NOT_FOUNDSubscription attributes not found
404NOT_FOUNDUSER_NOT_FOUNDUser not found
409CONFLICTALREADY_SUBSCRIBED_IN_SAME_GROUPUser already subscribed in different service under this product
409CONFLICTSUBSCRIPTION_STATE_NOT_VALIDSubscription {0} has an invalid state {1}
409CONFLICTUSER_ALREADY_SUBSCRIBEDUser already subscribed
409CONFLICTVOUCHER_ALREADY_REDEEMEDVoucher Already Redeemed
500INTERNAL_SERVER_ERRORCHARGING_ATTEMPT_TECHNICAL_FAILUREcharging attempt failed
500INTERNAL_SERVER_ERRORPROVIDER_IDENTITY_TYPE_IS_MISSING_FOR_USERUser {0} doesn't have the specified provider identity type {1}.
500INTERNAL_SERVER_ERRORUNKNOWN_ERRORUnknown Error
501NOT_IMPLEMENTEDWIFI_AUTHENTICATION_NOT_AVAILABLEWiFi authentication not available, please switch on mobile network & try again.
502BAD_GATEWAYCAPPING_LIMIT_EXCEEDEDCapping limit exceeded
502BAD_GATEWAYPIN_LIMIT_EXCEEDEDPin limit exceeded
502BAD_GATEWAYPROVIDER_API_FAILUREProvider API Failure
502BAD_GATEWAYPROVIDER_PAYMENT_FAILEDProvider payment failed
502BAD_GATEWAYGENERIC_FAILUREGeneric Error
504GATEWAY_TIMEOUTPROVIDER_API_TIMEOUTProvider API Timeout
502BAD_GATEWAYPROVIDER_PAYMENT_REJECTEDProvider payment rejected