Comprehensive list of errors that you might encounter when working with the Paddle API. Learn more about a particular error and get information about how to troubleshoot.
Encountered when working with entities across the Paddle API.
authentication_missing- Authentication header missing
Authorization header detected with your request.
authentication_malformed- Authentication header invalid
Authorization header was sent with your request, but it isn't in a valid format.
paddle_billing_not_enabled- Paddle Billing is not enabled
Your authentication is valid, but Paddle Billing is not enabled for this account.
The authentication method you used does not have permission to perform that request.
internal_error- Internal error
There's a temporary problem with the Paddle API. Your request was not processed.
service_unavailable- Service unavailable
The Paddle API is down for maintenance or temporarily unable to handle your request. Your request was not processed.
bad_gateway- Bad gateway
The Paddle API is temporarily unable to handle your request. Your request was not processed.
too_many_requests- Too many requests
There have been too many requests to the API from your IP address, so it's been temporarily rate-limited.
entity_archived- Entity archived and cannot be modified
The entity you're trying to modify is archived, so it can't be changed.
invalid_field- Request does not pass validation
One or more of the fields sent with your request aren't valid.
concurrent_modification- Concurrent modification
There were multiple concurrent requests to modify the same entity.
invalid_time_query_parameter- Unable to parse time query parameter
You are attempting to send an invalid timestamp as a query parameter
Encountered when working with address entities.
Encountered when working with adjustment entities.
adjustment_transaction_missing_customer_id- Cannot create adjustments for a transaction with a missing customer_id
You are creating and adjustment for a transaction that doesn't have a Customer ID attached.
adjustment_transaction_customer_mismatch- Adjustment customer mismatch
The customer_id specified in the adjustment doesn't match the one from the transaction.
adjustment_transaction_subscription_mismatch- Adjustment subscription mismatch
The subscription_id specified in the adjustment doesn't match the one from the transaction.
adjustment_transaction_invalid_status_for_credit- The transaction being adjusted (credit) has a non supported status
The transaction being adjusted (credit) has a non supported status.
adjustment_transaction_invalid_status_for_refund- The transaction being adjusted (refund) has a non supported status
The transaction being adjusted (refund) has a non supported status.
adjustment_invalid_credit_action- The adjustment action provided (credit) cannot be performed on the specified transaction
Adjustment is a credit, which is not compatible with the transaction specified
adjustment_invalid_combination_of_types- The adjustment has an invalid combination of types
The adjustment specifies a combination of items whose type is not compatible together.
adjustment_amount_above_remaining_allowed- Adjustment item amount defined is above the remaining allowed
Adjustments to the transaction item exceed the total amount left to adjust on the item.
adjustment_total_amount_above_remaining_allowed- Adjustment amount defined is above the remaining allowed
The adjustment amount exceeds the total amount left to adjust.
adjustment_transaction_item_has_already_been_fully_adjusted- Adjustment has already been made in full
You are attempting to adjust a line item that has already been fully adjusted
adjustment_no_tax_available_to_adjust- No tax available to adjust
You are attempting to make a tax adjustment on a transaction item but there's not available tax for it.
adjustment_amount_cannot_be_zero- Adjustment amount cannot be zero
You are attempting to make an adjustment with zero amount on a transaction item.
adjustment_pending_refund_request- Pending refund adjustment
You are attempting to create an adjustment but there is a pending refund request open
adjustment_transaction_item_over_adjustment- One or more adjustment items are being over adjusted.
One or more adjustment items are being over adjusted
Encountered when working with customer entities.
customer_already_exists- Attempt to create a customer with an existing email.
The customer being created already exists.
Encountered when working with discount entities.
discount_expired- Discount has expired
You are trying to apply a discount which has passed its expiration date.
discount_usage_limit_exceeded- Discount usage limit exceeded
You are trying to apply a discount which has exceeded the maximum usage limit.
discount_code_conflict- Duplicated discount code
Each of your Discounts must have a unique code, the requested code is in conflict with another Discount.
discount_restricted_product_not_active- Product not active
Each product ID given in the restricts_to field must be active.
Encountered when working with notifications and notification settings.
notification_maximum_active_settings_reached- Maximum notification settings reached
You tried to add a new active notification setting but already have 10 active settings.
notification_cannot_replay- Notification cannot be replayed
You're attempting to replay a notification that's not
url_notification_setting_incorrect- URL Notification Setting destination must be a URL
You're attempting to change a URL Notification Setting destination to something other than a URL.
email_notification_setting_incorrect- Email Notification Setting destination must be an email
You're attempting to change an email Notification Setting destination to something other than an email.
Encountered when working with price entities.
price_trial_period_missing_fields- Interval and frequency required for trial period
Occurs when your request contains trial_period but interval and frequency are not present.
price_trial_period_requires_billing_cycle- Billing cycle required for trial period
Occurs when your request contains trial_period but billing_cycle is not set.
price_billing_cycle_frequency_below_1- Billing cycle frequency must be equal to or higher than 1
Occurs when your supplied value for billing_cycle.frequency is below 1.
price_trial_period_frequency_below_1- Trial period frequency must be 1 or greater
Occurs when your supplied value for trial_period.frequency is below 1.
Encountered when working with product entities.
Encountered when working with subscription entities.
subscription_locked_renewal- Subscription locked for editing due to renewal
Occurs when you attempt to make a change to a subscription within the 30 minute subscription lock period before renewal.
subscription_locked_processing- Subscription locked for editing due to processing
Occurs when you attempt to make a change to a subscription within the 30 minute subscription lock period before processing.
subscription_locked_pending_changes- Subscription locked for editing while there are pending changes
Occurs when you attempt to make a change to a subscription while there is a change that is still pending.
subscription_update_when_canceled- Subscription cannot be updated when canceled
Occurs when you try to update a canceled subscription.
subscription_update_when_trialing- Subscription cannot be updated when trialing
Occurs when you try to update a trialing subscription.
subscription_cannot_be_paused- Action can't be performed on paused subscription
The action or change you are performing can't be performed on a paused subscription
subscription_is_canceled_action_invalid- Action can't be performed on canceled subscription
The action or change you are performing can't be performed when the subscription is canceled
subscription_is_inactive_action_invalid- Action can't be performed on inactive subscription
The action or change you are performing can't be performed when the subscription is inactive
subscription_update_when_past_due- Subscription cannot be updated when past due
Occurs when you try to update a past_due subscription.
subscription_not_automatic_collection- Subscription not in automatic collection mode
The action or change you are performing requires the subscription to be in automatic collection mode
subscription_not_active- Subscription not active
The action or change you are performing requires the subscription to be active
subscription_next_billed_at_too_soon- New next_billed_at timestamp is less than 30m from now
The new value set for next_billed_at needs to be at least 30m from now
subscription_outstanding_transaction- Subscription cannot update due to outstanding transaction
Cannot update subscription due to an outstanding subscription transaction
subscription_must_be_paused- Action can only be performed when subscription is paused
The action or change you are performing requires the subscription to be in a paused state
subscription_all_items_removed- Subscription update removes all items
The subscription update request removes all items.
subscription_update_error_when_paused- Subscription items update error when paused
Subscription items cannot be updated with proration or bill immediately when the subscription is paused.
subscription_items_update_missing_proration_billing_mode- Subscription items update without proration billing mode
Subscription items cannot be updated without providing a valid proration billing mode.
subscription_discount_not_valid_for_items- Discount not valid for items on subscription
The discount is not valid for any items in subscription.
subscription_one_off_discount_not_valid- One-off discount not valid for subscription
The one-off discount added is not valid for subscription.
subscription_duplicate_price_ids- Duplicate `price_id` fields sent in the items list
The subscription cannot have multiple items with the same
subscription_scheduled_change_invalid_update- Attempt to update a scheduled change
You can't change
scheduled_change, except for
subscription_only_update_items_on_paused_subscription- Only items can be updated when subscription paused
You can only update items on a paused subscription.
subscription_incorrect_proration_on_paused_subscription- Proration billing mode not accepted on paused subscription
do_not_bill is the only valid
proration_billing_mode for paused subscriptions.
subscription_billing_details_required- Billing details required when creating transaction for manual collection mode subscription
Billing details need to be set to create a transaction when a subscriptions collection_mode is set to manual.
subscription_new_items_not_valid- New items not valid in subscription update
The new items requested to be added are not valid when updating this subscription.
subscription_quantity_missing_for_new_items- Quantity field missing for new items in subscription update
When adding new items the quantity field must be included for each item.
subscription_charge_duplicate_price_ids- Duplicate `price_id` fields sent in the items list
You're attempting to create a one-time charge for one or more of the same items in the same request.
subscription_no_recurring_items_remain- No recurring items on subscription
After performing this update there would be no recurring items remaining. At least one recurring item is required.
subscription_quantity_not_valid- Item quantity out of range
Quantity of item requested is out of range of the allowed values.
subscription_currency_code_not_valid_for_manual- Currency code not valid for manual collection mode
You are attempting to update a subscription to manual billing mode but the currency code is not valid
subscription_customer_not_suitable_for_collection_mode- Customer entity not valid for current collection mode
You are attempting to update a subscription but the customer entity is not valid for the current collection mode
subscription_address_not_suitable_for_collection_mode- Address entity not valid for current collection mode
You are attempting to update a subscription but the address entity is not valid for the current collection mode
subscription_invalid_discount_currency- Flat discount is for a currency other than that of the subscription
You are attempting to apply a flat discount that has a different currency to that of the subscription
subscription_trialing_items_update_invalid_options- Invalid update options for items on a trialing subscription
You are attempting to update items on a trialing subscription with invalid options
subscription_cannot_activate- Subscription cannot activate
You are attempting to activate a subscription which does not have trialing status
subscription_outstanding_pending_refund- Subscription pending refund
The subscription change is attempting to create an adjustment but there is a pending refund request open
subscription_outstanding_balance_different_currency- Outstanding balance in a different currency
Credit adjustments are currently restricted to one currency, the currency of the customer balance. This balance currency is determined by the first adjustment
subscription_trialing_discount_update_invalid_options- Invalid update options for discount on a trialing subscription
You are attempting to add or update a discount on a trialing subscription with invalid options
Encountered when working with transaction entities.
transaction_immutable- Transaction is in immutable state
You are trying to update a transaction which is not in the draft or ready state.
transaction_discount_not_eligible- Discount not applicable for transaction items
You are applying a discount that doesn't apply to any of the transaction items.
transaction_not_ready_cannot_process_payment- Cannot process payment for a transaction with non-ready status
You are processing payment for a transaction that's not in a ready state
transaction_default_checkout_url_not_set- Default Checkout URL has not been defined
You are trying to create/update a transaction but no default checkout URL has been set on this account.
transaction_checkout_not_enabled- Checkout has not been enabled
You are trying to create/update a transaction but checkouts are disabled for this account.
transaction_customer_is_required_with_address- Customer ID is required for validating an address
customerID is required for validating an address
transaction_customer_is_required_for_business_validation- Customer ID is required for validating an business
CustomerID is required for validating an business
transaction_price_different_billing_cycle- Cannot have different price billing cycle intervals and/or frequencies
You are attempting to create a transaction with prices that have differing billing cycle intervals and/or frequencies
transaction_price_different_trial_period- Cannot have different trial period intervals and/or frequencies
You are attempting to create a transaction with prices that have differing trial period intervals and/or frequencies
transaction_item_quantity_out_of_range- Quantity provided is not within the price quantity range
You are attempting to provide an item quantity that is not within the price quantity range
transaction_both_price_id_and_object_found- Cannot send both price ID and Price Object in the same line item
You are attempting to send both the Price ID and Price Object on the same line item
transaction_price_not_found- Price ID cannot be found
You are attempting to send one or more Price ID(s) that can't be found
transaction_product_not_found- Product ID cannot be found
You are attempting to send one or more Product ID(s) that cant be found
transaction_cannot_be_modified_and_canceled- Transaction cannot be modified and canceled
You are attempting to cancel a transaction whilst passing fields to update
transaction_discount_not_found- Discount Code or ID cannot be found
You are attempting to add a Discount Code/ID that cant be found
transaction_cannot_provide_both_discount_code_and_id- Cannot provide both Discount Code and ID
You are attempting to add a Discount Code and ID
transaction_billing_details_must_be_null- Billing details must be null if the collection mode is automatic
You are attempting to set billing details when the collection mode is automatic
transaction_billing_details_object_required- Billing details must not be null if the collection mode is manual
You are attempting to set collection mode as manual without Billing Details being provided
transaction_payment_terms_object_required- Payment Terms must be non null when initially setting Billing Details
You have not provided Payment Details whilst setting Billing Details
transaction_balance_less_than_charge_limit- Transaction balance is less than charge limit
For a transaction to be ready for payment it must have a chargeable amount greater than 70 cent USD
transaction_status_must_be_ready- Transaction status needs to be ready
You are attempting to perform an action that requires the transaction to be in the ready status
transaction_customer_not_suitable_for_collection_mode- Customer entity not valid for current collection mode
You are attempting to create a transaction but the customer entity is not valid for the current collection mode
transaction_address_not_suitable_for_collection_mode- Address entity not valid for current collection mode
You are attempting to create a transaction but the address entity is not valid for the current collection mode
transaction_currency_code_not_valid_for_manual- Currency code not valid for manual collection mode
You are attempting to create a manual transaction but the currency code is not valid
transaction_preview_adjustment_subscription_conflict- When previewing a transaction with multiple adjustments all the transaction need to belong to the same subscription.
You are attempting to preview a transaction with several adjustments, but the transactions associated to them have different subscription IDs
transaction_invalid_discount_currency- Flat discount is for a currency other than that of the transaction
You are attempting to apply a flat discount that has a different currency to that of the transaction
transaction_billing_period_starts_at_greater_than_now- New `billing_period.starts_at` timestamp is greater than now
The value for
billing_period.starts_at cannot be in future
transaction_checkout_url_domain_is_not_approved- Checkout URL domain has not yet been approved
The value you passed for
checkout.url does not contain a domain that has been approved by Paddle
transaction_recurring_balance_less_than_charge_limit- Transaction recurring balance is less than charge limit
For a transaction with recurring prices to be ready for payment, the recurring chargeable amount must be greater than 70 cent USD