Error types
AUTHENTICATION_ERROR
Description Invalid authentication details were used in message transmission.
Action Required Check the authentication method used to communicate with 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
idas 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, contact Electrum.
INSUFFICIENT_AMOUNT
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_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_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 product ID in the product field.
INVALID_VOUCHER
Description The voucher number entered does not match any voucher number present in the service provider's system.
Action Required Re-enter the voucher number and try again. If the problem persists contact the service provider.
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 product or retry the transaction at a later date.
REDEMPTION_ALREADY_CONFIRMED
Description A BasicAdvice message with the corresponding UUID of the RedemptionRequest has been already received.
Action Required Stop sending BasicAdvice messages linked to that RedemptionRequest message.
REDEMPTION_ALREADY_REVERSED
Description A BasicReversal message with the corresponding UUID of the RedemptionRequest has been already received.
Action Required Stop sending BasicReversal messages linked to that RedemptionRequest message.
REDEMPTION_NOT_CONFIRMED
Description A BasicAdvice message with the corresponding UUID of the RedemptionRequest has not been received.
Action Required Send a BasicAdvice message for that particular RedemptionRequest message in order to finalise that transaction.
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 required, 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 produce 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.
- A
lookupVoucherrequest was processed but the originalProvisionRequestcould not be located.
Action Required Ensure the requestId field of the advice request or the provisionRequestId query parameter of a voucher lookup request matches the id of the original provision request and retry the message. In the case of a lookupVoucher request this might mean that the service provider did not actually process the original ProvisionRequest. In this case the originating system must stop sending lookupVoucher requests.
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 lookupVoucher request, then retry the lookupVoucher request. If this is in response to a provisionRequest, send a retryProvisonRequest. If the problem persists after multiple retries, then contact Electrum.
If the service does not support the lookupVoucher operation and 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.
VOUCHER_ALREADY_CONFIRMED
Description A TenderAdvice message linked to the ProvisionRequest has already been received.
Action Required Stop sending TenderAdvice messages for that transaction.
VOUCHER_ALREADY_PROVISIONED
Description A voucher with the same voucher number has already been created.
Action Required No further action required.
VOUCHER_ALREADY_REDEEMED
Description A voucher with the same voucher number has already been redeemed.
Action Required Use an alternative voucher number or contact the service provider.
VOUCHER_ALREADY_REVERSED
Description A BasicReversal message linked to the ProvisionRequest has already been received.
Action Required Stop sending BasicReversal messages for that transaction.
VOUCHER_NOT_REDEEMABLE
Description The voucher number is no longer redeemable. This is common when a voucher has expired or the voucher number was incorrectly entered.
Action Required Re-attempt the transaction with a different voucher number or contact the service provider.
VOUCHER_NOT_REDEEMED
Description An advice message has been received but the inital RedemptionRequest has not been fully processed.
Action Required Retry sending the advice message after some time in order to ensure that the redemption has been fully processed by the service provider.
VOUCHER_NOT_REFUNDED
Description An advice message has been received but the inital RefundRequest has not been fully processed.
Action Required Retry sending the advice message after some time in order to ensure that the refund has been fully processed by the service provider.
VOUCHER_STATUS_UNKNOWN
Description A ProvisionRequest or lookupVoucher request message was processed but the voucher status could not be determined.
Action Required Re-attempt the lookupVoucher request until the service provider returns another error or the transaction is successful.