Error Overview - Paddle Developer

Shared

Encountered when working with entities across the Paddle API.

not_found - Entity not found

The entity you're trying to work with doesn't exist.

invalid_url - Invalid URL

The URL you called is invalid.

authentication_missing - Authentication header missing

No Authorization header detected with your request.

authentication_malformed - Authentication header invalid

An Authorization header was sent with your request, but it isn't in a valid format.

invalid_token - Invalid API key

The API key used for your request isn't valid.

invalid_client_token - Invalid client-side token

The client-side token used for your request isn't valid.

paddle_billing_not_enabled - Paddle Billing is not enabled

Your authentication is valid, but Paddle Billing is not activated for this account.

forbidden - Forbidden

The authentication method you used doesn't have permission to perform that request.

bad_request - Bad request

Something isn't right with your request.

internal_error - Internal error

Something went wrong processing your request. Your request was not processed.

service_unavailable - Service unavailable

The endpoint is down for maintenance or temporarily unable to handle your request. Your request was not processed.

method_not_allowed - Method not allowed

The endpoint does not support the HTTP method you used.

not_implemented - Not implemented

The method used to make your request isn't recognized.

bad_gateway - Bad gateway

The endpoint 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.

temporarily_unavailable - Temporarily unavailable

Endpoint is temporarily disabled for your account.

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.

conflict - Conflict

Your request conflicts with another change.

invalid_json - JSON payload invalid

Your request isn't valid JSON.

unexpected_request_body - Unexpected request body

Your request contains a body, but this is not expected for this endpoint.

invalid_time_query_parameter - Unable to parse time query parameter

You're sending an invalid timestamp as a query parameter.

unsupported_media_type - Invalid Content-Type header

The request has an invalid Content-Type header.

receipt_data_not_enabled - Receipt data has not been enabled

You're attempting to pass receipt_data as part of your request, but it's not enabled for your account.

request_headers_too_large - Request Header Fields Too Large

The provided request URI length or headers are too large.

request_body_too_large - Content Too Large

The provided request body is too large.

Addresses

Encountered when working with address entities.

address_location_not_allowed - Address cannot be created or updated with this country

You are trying to create or update an address with a location not supported by Paddle.

Adjustments

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

adjustment_transaction_item_invalid - One or more adjustment items cannot be processed

One or more adjustment items cannot be processed

Customers

Encountered when working with customer entities.

customer_already_exists - Attempt to create a customer with an existing email.

The customer being created already exists.

customer_email_domain_not_allowed - Customer cannot be created or updated with this email address

You are trying to create or update a customer with an email address indicating a location not supported by Paddle.

customer_email_invalid - Customer email address is invalid

You are trying to create or update a customer with an invalid email address.

Discounts

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.

discount_restricted_product_price_not_active - Product Price not active

Each Product Price ID given in the restricts_to field must be active.

discount_usage_limit_less_than_times_used - Unable to reduce usage limit as times used is greater than provided value

Unable to reduce usage limit as times used is greater than provided value.

Notifications

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 delivered or failed.

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.

notification_replay_invalid_origin_type - Can only replay notifications with an origin of event

You're attempting to replay a notification with an invalid origin type.

Prices

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.

price_duplicate_currency_override_for_country - Duplicate currency override for country

duplicate currency override for country

Products

Encountered when working with product entities.

product_tax_category_not_approved - Tax category not approved

Occurs when you supply a tax category which is unapproved for your account.

Saved payment methods

Encountered when working with saved payment method entities.

payment_method_in_use - Payment method cannot be deleted as its in use on an active, trialing, paused or past_due subscription

You are trying to delete a payment method that is in use on an active, trialing, paused or past_due subscription.

Reports

Encountered when working with reports entities.

report_creation_limit_exceeded - Report creation limit exceeded

Occurs when you attempt to create more than 10 reports in last 24 hours

concurrent_report_generation_not_allowed - Concurrent report generation not allowed

Occurs when you attempt to generate more than report at a time.

report_not_ready - Report not ready

Report is still generating

report_expired - Report expired

Report unavailable to download as it is expired

report_failed - Report failed

Report unavailable to download as it failed

report_empty - Report empty

Report unavailable to download due to no results

Subscriptions

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_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 price_id.

subscription_scheduled_change_invalid_update - Attempt to update a scheduled change

You can't change scheduled_change, except for null.

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_payment_declined - Payment declined

When requesting to charge the payment was declined.

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_currency_code_incompatible_with_payment_method_provider - Currency code incompatible with the payment method provider

You are attempting to update a subscription's currency code to one that is incompatible with the payment method provider

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_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

subscription_update_transaction_balance_less_than_charge_limit - Subscription update is less than charge limit

A subscription update must result in a transaction balance which is above the lower limit of 70 cent USD

subscription_customer_email_domain_not_allowed - Cannot create or preview transaction using a customer with this email address

You are trying to create or preview a transaction using a customer with an email address indicating a location not supported by Paddle.

subscription_currency_update_not_allowed - Updating currency not allowed because of pending credits

You are attempting to update the currency of a subscription when pending credits are present

subscription_update_different_currency_credits - Creating credits after currency was updated

You are attempting to update subscription by generating credits after currency was updated

subscription_currency_update_and_actions_creating_credits_not_allowed - Updating currency and performing any action creating credits at the same time not allowed

You are attempting to update currency and perform action creating credits at the same time

subscription_credit_creation_against_uncompleted_transaction_not_allowed - Cannot make a change to a subscription that generates a credit for an uncompleted transaction

You can't make a change to a subscription that generates a credit for an uncompleted transaction

subscription_update_causing_customer_mismatch_not_allowed - Cannot make a subscription update resulting in a mismatch between customer entities

You are attempting to make an update to a subscription that will result in a mismatch between customer entities.

subscription_credit_creation_against_processing_transaction - Cannot make a change to a subscription that generates a credit for a transaction that is currently being processed

You can't make a change to a subscription that generates a credit for a transaction that is currently being processed.

subscription_product_tax_category_not_approved - Tax category not approved

Occurs when you supply a tax category for a non-catalog item that is not approved for your account.

subscription_manual_collection_mode_activation_not_allowed - Cannot activate a manually-collected subscription

You can't activate a subscription where collection_mode is manual.

subscription_archived_discount_application_attempt - Archived discount cannot be applied

You cannot apply an archived discount to a subscription.

subscription_maximum_number_of_line_items_reached - Transaction for a subscription has more than the maximum number of line items

You can't make a change to a subscription that creates a related transaction with more than 100 items.

subscription_immediate_charge_hour_limit_exceeded - Too many immediate charges made in one hour

You've reached the hourly limit for immediate charges to this subscription.

subscription_immediate_charge_24_hour_limit_exceeded - Too many immediate charges made in 24 hours

You've reached the daily limit for immediate charges to this subscription.

subscription_continuing_existing_billing_period_not_allowed - Cannot continue the existing billing period

You can't choose to continue the existing billing period, as the billing period ended already.

subscription_continuing_existing_billing_period_not_allowed_subscription_past_due - Cannot continue the existing billing period for a past due subscription

You can't choose to continue the existing billing period, as the subscription is past due

Transactions

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_payout_account_required - Payout account is required for processing a transaction

You are trying to create/update a transaction but no payout account has been set on 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 a business

CustomerID is required for validating a 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_invalid_status_change - Invalid status change

Invalid status change attempted

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

transaction_duplicate_price_ids - Duplicate Price IDs were passed as separate items

Cannot have duplicate Price IDs passed as separate items

transaction_payment_method_change_field_immutable - Only customer, address, and business information may be changed for a transaction created to update a payment method.

Only customer, address, and business information may be changed for a transaction created to update a payment method.

transaction_invalid_status_to_revise - A transaction must be in the status of billed or completed to be revised.

A transaction must be in the status of billed or completed to be revised.

transaction_revised_limit_reached - A transaction has already been revised.

A transaction has already been revised.

transaction_adjusted_unable_to_revise - A transaction cannot be revised if it has been adjusted.

A transaction cannot be revised if it has been adjusted.

transaction_immutable_while_processing_payment - Cannot update transaction while payment in progress

You're trying to update a transaction while a payment attempt is in progress.

transaction_cannot_be_revised_with_invalid_tax_identifier - Cannot revise transaction with invalid tax identifier

You're trying to revise a transaction with an invalid tax identifier.

transaction_cannot_be_revised_with_tax_higher_than_grand_total_or_negative_tax - Cannot revise transaction when the tax amount is higher than the grand total or tax is negative.

You're trying to revise a transaction with a valid tax_identifier, when tax amount is higher than the grand total or tax is negative.

transaction_maximum_number_of_line_items_reached - Maximum number of line items reached

You're trying to add more line items than is currently allowed on a transaction.

transaction_nothing_to_revise - Nothing to revise

Transaction not revised based on your request.

transaction_revise_missing_business_name - Cannot revise a transaction without a business name

You're trying to revise a transaction to add business information, but you haven't provided a name.

transaction_address_region_or_city_already_set - Cannot revise address region or city

You're trying to revise a transaction to update the city or region, but these fields are already set and can't be changed.

Errors

Sign up to get notified when our API evolves