API Error Codes

Paddle APIs return errors for invalid requests, calls missing data, and internal or external errors.

---

Error format

Unsuccessful calls return a 200 response with a field called success as false and an error object.

List of error codes and messages

Code	Message
100	Unable to find requested license
101	Bad method call
102	Bad api key
103	Timestamp is too old or not valid
104	License code has already been utilized
105	License code is not active
106	Unable to find requested activation
107	You don’t have permission to access this resource
108	Unable to find requested product
109	Provided currency is not valid
110	Unable to find requested purchase
111	Invalid authentication token
112	Invalid verification token
113	Invalid padding on decrypted string
114	Invalid or duplicated affiliate
115	Invalid or missing affiliate commission
116	One or more required arguments are missing
117	Provided expiration time is incorrect
118	Price is too low
119	Unable to find requested subscription
120	Request failed due to internal error
121	Unable to find requested payment
122	Provided date is not valid
123	Unable to find requested modifier
124	Modifiers that have already been paid cannot be altered or deleted
125	Main currency price was not provided
126	A valid email address is required, please try again
127	The given coupon type is not recognised. The only valid types are flat and percentage.
128	The given percentage is not valid. The percentage must be a number less than 100.
129	The given amount is not a valid flat amount. The amount must be a number equal to or greater than 0.01.
130	The allowed uses must be a number.
131	The given coupon code is invalid. The code must have at least 5 characters.
132	The given coupon code has already been used for the product.
133	The given coupon expiration date is invalid. The expected date format is “Y-m-d”.
134	The given coupon currency is invalid. The currency must be one of the currencies of your product.
135	Unable to find requested coupon
136	Allowed uses cannot be less than times used.
137	The allowed uses must be a number greater than or equal to 0.
138	The expires at value must be either not provided or a future date in the format of Y-m-d.
139	The given prices format is not valid. The prices must have the format of [‘currency:amount’, ‘currency:amount’, …].
140	The given currency code is unknown to our checkout system.
141	Either a product ID or a plan ID should be given, not both.
142	The given recurring prices format is not valid. The recurring prices must have the format of [‘currency:amount’, ‘currency:amount’, …].
143	Recurring price is too low
144	Affiliate split sum must total less than 100%
145	Recurring affiliate split must either be not set, or set to an integer equal to or greater than 1.
146	The current invoice of this subscription is currently being processed, and cannot be updated at this time
147	We were unable to complete the resubscription because we could not charge the customer for the resubscription
148	The resubscription requires immediate billing so we cannot complete your request
149	The plan interval is invalid
150	Initial price is too low
151	The subscription cannot be updated at this time. Please try later.
152	Plan changes can not be made whilst the customer is in their trial period.
153	The trial length must be a positive integer.
154	Unable to find requested order
155	The given amount is not valid.
156	The Order cannot be refunded.
157	An unknown coupon error has occurred.
158	The coupon currency must match your balance currency
159	The parameters combination is incorrect.
160	Invalid recurring option.
161	The minimum threshold must be numeric and higher than 0.01.
162	The group has to be a string with at least 1 character and no more than 50 characters.
163	The number of coupons is invalid.
164	The can_multiple_in_same_checkout parameter has to be a boolean value.
165	The given coupon target is not recognised. The only valid types are product and checkout.
166	The description has to be a string.
167	You cannot set the amount for Flat and Percentage coupons at the same time.
168	The product type must be a subscription plan.
170	license_code is not set.
171	download_url is not set or invalid.
172	The transaction can no longer be refunded.
173	The subscription does not allow quantities to be set.
174	Cannot move to this plan as it doesn't support the subscription currency.
175	Invalid country code.
176	This order already has a license code attached to it
177	product_name is not set.
180	download_url is invalid.
181	charge_name is too long or invalid. Length limit: 50
182	The given subscription ID is invalid. IDs must be numeric.
183	Charges cannot be made with a negative amount
184	Access Denied.
185	Subscription billing cycles exceeded. Subscription expired.
186	Amount is less than allowed minimum transaction amount.
187	Subscription has been deleted.
188	Transaction failed.
189	Rate limit reached for this type of request. Please try again later.
190	No valid payment method found
191	You cannot pass an offset without defining a limit
192	No other modifications are allowed when pausing/unpausing a subscription
193	You can not pause/unpause this subscription
194	Changes can not be made whilst the subscription is paused.
195	The given cancellation reason is not valid.
196	Subscription is in a past_due state and the plan can therefore not be changed.
197	The subscription of the customer is not active.
198	The selected new plan is invalid.
199	No other modifications except pausing and changing the passthrough are allowed on a past due subscription.
205	Seller statement descriptor is already in use by another seller, please choose a different one
206	Charges cannot be made whilst the subscription is paused
207	The given postcode is invalid