Last updated

Error types

ACCOUNT_ALREADY_SETTLED

Description An advice message has already been received for this transaction, indicating that it has been reversed or confirmed.

Action Required No action is required.

AUTH_ERROR

Description Authentication with the upstream provider failed.

Action Required Contact Electrum support.

DO_NOT_HONOR

Description The upstream entity has declined the transaction based on certain business rules.

Action Required Check the errorMessage, detailmessage, providerErrorCode, and providerErrorMessage in the response payload for more details. If more information is required, contact Electrum.

DRAW_NOT_OPEN

Description The purchase period for this game has ended due to an impending draw.

Action Required No further action required.

DUPLICATE_RECORD

Description

  • A message was received with the same id as a previously processed transaction.

Action Required Ensure that the originating system assigns a unique id to each transaction.

FORMAT_ERROR

Description

  • The system is unable to interpret one or more components in the message, for example, one or more message fields are in the incorrect format.

Action Required Ensure that the message payload conforms to the API specifications and retry the transaction.

FUNCTION_NOT_SUPPORTED

Description

  • An internal component is unable to process this function.

Action Required Contact Electrum support.

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.

INSUFFICIENT_FUNDS

Description The consumer does not have the required funds in their account to proceed with the transaction.

Action Required Use a different card number or payment method, or decrease the transaction amount.

INVALID_ACCOUNT

Description The account number used in this transaction does not exist or no longer exists.

Action Required Use a different account.

INVALID_AMOUNT

Description The tender amount for the transaction falls outside the limits set by the service provider.

Action Required Ensure that the value entered into the falls within the service provider's limits and retry the transaction.

INVALID_MERCHANT

Description The merchant at which the transaction originated is not recognised by the service provider.

Action Required Check that the merchantId field is correctly populated. If correct, check with the service provider that the merchant is correctly configured on their system.

INVALID_PRODUCT

Description The product does not exist in the service provider's system, or has expired.

Action Required Select a different product.

LIMIT_EXCEEDED

Description The purchase limit for this product, set by the service provider, has been exceeded.

Action Required The consumer has exceeded the monetary limit set for Lotto ticket purchases. No further action is required.

REVISION_CHANGE

Description The revision ID is invalid and should be updated before attempting a new WagerRequest message.

Action Required Get the updated revision number using the GET/games/rules transaction.

ROUTING_ERROR

Description Electrum was unable to route the transaction to the correct service provider.

Action Required Check the errorMessage, detailMessage, providerErrorCode, and providerErrorMsg in the response payload for more details. If more information is required, 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, contact Electrum.

TIME_LIMIT_EXCEEDED

Description The time limit for sending a reversal for the transaction has been reached.

Action Required The time limit for sending a reversal transaction is two hours from the time of purchase. If a period longer than two hours has passed the reversal can not be processed. If you are still within the two-hour window when this error message is received, contact Electrum Support.

TRANSACTION_DECLINED

Description The transaction was declined by the service provider based on business rules.

Action Required Refer to the detailMessage and providerErrorMessage in the response message for more details. If the source of the error is still not clear, contact Electrum Support.

TRANSACTION_NOT_SUPPORTED

Description The aggregator or service provider does not support the transaction for this particular number.

Action Required No further action is required.

UNABLE_TO_LOCATE_RECORD

Description A confirmation message has been received but the original request message could not be found in the system.

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. The upstream system could be temporarily unavailable or a network connection could be faulty.

Action Required Retry the transaction.