Error types
ABOVE_MAXIMUM_ALLOWED_AMOUNT
Description The amount entered for this transaction is above the threshold allowed by the service provider.
Action Required Ensure that the amount was entered correctly according to the service provider's business rules.
ACCOUNT_ALREADY_SETTLED
Description
- A payment confirmation message was received for a transaction that has already been confirmed.
- A payment request was received but the amount has already been paid.
- A bill payment refund request message was received but the original bill payment transaction has already been settled and cannot be refunded electronically.
Action Required No action needed, or contact the service provider for a manual refund.
BELOW_MINIMUM_ALLOWED_AMOUNT
Description The amount entered for this transaction is below the threshold allowed by the service provider.
Action Required Ensure that the amount was entered correctly according to the service provider's business rules.
BLOCKED_USING_SETTLEMENT_ENTITY
Description The service provider has been blocked due to decisions made by the originating system.
Action Required Contact Electrum to unblock the service provider.
DUPLICATE_RECORD
Description
- A message was received with the exact same id as a previously processed transaction.
- An advice message was received for a transaction in which the advice message has already been processed.
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 due to incorrect formatting.
- One or more message fields are in the incorrect format.
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.
- An internal component is unable to process this function.
Action Required Ensure that the API calls being sent are aligned to the allowed API calls for this service. Contact Electrum if necessary.
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.
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_MERCHANT
Description The merchant from 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_PRODUCT
Description The product does not exist in the service provider's system, has expired, or is not available to the originating system.
Action Required Use an alternative reference number.
LUHN_CHECK_FAILED
Description When the Luhn algorithm is applied, the numbers do not match the last digit.
Action Required Contact Electrum for additional details.
RECEIVER_BLACKLISTED
Description The biller has been blacklisted and the transaction cannot be processed.
Action Required Ensure that the biller is not blacklisted via the Electrum Console Server or contact Electrum.
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.
TRANSACTION_NOT_SUPPORTED
Description The service provider does not support this transaction for this particular originating system.
Action Required Use a different transaction to effect the desired outcome or contact Electrum.
UNABLE_TO_LOCATE_RECORD
Description An advice message was received but the original request message could not be located.
Action Required Ensure the requestId field of the advice request matches the id of the original request and retry the advice message.
UNKNOWN_CUSTOMER_ACCOUNT
Description
- The bill payment reference number or traffic fine notice number was entered incorrectly.
- The bill payment service provider was unable to determine the account of the biller relevant to the transaction, or the biller is inactive or does not exist.
Action Required Use an alternative reference number or re-enter the bill payment reference number or traffic fine notice number. Alternatively, contact the service provider directly.
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 error type is returned to the originating system for multiple transactions the service provider may be down. Contact Electrum in order to check the status of the service provider or look at the health of the service via ECS.