Order Details
User History
Prices
Coupons
Products
Licenses
Pay Links
Transactions
Payments
Plans
Users
Modifiers
Payments
One-off Charges
Webhooks

API Error Codes

The Paddle APIs will return errors for invalid requests, calls missing data or internal/external errors.

API Errors

An unsuccessful call to the Dashboard API will return a 200 response containing a field success set to false. Additionally an error object will be returned, containing a code referencing the error, and a message in a human-readable format.

Error Response
object
success
boolean
1 validation
error
object

API Error Reference

A reference containing the different possible errors from the Dashboard API is included below.

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 commision
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.