Error Codes – Bolt

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