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 |