Error Types
ACCOUNT_ALREADY_SETTLED
Description The following scenarios could have occurred:
- A confirmation message was received for a transaction that has already been confirmed.
- A request was received but the amount has already been paid.
Action Required No action required.
CARD_EXPIRED
Description The entered card number has expired on the upstream entity's system.
Action Required Use an alternative card number or payment method.
DECLINED_BY_MNO
Description The MNO has declined the transaction based on a business rule.
Action Required Check the errorMessage, detailMessage, providerErrorCode and providerErrorMsg in the response payload for more details. If more information is required, then contact Electrum.
DO_NOT_HONOR
Description The upstream entity has declined the transaction due to certain business rules.
Action Required Check the errorMessage, detailMessage, providerErrorCode and providerErrorMsg in the response payload for more details. If more information is required, contact Electrum.
DUPLICATE_RECORD
Description A message was received with the exact same id as a previously processed transaction.
Action Required Ensure that the originating system assigns a unique id to each transaction transaction.
FORMAT_ERROR
Description The system is unable to interpret one or more components in the message due to incorrect formatting.
Action Required Ensure that the message payload conforms to the API specification and retry the transaction.
FUNCTION_NOT_SUPPORTED
Description The API call used is not supported for the service provider.
Action Required If this occurs in response to a purchase trial, then the service provider doesn't support validation of consumer details. In this case the originating system may still carry on with the purchase.
GENERAL_ERROR
Description An issue is encountered that cannot be described by any of the other error codes.
Action Required Check the errorMessage, detailMessage, providerErrorCode and providerErrorMsg in the response payload for more details. If more information is required, then contact Electrum.
INCORRECT_PIN
Description The PIN number used for the transaction is incorrect.
Action Required Ensure the details of the PIN are being set correctly in the request.
INSUFFICIENT_FUNDS
Description The consumer does not have sufficient funds in their account to proceed with the transaction.
Action Required Use a different card number or payment method.
INVALID_AMOUNT
Description The amount value for the transaction falls outside the limits set by the service provider.
Action Required Ensure the amounts.requestAmount.amount field is within the service provider's limits and retry the transaction.
INVALID_AN32_TOKEN
Description The 32 alphanumeric character token to tender for the transaction entered does not match any token in the upstream entity's system.
Action Required Ensure that the paymentMethods.token field is being set to a valid payment token.
INVALID_CARD_NUMBER
Description The card number entered does not match any number in the upstream entity's system.
Action Required Use an alternative card number or payment method.
INVALID_LOYALTY_CARD
Description The loyalty card number entered does not match any number in the upstream entity's system.
Action Required Use a different loyalty card number.
INVALID_MERCHANT
Description The merchant at which the transaction originated was not recognised by the service provider.
Action Required Ensure that the originator.merchant.merchantId field has been set correctly. If the problem persists, then contact Electrum.
INVALID_MSISDN
Description The MSISDN in the request does not match the MNO in the request, is an invalid number, or the MSISDN does not allow for top-ups.
Action Required Retry using a different value for recipientMsisdn.msisdn.
INVALID_PRODUCT
Description The product does not exist in the service provider's system, has expired, or is not available to the particular MSISDN.
Action Required Use an alternative product in the product field.
LIMIT_EXCEEDED
Description The number of recharges allowed for the consumer has been exceeded.
Action Required Inform the consumer that their recharge limit has been exceeded. No further action is required for this transaction.
OUT_OF_STOCK
Description The requested product is temporarily out of stock on the upstream system and cannot be provisioned.
Action Required Choose a different or product, or retry the transaction at a later date.
OUTCOME_UNKNOWN
Description A purchase request is still being processed at the service provider and so the transaction is in a pending state.
Action Required Initiate a purchase status lookup.
PIN_ATTEMPTS_EXCEEDED
Description The number of PIN retries for the transaction has been exceeded.
Action Required Use an alternative payment method or card number.
ROUTING_ERROR
Description Electrum was unable to route the transaction to the correct destination.
Action Required Check the errorMessage, detailMessage, providerErrorCode and providerErrorMsg in the response payload for more details. If more information is needed, contact Electrum.
SYSTEM_MALFUNCTION
Description An internal system has malfunctioned.
Action Required Check the errorMessage, detailMessage, providerErrorCode and providerErrorMsg in the response payload for more details. If more information is required, then contact Electrum.
TRANSACTION_NOT_SUPPORTED
Description The service provider does not support this transaction for the entered product.
Action Required Use a different product in the product field.
UNABLE_TO_LOCATE_RECORD
Description A purchase confirmation was received but the original transaction could not be located.
Action Required Ensure the requestId field of the confirmation request matches the id of the original purchase request and retry the confirmation.
UPSTREAM_UNAVAILABLE
Description A system has timed out while waiting for a response from another system further upstream. The upstream system could be experiencing downtime, or a network connection could be faulty.
Action Required If this is in response to a purchase trial, then retry the purchase trial. If this is in response to a purchase, then initiate a purchase status lookup. If the problem persists after multiple retries, then contact Electrum.