Articles in this section

Error Codes

  • Updated

The following table contains the standard error code that you can expect to be returned from Bolt. The table rows are grouped by error classification.

Items in the table columns indicate the following:

  • Code # — The code number (where implemented) returned by Bolt.
  • Code — Bolts internal error code.
  • Text Prompt — The internal mapping of the error code to human-readable text (where implemented). 
Basic Codes    
Code # Code Text Prompt
34 AlreadyExists The entity already exists.
22 AmountTooHigh The provided amount is higher than required.
21 AmountTooLow The provided amount is lower than required.
38 CantChangeRoleOfPrimaryUser N/A
32 CodeAlreadyUsed The code is already used.
1 EmptyValue A required field is empty.
28 ExpiredEntity The entity has expired.
18 Forbidden This action is forbidden.
29 InactiveEntity The entity is not active.
46 InternalServerError Internal error
44 InvalidAddress A valid address address must be provided.
2 InvalidAmount A valid amount is required.
3 InvalidAutocapture Transaction must match the configured autocapture setting.
4 InvalidCountry A valid country name or country code must be provided.
5 InvalidCreditCardNumber A valid credit card number must be provided.
6 InvalidCurrency A valid currency code must be provided.
17 InvalidDate A valid date value must be provided.
7 InvalidEmail A valid email address must be provided.
8 InvalidFormat Invalid field format.
37 InvalidImageFormat The format of the image is not valid
26 InvalidInputParameter A parameter provided in the input is invalid.
9 InvalidLength Invalid field length.
10 InvalidNumber A valid number must be provided.
11 InvalidPassword The provided password doesn't match the required format.
12 InvalidPhone A valid phone number must be provided.
13 InvalidPostalCode A valid postal code must be provided.
40 InvalidRole N/A
27 InvalidSignature Invalid signature.
49 InvalidTokenType N/A
14 InvalidURL A valid URL string must be provided.
15 InvalidValue A valid value must be provided.
25 MissingInputParameter The input is missing a required parameter.
16 NewLine Unexpected new line character in input.
33 NoApplicableItem No applicable item found in the request.
39 NonMerchantRole N/A
42 NonRetryableError N/A
43 NoPoBoxAllowed Shipment to PO Box is not allowed.
24 NotFound The requested entity was not found.
35 RateLimited Rate limit reached. Please retry after a while.
31 ShippingCostTooHigh The shipping cost is too high.
41 TooManyRequests Too many requests
45 TransactionNotAuthorized Transaction is not in authorized state. Transaction may not have been approved.
30 Unsupported This feature is not supported.
36 UserNotEligible The user is not eligible for this action.
47 BadGateway N/A
48 NoShippingOptionAvailable N/A
50 BadRequest N/A
51 BadResponse N/A
19 - Deprecated ErrorWeakPassword N/A
20 - Deprecated ServiceError N/A
23 - Deprecated ErrorMutuallyExclusive N/A
Authentication Errors    
Code # Code Text Prompt
1001 AuthGuestSessionRequired Authentication error. A guest session is required.
1002 AuthInvalidSessionType Authentication error. The provided session type has no access to this resource.
1003 AuthInvalidSessionLevel Authentication error. The provided session level has no access to this resource.
1004 AuthInvalidUserRole Authentication error. Invalid user role.
1005 AuthInvalidMerchantKey Authentication error. Invalid merchant key.
1006 AuthMerchantNotFound Authentication error. Merchant not found.
1007 AuthInvalidNonce Authentication error. Invalid nonce value.
1009 AuthInvalidSessionToken Authentication error. Invalid session token.
1010 AuthUserNotFound Authentication error. User not found.
1011 AuthMerchantKeyMerchantMismatch Authentication error. Merchant key doesn't match merchant public id.
1012 AuthMerchantKeyDivisionMismatch Authentication error. Merchant key doesn't match division public id.
1013 AuthUpdateExpirationFailed N/A
1014 AuthInvalidTwilioSignature Authentication error. Invalid twilio signature
1015 AuthUnauthorized Authentication error. Authorization required.
Application Errors    
Code # Code Text Prompt
4001 AppMerchantSettingsCreate Failed to create merchant settings.
4002 AppMerchantSettingsLoad Failed to load merchant settings.
4002 AppMerchantKeyCreate N/A
4004 AppMerchantKeyLoad Unable to find the entity by key. Please check the key in the request.
4005 AppInvalidJSON Invalid JSON content.
4006 AppUnknownContentType N/A
4007 AppFileUpload Failed to upload the file. Please check the file contents and retry.
4008 AppNonceInvalid The provided nonce value is invalid. Please check the value and retry.
4009 AppNonceExpired The provided nonce value expired. Please retry the request by regenerating a new nonce.
4010 AppMerchantKeyUpdate N/A
4011 AppFileInvalidName Invalid filename provided.
4012 AppNotRightNow N/A
Custom Checkbox Errors    
Code # Code Text Prompt
4013 CustomCheckboxLimitReached Merchant division cannot have more than 3 active Checkboxes.
4014 CustomCheckboxLookupFailed Failed to fetch checkboxes for merchant division.
4015 CustomCheckboxAlreadyExists Checkbox with supplied ID already exists.
Product Add-ons Errors    
4016 ProductAddOnsLimitReached The limit of active product add-ons per merchant division has been reached
Update-Cart Related Errors    
4017 CartNotUpdatedError N/A
4018 RemoteCartPossiblyDiverged N/A
4019 CartNotCreatedError N/A
4020 NoUpdateToProcessError N/A
Service Errors    
5001 ServiceError Unknown service error occurred. Please retry after a while.
5002 ServiceTimeout Service error. The request timed out
ErrorApplicationBase Errors    
Code # Code Text Prompt
1000000 ErrorAuthentication N/A
1000001 ErrorInvalidId N/A
1000002 ErrorInvalidIdentifier N/A
1000003 ErrorProcessing N/A
1000004 ErrorNotFound N/A
1000005 ErrorInvalidState N/A
1000006 ErrorPagination N/A
1000007 ErrorMissingAuthenticationFactor N/A
1000008 ErrorLockedOut N/A
1000009 ErrorDeclined N/A
1000010 ErrorInvalidReference N/A
1000011 ErrorDeclinedInvalidAmount N/A
1000012 ErrorDeclinedInvalidCvv N/A
1000013 ErrorDeclinedInvalidNumber N/A
1000014 ErrorDeclinedExpired N/A
1000015 ErrorDeclinedCallIssuer N/A
1000016 ErrorDeclinedInvalidMerchantForCard N/A
1000017 ErrorInvalidWebhookType N/A
1000018 ErrorDuplicateCreditCardTransaction N/A
1000019 ErrorTransactionHasDisputes N/A
1000020 ErrorRefundDeclined N/A
Discount Code Errors    
Code # Code Text Prompt
6200 DiscountCodeInsufficientInformation We need more information to apply the discount. Please continue to checkout.
6201 DiscountCodeInvalid Discount code invalid. Please refresh and try again.
6202 DiscountCodeExpired Discount code expired. Please refresh and try again.
6203 DiscountCodeNotAvailable The discount code is not available.
6204 DiscountCodeLimitReached The discount code has exceeded usage limit.
6205 DiscountCodeMinCartAmountRequired The total cart amount is too low for this discount.
6206 DiscountCodeUniqueEmailRequired The email address has already redeemed the discount.
6207 DiscountCodeItemsNotEligible One or more items in the cart are not eligible for discount. Please refresh and try again.
6208 DiscountCodeItemQuantityTooLow The cart does not have enough items to meet the discount requirement.
Merchant Cart Errors    
Code # Code Text Prompt
6300 MerchantCartUnknownError An unknown error occurred when fetching the cart
6301 MerchantCartOutOfStock An item in your cart is no longer available. Please refresh your cart and try again.
6302 MerchantCartInvalidSize The sizes for some of the items are invalid
6303 MerchantCartInvalidQuantity The quantities for some of the items are invalid
6304 MerchantCartInvalidReference The references for some of the items are invalid
6305 MerchantCartInvalidAmount An item in your cart has been updated. Please refresh your cart and try again.
6306 MerchantCartExpired Your session timed out due to inactivity. Please refresh your cart and try again.
6307 MerchantOrderAlreadyExists Your order may have been placed. Please check your email for an order confirmation. If you did not receive an email please refresh this page and retry checkout.
Shipping and Tax Errors    
6100 IntegraionInvalidAddress N/A
6101 IntegraionNoPoBoxAllowed N/A
6102 IntegrationDiscountInvalid N/A
IntegrationCustomShippingTaxError    
6103 IntegrationCustomShippingTaxError N/A
Create_order and Update_cart Errors    
Code # Code Text Prompt
6600 IntegrationErrorUnkown N/A
6601 IntegrationGeneralError N/A
6602 IntegrationOrderAlreadyExists N/A
6603 IntegrationCartHasExpired N/A
6604 IntegrationItemPriceHasBeenUpdated N/A
6605 IntegrationOutOfInventory N/A
6606 IntegrationDiscountCannotApply N/A
6607 IntegrationDiscountCodeDoesNotExist N/A
6608 IntegrationShippingPriceHasBeenUpdated N/A
6609 IntegrationShippingAddressWrong N/A
6610 IntegrationOrderRejected N/A
6611 IntegrationProductDoesNotExist N/A
6612 IntegrationCartItemAddFailed N/A
6613 IntegrationCartItemRemoveFailed N/A
Miscellaneous Errors    
6400 ShippingCostInvalidAmount The shipping amount for your cart has changed. Please refresh your cart and try again.
6450 PluginFeatureSwitchInputInvalid The input to retrieve feature switches is invalid.
6451 PluginFeatureSwitchAlreadyExists Feature switch already exists for this plugin and name