Occurs when your request contains trial_period but billing_cycle is not set.

Billing cycle required for trial period

Overview

Entity not found

Invalid URL

Authentication header missing

Authentication header invalid

Invalid API key

Invalid client-side token

Paddle Billing is not enabled

Forbidden

Bad request

Internal error

Service unavailable

Method not allowed

Not implemented

Bad gateway

Too many requests

Temporarily unavailable

Entity archived and cannot be modified

Request does not pass validation

Concurrent modification

Conflict

JSON payload invalid

Unexpected request body

Unable to parse time query parameter

Invalid Content-Type header

Receipt data has not been enabled

Request Header Fields Too Large

Content Too Large

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

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

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

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

Saved payment methods

Report creation limit exceeded

Concurrent report generation not allowed

Report not ready

Report expired

Report failed

Report empty

Reports

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

Maximum payment retry attempts exceeded

Cannot retry payments for manually-collected subscription transactions

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

Cannot activate a manually-collected subscription

Archived discount cannot be applied

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

Too many immediate charges made in one hour

Too many immediate charges made in 24 hours

Cannot continue the existing billing period

Cannot continue the existing billing period for a past due subscription

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

Payout account is required for processing a transaction

Customer ID is required for validating an address

Customer ID is required for validating a 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.

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

A transaction has already been revised.

A transaction cannot be revised if it has been adjusted.

Cannot update transaction while payment in progress

Cannot revise transaction with invalid tax identifier

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

Error Message	`setting a trial_period requires billing_cycle to be set`
Error Code	`price_trial_period_requires_billing_cycle`
Status Code	`400`

Billing cycle required for trial period

Common causes

Solutions

Billing cycle required for trial period

Common causes

Solutions

Sign up to get notified when our API evolves