The Paddle API is temporarily unable to handle your request. Your request was not processed.

Bad gateway

Overview

Entity not found

Invalid URL

Authentication header missing

Authentication header invalid

Invalid API key

Paddle Billing is not enabled

Forbidden

Bad request

Internal error

Service unavailable

Method not allowed

Not implemented

Too many requests

Entity archived and cannot be modified

Request does not pass validation

Concurrent modification

Conflict

JSON payload invalid

Unable to parse time query parameter

Invalid Content-Type header

Receipt data has not been enabled

Shared

Address cannot be created or updated with this country

Addresses

Cannot create adjustments for a transaction with a missing customer_id

Adjustment customer mismatch

Adjustment subscription mismatch

The transaction being adjusted (credit) has a non supported status

The transaction being adjusted (refund) has a non supported status

The adjustment action provided (credit) cannot be performed on the specified transaction

The adjustment has an invalid combination of types

Adjustment item amount defined is above the remaining allowed

Adjustment amount defined is above the remaining allowed

Adjustment has already been made in full

No tax available to adjust

Adjustment amount cannot be zero

Pending refund adjustment

One or more adjustment items are being over adjusted.

One or more adjustment items cannot be processed

Adjustments

Attempt to create a customer with an existing email.

Customer cannot be created or updated with this email address

Customer email address is invalid

Customers

Discount has expired

Discount usage limit exceeded

Duplicated discount code

Product not active

Product Price not active

Discounts

Maximum notification settings reached

Notification cannot be replayed

URL Notification Setting destination must be a URL

Email Notification Setting destination must be an email

Can only replay notifications with an origin of event

Notifications

Interval and frequency required for trial period

Billing cycle required for trial period

Billing cycle frequency must be equal to or higher than 1

Trial period frequency must be 1 or greater

Duplicate currency override for country

Prices

Tax category not approved

Products

Subscription locked for editing due to renewal

Subscription locked for editing due to processing

Subscription locked for editing while there are pending changes

Subscription cannot be updated when canceled

Subscription cannot be updated when trialing

Action can't be performed on paused subscription

Action can't be performed on canceled subscription

Action can't be performed on inactive subscription

Subscription cannot be updated when past due

Subscription not in automatic collection mode

Subscription not active

New next_billed_at timestamp is less than 30m from now

Subscription cannot update due to outstanding transaction

Action can only be performed when subscription is paused

Subscription update removes all items

Subscription items update error when paused

Subscription items update without proration billing mode

Discount not valid for items on subscription

One-off discount not valid for subscription

Duplicate `price_id` fields sent in the items list

Attempt to update a scheduled change

Only items can be updated when subscription paused

Proration billing mode not accepted on paused subscription

Payment declined

Billing details required when creating transaction for manual collection mode subscription

New items not valid in subscription update

Quantity field missing for new items in subscription update

No recurring items on subscription

Item quantity out of range

Currency code not valid for manual collection mode

Currency code incompatible with the payment method provider

Customer entity not valid for current collection mode

Address entity not valid for current collection mode

Flat discount is for a currency other than that of the subscription

Invalid update options for items on a trialing subscription

Subscription cannot activate

Subscription pending refund

Invalid update options for discount on a trialing subscription

Subscription update is less than charge limit

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

Updating currency not allowed because of pending credits

Creating credits after currency was updated

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

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

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

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

Subscriptions

Transaction is in immutable state

Discount not applicable for transaction items

Cannot process payment for a transaction with non-ready status

Default Checkout URL has not been defined

Checkout has not been enabled

Customer ID is required for validating an address

Customer ID is required for validating an business

Cannot have different price billing cycle intervals and/or frequencies

Cannot have different trial period intervals and/or frequencies

Quantity provided is not within the price quantity range

Cannot send both price ID and Price Object in the same line item

Price ID cannot be found

Product ID cannot be found

Transaction cannot be modified and canceled

Discount Code or ID cannot be found

Cannot provide both Discount Code and ID

Invalid status change

Billing details must be null if the collection mode is automatic

Billing details must not be null if the collection mode is manual

Payment Terms must be non null when initially setting Billing Details

Transaction balance is less than charge limit

Transaction status needs to be ready

When previewing a transaction with multiple adjustments all the transaction need to belong to the same subscription.

Flat discount is for a currency other than that of the transaction

New `billing_period.starts_at` timestamp is greater than now

Checkout URL domain has not yet been approved

Transaction recurring balance is less than charge limit

Duplicate Price IDs were passed as separate items

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

Transactions

Error Message	`Paddle API is down temporarily and can't process your request`
Error Code	`bad_gateway`
Status Code	`502`

Bad gateway

Common causes

Solutions

Bad gateway

Common causes

Solutions

Sign up to get notified when our API evolves