Docs

Error reference

A list of all the errors that you can encounter when working with the Paddle API. Learn more about a particular error and get information about how to troubleshoot.

How errors work

The Paddle API uses standard HTTP response codes to let you know when something's wrong. It also returns some useful information to help you troubleshoot.

When you encounter an error, the API returns an error object rather than a data object or array. Validation errors include an errors array with details of each invalid field.

If you're having trouble, include the request_id in the response when contacting support.

Learn more about errors in the API reference →

Error
{
"error": {
"type": "request_error",
"code": "not_found",
"detail": "Product pro_01ghbk4xjn4qdsmstcwzgcgg35 not found.",
"documentation_url": "https://developer.paddle.com/errors/shared/not_found"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}
Validation error
{
"error": {
"type": "request_error",
"code": "invalid_field",
"detail": "Request does not pass validation.",
"documentation_url": "https://developer.paddle.com/errors/shared/invalid_field",
"errors": [
{
"field": "active",
"message": "must be provided as part of the request"
},
{
"field": "description",
"message": "maximum length of 256 exceeded. provided value length 653"
}
]
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Addresses

Encountered when working with address entities.

Adjustments

Encountered when creating or working with transaction adjustments.

Businesses

Encountered when working with business entities on a customer.

Currencies

Encountered when working with currencies or currency-related settings.

Customers

Encountered when working with customer entities.

Discounts

Encountered when working with discount entities.

Notifications

Encountered when working with notification and webhook entities.

Payment methods

Encountered when working with saved payment method entities.

Prices

Encountered when working with price entities.

Products

Encountered when working with product entities.

Reports

Encountered when working with report entities.

Generic

General errors that can occur across the API.

Subscriptions

Encountered when working with subscription entities.

subscription_address_not_suitable_for_collection_mode subscription_all_items_removed subscription_archived_discount_application_attempt subscription_billing_details_required subscription_cannot_activate subscription_cannot_be_paused subscription_charge_duplicate_price_ids subscription_consent_granted_too_early subscription_consent_requirement_cannot_activate subscription_continuing_existing_billing_period_not_allowed subscription_continuing_existing_billing_period_not_allowed_subscription_past_due subscription_credit_creation_against_processing_transaction subscription_credit_creation_against_uncompleted_transaction_not_allowed subscription_currency_code_incompatible_with_payment_method_provider subscription_currency_code_not_valid_for_manual subscription_currency_update_and_actions_creating_credits_not_allowed subscription_currency_update_not_allowed subscription_customer_email_domain_not_allowed subscription_customer_not_suitable_for_collection_mode subscription_discount_not_valid_for_items subscription_duplicate_price_ids subscription_immediate_charge_24_hour_limit_exceeded subscription_immediate_charge_hour_limit_exceeded subscription_incorrect_proration_on_paused_subscription subscription_invalid_billing_mode_for_scheduled_change subscription_invalid_discount_currency subscription_is_canceled_action_invalid subscription_is_inactive_action_invalid subscription_items_update_missing_proration_billing_mode subscription_locked_consent_review_period subscription_locked_pending_changes subscription_locked_processing subscription_locked_renewal subscription_manual_collection_mode_activation_not_allowed subscription_manual_retry_payment_not_allowed subscription_maximum_number_of_line_items_reached subscription_missing_payment_method_cannot_activate subscription_missing_payment_method_cannot_resume subscription_missing_payment_method_cannot_retry_payment subscription_missing_payment_method_cannot_update subscription_must_be_paused subscription_new_items_not_valid subscription_next_billed_at_too_soon subscription_no_recurring_items_remain subscription_not_active subscription_not_automatic_collection subscription_one_off_charges_not_allowed_on_cardless_trial subscription_one_off_discount_not_valid subscription_only_update_items_on_paused_subscription subscription_outstanding_pending_refund subscription_outstanding_transaction subscription_pausing_not_allowed_for_cardless_trial subscription_payment_declined subscription_payment_retry_attempts_exceeded subscription_price_not_found subscription_price_requires_payment_method_on_cardless_trial subscription_product_tax_category_not_approved subscription_quantity_missing_for_new_items subscription_quantity_not_valid subscription_scheduled_change_invalid_update subscription_scheduled_change_not_allowed_for_cardless_trial subscription_trialing_discount_update_invalid_options subscription_trialing_items_update_invalid_options subscription_update_causing_customer_mismatch_not_allowed subscription_update_different_currency_credits subscription_update_transaction_balance_less_than_charge_limit subscription_update_when_canceled subscription_update_when_past_due subscription_update_when_trialing

Transactions

Encountered when working with transaction entities.

transaction_address_not_suitable_for_collection_mode transaction_address_region_or_city_already_set transaction_adjusted_unable_to_revise transaction_balance_less_than_charge_limit transaction_billing_details_must_be_null transaction_billing_details_object_required transaction_billing_period_starts_at_greater_than_now transaction_both_price_id_and_object_found transaction_cannot_be_modified_and_canceled transaction_cannot_be_revised_with_invalid_tax_identifier transaction_cannot_be_revised_with_tax_higher_than_grand_total_or_negative_tax transaction_cannot_provide_both_discount_code_and_id transaction_checkout_not_enabled transaction_checkout_url_domain_is_not_approved transaction_creation_blocked transaction_currency_code_not_valid_for_manual transaction_custom_data_numeric_value_too_large transaction_customer_is_required_for_business_validation transaction_customer_is_required_with_address transaction_customer_not_suitable_for_collection_mode transaction_default_checkout_url_not_set transaction_discount_not_eligible transaction_discount_not_found transaction_duplicate_price_ids transaction_immutable transaction_immutable_while_processing_payment transaction_invalid_combination_of_requires_payment_method_prices transaction_invalid_discount_currency transaction_invalid_status_change transaction_invalid_status_to_revise transaction_item_quantity_out_of_range transaction_manual_must_require_payment_method transaction_maximum_number_of_line_items_reached transaction_not_ready_cannot_process_payment transaction_nothing_to_revise transaction_payment_method_change_field_immutable transaction_payment_terms_frequency_greater_than_maximum transaction_payment_terms_object_required transaction_payout_account_required transaction_preview_adjustment_subscription_conflict transaction_price_different_billing_cycle transaction_price_different_trial_period transaction_price_not_found transaction_product_not_found transaction_recurring_balance_less_than_charge_limit transaction_requires_currency_code_for_custom_discount transaction_revise_missing_business_name transaction_revised_limit_reached transaction_status_must_be_ready