Error Message JSON Schema

schema-response-error1.json schema-response-error2.json

Error Message Format

Error Codes responses will be formatted as follows:

{
 "errorMessage": "Merchant Not Found",                    # Specific Error message 
 "code": 200201,                                          # 6 digit error code (first 3 digits shall be the same as  HTTP Status Code of the response)
 "debugInfo": "No shop found for external shop ID 1966"   # Debug info providing detailed information about the problem
}

Error Message Code List

Notes: Old error type refers to legacy API 1.1 errors

Server Core values: 

  • Yes/No/Both - covered by Server and adapter              
  • N/A - not available at the moment            
  • ? - not clear at the moment

AIM = legacy name for the Merchant Integration Server

Codes Group Type Bidco Error Code New Error Type Old Error Type

Server Core?

Info                                      TAG Transaction Status TAG Mobile Error Code TAG Mobile Copy Key TAG Mobile Copy Message# Description                                                    
HTTP CODE 200   OK      
         
100 Series Error - Connectivity Issue E-com Connectivity Error 200101 FAIL_LOGIN_TO_ECOM  UNEXPECTED_ERROR No Fail to Connect to eCom Server

n/a

11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. AIM is unable to connect the the e-commerce/PSP server
200 Series Error - eCom feedback Merchant Error 200201 SHOP_NOT_FOUND BAD_REQUEST / UNEXPECTED_ERROR Yes Merchant Not Found n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.  Shop ID is Wrong
    200202 MERCHANT_DISABLED BAD_REQUEST / CONFIG_ERROR N/A Merchant is Disabled n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.  The Merchant Account is no longer using this E-com Platform or The Account is Mal-functioning etc
  SKU Error 200210 SKU_NOT_FOUND SKU_NOT_FOUND No SKU Not Found n/a 11052 error_product_invalid This product is not available, please check with your merchant. Product has been removed by the merchant
    200211 SKU_DISABLED SKU_NOT_FOUND No SKU is Disabled n/a 11052 error_product_invalid This product is not available, please check with your merchant. The SKU is no longer selling in this shop
    200212 PRICE_NOT_FOUND UNEXPECTED_ERROR No Price Not Found n/a 11127 error_unexpected We have encountered an unexpected error. Cannot find the price of the product
    200213 OTHER_PRODUCT_ERROR UNEXPECTED_ERROR No Other Product Error n/a 11127 error_unexpected We have encountered an unexpected error. Other unexpected error related to product details
  Shipping Error 200220 MERCHANT_WRONG_COUNTRY BAD_REQUEST / UNEXPECTED_ERROR No Merchant Does not Ship to This Country n/a 11128 aim_invalid_shipping_country Sorry, the merchant is unable to deliver items to this country. Please choose another address.  
    200221 MERCHANT_WRONG_STATE BAD_REQUEST / UNEXPECTED_ERROR No Merchant Does not Ship to This State n/a 11129 aim_invalid_shipping_state Sorry, the merchant is unable to deliver items to this state. Please choose another address.  
    200222 MERCHANT_WRONG_CITY BAD_REQUEST / UNEXPECTED_ERROR No Merchant Does not Ship to This City n/a 11130 aim_invalid_shipping_city Sorry, the merchant is unable to deliver items to this city. Please choose another address.  
    200223 MERCHANT_WRONG_STREET BAD_REQUEST / UNEXPECTED_ERROR No Merchant Does not Ship to This Street n/a 11131 aim_invalid_shipping_address Sorry, the merchant does not ship to the selected address. Please choose another address.  
    200224 MERCHANT_WRONG_ZIP_CODE BAD_REQUEST / UNEXPECTED_ERROR No Merchant Does not Ship to This Zip Code/Post Code n/a 11131 aim_invalid_shipping_address Sorry, the merchant does not ship to the selected address. Please choose another address.  
    200225 MERCHANT_WRONG_ADDRESS BAD_REQUEST / UNEXPECTED_ERROR No Merchants Does not Ship to this Address n/a 11131 aim_invalid_shipping_address Sorry, the merchant does not ship to the selected address. Please choose another address.  
    200226 MERCHANT_SHIPS_TO_ITS_COUNTRY BAD_REQUEST / UNEXPECTED_ERROR No Merchant Only Ships to its Country of Registration n/a 11132 panel_shippingmethod_no_header Sorry, the merchant does not ship to the selected country. Please choose another address.  
    200227 MERCHANT_SHIPS_TO_USER_COUNTRY BAD_REQUEST / UNEXPECTED_ERROR No Merchant only Ships to User Country of Registration n/a 11132 panel_shippingmethod_no_header Sorry, the merchant does not ship to the selected country. Please choose another address. Rare Case but Does Exist; I've seen Korean and Chinese Websites Shipping Only to Korean and Chinese
    200228 ADDRESS_REQUIRED BAD_REQUEST / UNEXPECTED_ERROR ? Address is Required to Calculate Shipping n/a 11133 tag27_missing_delivery_address Please add a delivery address  
    200229 ADDRESS_FORMAT_ERROR BAD_REQUEST Both Address Format Error n/a 11131 aim_invalid_shipping_address Sorry, the merchant does not ship to the selected address. Please choose another address. Merchant does not send to this address; City is Missing; Country is Missing etc
    200230 OTHER_ADDRESS_ERROR BAD_REQUEST / UNEXPECTED_ERROR Both Other Address Error n/a 11131 aim_invalid_shipping_address Sorry, the merchant does not ship to the selected address. Please choose another address.  
  Quantity Error 200240 QUANTITY_FORMAT_ERROR BAD_REQUEST Yes Quantity Format Error n/a 11134 vsvsc_payment_error_action Please confirm the purchase quantity and try again.  
    200241 QUANTITY_ZERO_ERROR BAD_REQUEST Both Quantity Canot be Less Than Zero n/a 11134 vsvsc_payment_error_action Please confirm the purchase quantity and try again.  
    200242 OTHER_QUANTITY_ERROR BAD_REQUEST / UNEXPECTED_ERROR No Other Quantity Error n/a 11134 vsvsc_payment_error_action Please confirm the purchase quantity and try again.  
  Stock Error 200243 NOT_IN_STOCK NOT_IN_STOCK No SKU Out of Stock n/a 11052 error_product_invalid This product is not available, please check with your merchant.  
    200244 INSUFFICIENT_STOCK NOT_IN_STOCK No Insufficient Stock n/a 11136 error_mybag_item_not_enough_stock Some items in your bag are nearly out of stock. We have adjusted the quanitity to the maximum currently available. Please verify before checkout:  
    200245 OTHER_STOCK_ERROR BAD_REQUEST / UNEXPECTED_ERROR No Other Stock Error n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again.  
  Others 200290 INTERNAL_ERROR UNEXPECTED_ERROR ? An Internal Error Has Occurred n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again.  
    200291 INVALID_DATA BAD_REQUEST Both Invalid Data n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again.  
    200292 INVALID_REQUEST BAD_REQUEST Yes Invalid Request n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again.  
    200293 INVALID_LOYALTY_ID BAD_REQUEST ? Invalid Loyalty Id n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again.  
300 Series Error - Payment specific Transaction Error 200301 MERCHANT_NOT_FOUND_TRANSACTION UNEXPECTED_ERROR Yes Merchant Not Found n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.   
    200302 WRONG_MID CONFIG_ERROR / UNEXPECTED_ERROR Yes Wrong/Incorrect MID n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.   
    200303 WRONG_PPS_KEY UNEXPECTED_ERROR No Wrong PPS Encryption Key e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200304 WRONG_CERTIFICATE UNEXPECTED_ERROR No Wrong Certificate e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200305 UNABLE_TO_REACH_ISSUER UNEXPECTED_ERROR No Unable to Reach Issuer e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200306 UNABLE_TO_REACH_SWITCH UNEXPECTED_ERROR No Unable to Reach Switch e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200307 UNKNOWN_GATEWAY_ERROR UNEXPECTED_ERROR No Unknown Gateway Error e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200308 GATEWAY_TIMEOUT UNEXPECTED_ERROR No Gateway Timeout p   payment_error_status_p The transaction is still being processed.  You can confirm when your transaction is processed by checking "My Tags".  
    200309 TRANSACTION_TYPE_NOT_SUPPORTED  INVALID_PAYMENT No This Transaction Type is Not Supported e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200310 PAYMENT_METHOD_NOT_SUPPORTED  INVALID_PAYMENT No This Payment Method is Not Supported e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200311 CURRENCY_NOT_SUPPORTED   No This Currency is Not Supported e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200312 CURRENCY_PAIR_NOT_SUPPORTED  INVALID_PAYMENT No Cross Border currency pair is not supported   20016 card_not_supported This card is not supported. Please try another card.   
    200313 FOREIGN_CARDS_NOT_SUPPORTED  INVALID_PAYMENT No Foreign Cards/Cross Border are Not Supported   20016 card_not_supported This card is not supported. Please try another card.   
    200314 MERCHANT_ONLY_BILLING_ADDRESS  INVALID_PAYMENT No Merchant Only Ships to Billing Address   20017 billing_address_not_supported This merchant only ships to the billing address of your selected payment method. Please try again.  
    200315 INVALID_PAYMENT  INVALID_PAYMENT No Invalid Transaction e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again. Same meaning as INVALID_TRANSACTION, which has been removed
    200316 INVALID_AMOUNT  INVALID_PAYMENT No Invalid Amount e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200317 INVALID_CURRENCY_CODE  INVALID_PAYMENT Both Invalid Currency Code e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200318 FIELD_MISSING_AMOUNT  INVALID_PAYMENT /  BAD_REQUEST Both Field Missing; Amount e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200319 FIELD_MISSING_CURRENCY  INVALID_PAYMENT /  BAD_REQUEST Both Field Missing; Currency e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200320 FIELD_MISSING_ADDRESS  INVALID_PAYMENT /  BAD_REQUEST Both Field Missing; Billing Address e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200321 FIELD_MISSING_CITY  INVALID_PAYMENT /  BAD_REQUEST Both Field Missing; Billing City e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200322 FIELD_MISSING_COUNTRY  INVALID_PAYMENT /  BAD_REQUEST Both Field Missing; Billing Country e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200323 FAILED_TO_PLACE_ORDER  INVALID_PAYMENT Yes Failed to Place Order e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200324 DUPLICATED_TRANSACTION INVALID_PAYMENT ? Duplicated Transaction e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
   

200325

INVALID_BILLING_ADDRESS INVALID_PAYMENT /  BAD_REQUEST No Invalid Billing Address e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200326 INVALID_BILLING_CITY INVALID_PAYMENT /  BAD_REQUEST No Invalid Billing City e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200327 INVALID_BILLING_POSTCODE INVALID_PAYMENT /  BAD_REQUEST No Invalid Billing Postcode e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200328 INVALID_BILLING_COUNTRY INVALID_PAYMENT /  BAD_REQUEST No Invalid Billing Country e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200329

FIELD_MISSING_POSTCODE

INVALID_PAYMENT /  BAD_REQUEST   Field Missing; Shipping Postcode e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200330

INVALID_BILLING_STATE

INVALID_PAYMENT /  BAD_REQUEST   Invalid Billing State e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200331

FIELD_MISSING_STATE

INVALID_PAYMENT /  BAD_REQUEST   Field Missing; Shipping State e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
400 Series Error - Payment specific Card Error 200400 NO_CHECKING_ACCOUNT INVALID_PAYMENT No No Checking Account e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200401 INVALID_CARD_NUMBER INVALID_PAYMENT /  BAD_REQUEST Both Invalid Card Number e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200402 WRONG_HOLDER_NAME INVALID_PAYMENT /  BAD_REQUEST No Wrong Card Holder Name e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200403 WRONG_EXPIRY_DATE INVALID_PAYMENT /  BAD_REQUEST Both Wrong Expiry Date x   payment_error_status_x Please verify that your card's expiration date is entered correctly  and try again.   
    200404 WRONG_CVV INVALID_PAYMENT /  BAD_REQUEST Both Wrong CVV e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200405 INVALID_CARD INVALID_PAYMENT /  BAD_REQUEST No Invalid Card e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200406 FAILED_AVS INVALID_PAYMENT No Failed AVS e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200407 AVS_NOT_SUPPORTED_CARD_TYPE INVALID_PAYMENT No Invalid AVS/AVS Not Supported For This Card Type e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200408 AVS_NOT_SUPPORTED_ISSUER INVALID_PAYMENT No Invalid AVS/AVS Not Supported For This Issuer e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200409 AVS_NOT_SUPPORTED INVALID_PAYMENT No AVS Not Supported e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200410 FIELD_MISSING_HOLDER_NAME INVALID_PAYMENT /  BAD_REQUEST No Field Missing: Card Holder Name e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200411 FIELD_MISSING_EXPIRY_DATE INVALID_PAYMENT /  BAD_REQUEST Both Field Missing: Expiry Date e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200412 FIELD_MISSING_CVV INVALID_PAYMENT /  BAD_REQUEST Both Field Missing: CVV e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200413 FIELD_MISSING_CARD_DATA INVALID_PAYMENT /  BAD_REQUEST No Field Missing: Card Data e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200414 CARD_DATA_MISSING_FIELDS INVALID_PAYMENT /  BAD_REQUEST Both Card Data missing fields e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200415 INSUFFICIENT_FUND INVALID_PAYMENT No Insufficient Fund j   payment_error_status_j Transaction failed due to insufficient funds, please select another payment method.  
    200416 EXPIRED_CARD INVALID_PAYMENT No Expired Card x   payment_error_status_x Please verify that your card's expiration date is entered correctly  and try again.   
    200417 RESTRICTED_CARD INVALID_PAYMENT No Restricted Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200418 LOST_CARD INVALID_PAYMENT No Lost Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200419 STOLEN_CARD INVALID_PAYMENT No Stolen Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200420 TEMPORARY_HOLD INVALID_PAYMENT No Temporary Hold s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200421 CALL_ISSUER INVALID_PAYMENT No Call Issuer s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200422

FIELD_MISSING_AMOUNT_TOTAL

INVALID_PAYMENT

 

Missing Amount Total

e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
500 Series Error - Payment specific Payment Error 200500 PAYMENT_DECLINED INVALID_PAYMENT No Payment Declined e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200501 DECLINED_SUSPICIOUS_CARD INVALID_PAYMENT No Declined, Suspicious Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200502 DECLINED_LOST_CARD INVALID_PAYMENT No Declined, Lost Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200503 AUTHORIZED_SUSPICIOUS_CARD INVALID_PAYMENT No Authorized: Suspicious Card s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200504 AUTHORIZED_SUSPICIOUS_TRANSACTION INVALID_PAYMENT No Authorized: Suspicious Transaction s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200505 DECLINED_CALL_ISSUER INVALID_PAYMENT No Declined by Issuer; Call Issuer s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200506 DECLINED_UNEXPECTED_ERROR INVALID_PAYMENT No Declined by Issuer; Unexpected Error s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200507 DECLINED_RETRY INVALID_PAYMENT No Declined by Issuer; Retry Transaction s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200508 ISSUER_REQUEST_RETRY INVALID_PAYMENT No Issuer Request to Retry Transaction s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200509 DECLINED_BY_GATEWAY INVALID_PAYMENT No Declined by Gateway s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200510 SYSTEM_ERROR_RETRY INVALID_PAYMENT No System Error, Please Retry the Transaction e   payment_error_status_e Transaction failed. Please contact your card issuer for more details.    
    200511 SYSTEM_ERROR_DO_NOT_RETRY INVALID_PAYMENT No System Error, Please Do Not Retry the Transaction s   payment_error_status_s Transaction failed. Please contact your card issuer for more details.    
    200512 FAILED_TO_VOID_PAYMENT_ON_FAILED_ORDER INVALID_PAYMENT / UNEXPECTED_ERROR Yes Failed to void payment after the order placement failed p   payment_error_status_p

Your transaction is still being processed.  You can confirm when your transaction is processed by checking “My Tags”.

This error code describes a very particular situation, when the payment VOID operation failed after an order placement failed previously. This kind of situation is specific to the 2- and 3-step strategies. Actually, it denotes that there is an ongoing payment process, while the order placement failed, which most likely requires some manual intervention.
600 Series Error - Payment specific Capture Error 200600 AUTHORIZATION_EXPIRED INVALID_PAYMENT No The authorization to be Settled has Expired

Capture Failed

  n/a n/a  
    200601 MAX_NUMBER_OF_CREDITS_REACHED INVALID_PAYMENT No Maximum Number of Credits Allowed for Settlement Reached

Capture Failed

  n/a n/a  
    200602 BATCH_SUBMISSION_FAILED INVALID_PAYMENT No Batch Submission Failed

Capture Failed

  n/a n/a  
    200603 BATCH_ALREADY_SUBMITTED INVALID_PAYMENT No Batch Already Submitted

Capture Failed

  n/a n/a  
    200604 BATCH_FORMAT_ERROR INVALID_PAYMENT No Batch Format Error

Capture Failed

  n/a n/a  
    200605 OTHER_CAPTURE_ERROR INVALID_PAYMENT / UNEXPECTED_ERROR No Other Capture Error

Capture Failed

  n/a n/a  
  Refund Error 200606 REFUND_DECLINED INVALID_PAYMENT No Refund Declined

Refund Failed

  n/a n/a  
    200607 TRANSACTION_FORMAT_ERROR INVALID_PAYMENT /  BAD_REQUEST No Transaction Format Error

Refund Failed

  n/a n/a  
    200608 REFUND_FORMAT_ERROR INVALID_PAYMENT /  BAD_REQUEST No Refund Format Error

Refund Failed

  n/a n/a  
    200609 VOID_FORMAT_ERROR INVALID_PAYMENT /  BAD_REQUEST No Void Format Error

Refund Failed

  n/a n/a  
    200610 OTHER_REFUND_ERROR INVALID_PAYMENT No Other Refund Error

Refund Failed

  n/a n/a  
    200611 OTHER_VOID_ERROR INVALID_PAYMENT No Other Void Error

Refund Failed

  n/a n/a  
800 Series Error - Shop API specific   200800 DUPLICATE_SHOP_ID UNEXPECTED_ERROR Yes A shop could not be created because value of "externalShopId" is not unique         A shop could not be created because value of "externalShopId" is not unique
    200801 INVALID_SERVICE_TYPE_ID UNEXPECTED_ERROR Yes At least one of the service type IDs provided for shop CREATE or UPDATE is not valid (absent from the DB)         At least one of the service type IDs provided for shop CREATE or UPDATE is not valid (absent from the DB)
    200802 SERVICE_TYPE_NOT_FOUND UNEXPECTED_ERROR Yes Service type could not be found by ID         Service type could not be found by ID
    200803 INVALID_FIELD_SERVICE_TYPE_TYPE UNEXPECTED_ERROR Yes When sending a GET request by service type type, the query parameter is not a valid value. Applies as well when a POST is sent with an invalid value.         When sending a GET request by service type type, the query parameter is not a valid value. It should be one of commerceadapter, paymentprovider, strategy, paymentnotification. Applies as well when a POST is sent with an invalid value.
    200804 DUPLICATE_SERVICE_TYPE_CLASS_NAME UNEXPECTED_ERROR Yes When creating a service type, the class name value is not unique         When creating a service type, the class name value is not unique
    200805 FIELD_MISSING_SHOP_ID UNEXPECTED_ERROR Yes The "externalShopId" field should be present for each shop operation         The externalShopId field should be present for all shop operations
    200806 FIELD_MISSING_SHOP_NAME UNEXPECTED_ERROR Yes The "name" field should be specified when creating or updating a shop         The "name" field should be specified when creating or updating a shop
    200807 FIELD_MISSING_STRATEGY_SERVICE_TYPE UNEXPECTED_ERROR Yes When a strategy is specified, it must have a service type attached         When a strategy is specified, it must have a service type attached
    200808 FIELD_MISSING_STRATEGY_NAME UNEXPECTED_ERROR Yes When a strategy is specified, it must have a non-null name         When a strategy is specified, it must have a non-null name
    200809 FIELD_MISSING_PAYMENT_PROVIDER_NAME UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null name         When a payment provider is specified, it must have a non-null name
    200810 FIELD_MISSING_PAYMENT_PROVIDER_URL UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null gateway URL         When a payment provider is specified, it must have a non-null gateway URL
    200811 FIELD_MISSING_PAYMENT_PROVIDER_MERCHANT_ID UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null merchant ID         When a payment provider is specified, it must have a non-null merchant ID
    200812 FIELD_MISSING_PAYMENT_PROVIDER_MERCHANT_PASSWORD UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null merchant password         When a payment provider is specified, it must have a non-null merchant password
    200813 FIELD_MISSING_PAYMENT_PROVIDER_SERVICE_TYPE UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a service type attached         When a payment provider is specified, it must have a service type attached
    200814 FIELD_MISSING_PAYMENT_PROVIDER_VERSION UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null version         When a payment provider is specified, it must have a non-null version
    200815 FIELD_MISSING_PAYMENT_PROVIDER_TRANSACTION_TYPE UNEXPECTED_ERROR Yes When a payment provider is specified, it must have a non-null transaction type         When a payment provider is specified, it must have a non-null transaction type
    200816 FIELD_MISSING_ADAPTER_NAME UNEXPECTED_ERROR Yes When an adapter is specified, it must have a non-null name         When an adapter is specified, it must have a non-null name
    200817 FIELD_MISSING_ADAPTER_URL UNEXPECTED_ERROR Yes When an adapter is specified, it must have a non-null gateway URL         When an adapter is specified, it must have a non-null gateway URL
    200818 FIELD_MISSING_ADAPTER_SERVICE_TYPE UNEXPECTED_ERROR Yes When an adapter is specified, it must have a service type attached         When an adapter is specified, it must have a service type attached
    200819 FIELD_MISSING_ADAPTER_VERSION UNEXPECTED_ERROR Yes When an adapter is specified, it must have a non-null version         When an adapter is specified, it must have a non-null version
    200820 FIELD_MISSING_SERVICE_TYPE_NAME UNEXPECTED_ERROR Yes When creating a service type, it must have a non-null name         When creating a service type, it must have a non-null name
    200821 FIELD_MISSING_SERVICE_TYPE_CLASS_NAME UNEXPECTED_ERROR Yes When creating a service type, it must have a non-null class name         When creating a service type, it must have a non-null class name
    200822 INVALID_FIELD_PAYMENT_PROVIDER_TRANSACTION_TYPE UNEXPECTED_ERROR Yes When a payment provider is specified, the transaction type should be a value from a closed set of accepted values         When a payment provider is specified, the transaction type should be a value from a closed set of accepted values
    200823 FIELD_MISSING_OTHER_FIELD UNEXPECTED_ERROR Yes Any mandatory field error that is not covered by more specific error codes         Any mandatory field error that is not covered by more specific error codes
    200824 OTHER_SHOP_CREATION_ERROR UNEXPECTED_ERROR Yes            
    200825 OTHER_SHOP_UPDATE_ERROR UNEXPECTED_ERROR Yes            
    200826 COULD_NOT_DELETE_SHOP UNEXPECTED_ERROR Yes            
    200827 OTHER_SERVICE_TYPE_CREATION_ERROR UNEXPECTED_ERROR Yes            
900 Series Error - Payment specific Others 200900 EXCEEDED_MAXIMUM_ATTEMPTS INVALID_PAYMENT No Exceed Maximum Attempts e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200901 INVALID_TRANSACTION_DATA INVALID_PAYMENT /  BAD_REQUEST No Invalid Data e   payment_error_status_e Transaction failed as an error occurred during processing. Please try again.  
    200902 NO_RESPONSE INVALID_PAYMENT / UNEXPECTED_ERROR No No Response p   payment_error_status_p Transaction is processing. Please check transaction history to confirm your payment later.  
                       
HTTP CODE 400   Bad Request                  
    400100 BAD_REQUEST BAD_REQUEST ? Bad request n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. Any request problem that cannot be caught in the more specific 400xxx codes
    400101 MALFORMED_REQUEST BAD_REQUEST ? Malformed Request n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. json not in proper format
    400102 MISSING_FIELD BAD_REQUEST Both? Missing Required field {1} n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. {1} field name
    400103 INVALID_FIELD BAD_REQUEST Both? invalid field {1} n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. {1} is not a valid field in the request
    400404 FORMAT_ERROR BAD_REQUEST Both? {1} format error, {1} should be in {2} n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. {1} field should be in certain format e.g. {2} - CVV (3 digit)
                       
HTTP 401   Unauthorized request                  
    401101 CREDENTIAL_ERROR BAD_REQUEST / UNEXPECTED_ERROR No Account Name/Password Error n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.  user pass to AIM not valid
    401102 ACCESS_DENIED BAD_REQUEST / UNEXPECTED_ERROR No? User Doesn't Have the Permission to Access this AIM Resource n/a 20003 error_invalid_payee_account It looks like this merchant is no longer supported. Please contact this merchant directly for more details.   
    401103 HMAC_VALIDATION_FAIL BAD_REQUEST / UNEXPECTED_ERROR   Validation Failed n/a 11124 aim_ecom_connection_error Sorry, an error occurred while attempting to communicate with this merchant. Please try again. The HMAC header used for validating the origin of the JSON is not correct
800 Series Error - Shop API specific   401800 SHOP_API_AUTHENTICATION_FAILED UNEXPECTED_ERROR Yes Credentials provided are not valid (either HMAC or token)         Credentials provided are not valid (either HMAC or token)
HTTP 403   Forbidden                  
800 Series Error - Shop API specific   403800 SHOP_API_USER_NOT_AUTHORIZED UNEXPECTED_ERROR Yes User is authenticated, but does not have enough rights to access this resource         For the moment, it is virtual, since there is no role-based rules enabled in the Shop API
HTTP 404   Not Found                  
    -       -          
                       
HTTP 405   Method Not Allowed                  
    -   UNEXPECTED_ERROR   -         use a POST on a GET method
                       
HTTP 500   Internal Error                  
    500101 UNEXPECTED_ERROR UNEXPECTED_ERROR Both Unexpected error n/a 101 error_unknown_system_error We are experiencing technical difficulties. Please try again. If this problem still persists, please contact the Support Team. AIM Internal Error
    500102 COMPONENT_NOT_FOUND UNEXPECTED_ERROR Yes Component Not Found n/a 101 error_unknown_system_error We are experiencing technical difficulties. Please try again. If this problem still persists, please contact the Support Team.  
    500103 CONFIG_ERROR UNEXPECTED_ERROR Both Configuration Error n/a 101 error_unknown_system_error We are experiencing technical difficulties. Please try again. If this problem still persists, please contact the Support Team.  


Common error codes which are moved to Merchant Integration Server level :

Codes Group Type AIM Error Code New Error Type Old Error Type Info What is this?
300 Series Error - Payment specific Transaction Error 200320 FIELD_MISSING_ADDRESS  INVALID_PAYMENT /  BAD_REQUEST Field Missing; Billing Address  
   

200325

INVALID_BILLING_ADDRESS INVALID_PAYMENT /  BAD_REQUEST Invalid Billing Address  
    200319 FIELD_MISSING_CURRENCY  INVALID_PAYMENT /  BAD_REQUEST Field Missing; Currency  
    200317 INVALID_CURRENCY_CODE  INVALID_PAYMENT Invalid Currency Code  
    200318 FIELD_MISSING_AMOUNT  INVALID_PAYMENT /  BAD_REQUEST Field Missing; Amount  
    200316 INVALID_AMOUNT  INVALID_PAYMENT Invalid Amount  
    200413 FIELD_MISSING_CARD_DATA INVALID_PAYMENT /  BAD_REQUEST Field Missing: Card Data  
    200401 INVALID_CARD_NUMBER INVALID_PAYMENT /  BAD_REQUEST Invalid Card Number  
    200321 FIELD_MISSING_CITY  INVALID_PAYMENT /  BAD_REQUEST Field Missing; Billing City  
    200326 INVALID_BILLING_CITY INVALID_PAYMENT /  BAD_REQUEST Invalid Billing City  
    200322 FIELD_MISSING_COUNTRY  INVALID_PAYMENT /  BAD_REQUEST Field Missing; Billing Country  
    200328 INVALID_BILLING_COUNTRY INVALID_PAYMENT /  BAD_REQUEST Invalid Billing Country  
    200412 FIELD_MISSING_CVV INVALID_PAYMENT /  BAD_REQUEST Field Missing: CVV  
    200404 WRONG_CVV INVALID_PAYMENT /  BAD_REQUEST Wrong CVV  
    200411 FIELD_MISSING_EXPIRY_DATE INVALID_PAYMENT /  BAD_REQUEST Field Missing: Expiry Date  
    200416 EXPIRED_CARD INVALID_PAYMENT Expired Card  
    200410 FIELD_MISSING_HOLDER_NAME INVALID_PAYMENT /  BAD_REQUEST Field Missing: Card Holder Name  
    200402 WRONG_HOLDER_NAME INVALID_PAYMENT /  BAD_REQUEST Wrong Card Holder Name  
    200329

FIELD_MISSING_POSTCODE

INVALID_PAYMENT /  BAD_REQUEST Field Missing; Billing Postcode  
    200327 INVALID_BILLING_POSTCODE INVALID_PAYMENT /  BAD_REQUEST Invalid Billing Postcode  



Error Codes Generated by Merchant Integration Server, thus consistent throughout all the cartridges

Currency
error code
error type
non string value 200317 INVALID_CURRENCY_CODE
invalid currency code (like "ABC") 200317 INVALID_CURRENCY_CODE

Expiry date
error code
error type
string, invalid format (like 2015 or 2014/20/02) 200403 WRONG_EXPIRY_DATE
non string value 200403 WRONG_EXPIRY_DATE
invalid date format like 13/2015 200403 WRONG_EXPIRY_DATE


CustomFormattedException

Error Code
Error Type
Message
400102 MISSING_FIELD Missing Required field {0}
400103 INVALID_FIELD Invalid field {0}
400104 FORMAT_ERROR {0} format error, {0} should be in {1}


To throw these errors please use CustomFormattedException(String message, ErrorType errorType, String[] fields) where "fields" could be: new String[] {"CVV", "(3 digit)"}

Legacy Error Codes

This is the format of the message returned from old bespoke ecommerce platforms to Bidco when there's an error (the order of the attributes is not important).

{
     "code": "BAD_REQUEST",
     "message": "The request entity had validation errors",
     "validationErrors": [ "user.emailAddress may not be empty" ]
}

The message and validation error fields are not standardised and are just used for debugging purpose. The code field can take and of the following values. Bidco receives these errors and transforms to the new error format according to the table below:

code

HTTP Response Code

New Error Code
New HTTP Response Code
BAD_REQUEST 400 400100 400
SHOP_NOT_FOUND 404 200201 200
SKU_NOT_FOUND 404 200210 200
NOT_IN_STOCK 400 200243 200
UNEXPECTED_ERROR 500 500101 500
INVALID_PAYMENT

400 (if the payment data is incorrect)

500 (anything else)

200315 200
CONFIG_ERROR 500 500103 500
COMPONENT_NOT_FOUND 500 500102 500