PATCH
/subscriptions/{subscription_id}/preview Previews an update for a subscription without applying those changes. Typically used for previewing proration before making changes to a subscription.
If successful, your response includes immediate_transaction, next_transaction, and recurring_transaction_details so you can see expected transactions for the changes.
The update_summary object contains details of prorated credits and charges created, along with the overall result of the update.
Requires subscription.read
permission.
Path parameters
subscription_idstringrequired
Paddle ID of the subscription entity to work with.
Request body
customer_idstring
Example:
ctm_01grnn4zta5a1mf02jjze7y2ysPaddle ID of the customer that this subscription is for, prefixed with
ctm_. Include to change the customer for a subscription.Pattern:
^ctm_[a-z\d]{26}$address_idstring
Example:
add_01gm302t81w94gyjpjpqypkzkfPaddle ID of the address that this subscription is for, prefixed with
add_. Include to change the address for a subscription.Pattern:
^add_[a-z\d]{26}$business_idstring | null
Example:
biz_01grrebrzaee2qj2fqqhmcyzajUnique Paddle ID for this business entity, prefixed with
biz_.Pattern:
^biz_[a-z\d]{26}$currency_codestring
Supported three-letter ISO 4217 currency code. Include to change the currency that a subscription bills in. When changing
collection_mode to manual, you may need to change currency code to USD, EUR, or GBP.Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
next_billed_atstring (date-time)
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this subscription is next scheduled to be billed. Include to change the next billing date.
discountobject | null
Details of the discount applied to this subscription. Include to add a discount to a subscription.
null to remove a discount.idstringrequired
Example:
dsc_01gv5kpg05xp104ek2fmgjwttfUnique Paddle ID for this discount, prefixed with
dsc_.Pattern:
^dsc_[a-z\d]{26}$effective_fromstringrequired
When this discount should take effect from.
Values
next_billing_periodTakes effect on the next billing period.immediatelyTakes effect immediately.
collection_modestring
How payment is collected for transactions created for this subscription.
automatic for checkout, manual for invoices.Values
automaticPayment is collected automatically using a checkout initially, then using a payment method on file.manualPayment is collected manually. Customers are sent an invoice with payment terms and can make a payment offline or using a checkout. Requiresbilling_details.
billing_detailsobject | null
Details for invoicing. Required if
collection_mode is manual.enable_checkoutboolean
Default:
falseWhether the related transaction may be paid using Paddle Checkout.
purchase_order_numberstring
Customer purchase order number. Appears on invoice documents.
Max length: 100
additional_informationstring | null
Notes or other information to include on this invoice. Appears on invoice documents.
Max length: 1500
payment_termsobject
How long a customer has to pay this invoice once issued.
intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
scheduled_changenull
Change that's scheduled to be applied to a subscription. When updating, you may only set to
null to remove a scheduled change. Use the pause subscription, cancel subscription, and resume subscription operations to create scheduled changes.itemsarray
List of items on this subscription. Only recurring items may be added. Send the complete list of items that should be on this subscription, including existing items to retain.
Items: 1–100
Catalog item
price_idstringrequired
Example:
pri_01gsz8z1q1n00f12qt82y31smhPaddle ID for the price to add to this subscription, prefixed with
pri_.Pattern:
^pri_[a-z\d]{26}$quantitynumber
Quantity of this item to add to the subscription. If updating an existing item and not changing the quantity, you may omit
quantity.Min: 1
Non-catalog price for an existing product
quantityintegerrequired
Example:
5Quantity to bill for.
Min: 1
priceobjectrequired
Price object for a non-catalog item to bill for. Include a
product_id to relate this non-catalog price to an existing catalog price.descriptionstringrequired
Internal description for this price, not shown to customers. Typically notes for your team.
Length: 2–500
namestring | null
Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills.
Length: 1–150
billing_cycleobject | null
How often this price should be charged.
null if price is non-recurring (one-time).intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
trial_periodobject | null
Trial period for the product related to this price. The billing cycle begins once the trial period is over.
null for no trial period. Requires billing_cycle.intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
tax_modestring
Default:
account_settingHow tax is calculated for this price.
Values
account_settingPrices use the setting from your account.externalPrices are exclusive of tax.internalPrices are inclusive of tax.locationPrices are inclusive or exclusive of tax, depending on the country of the transaction.
unit_priceobjectrequired
Base price. This price applies to all customers, except for customers located in countries where you have
unit_price_overrides.amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
unit_price_overridesarray
List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries.
Items: max 250
country_codesarrayrequired
Supported two-letter ISO 3166-1 alpha-2 country code. Customers located in the listed countries are charged the override price.
Items: min 1, unique
string
Two-letter ISO 3166-1 alpha-2 representation of a supported country.
unit_priceobjectrequired
Override price. This price applies to customers located in the countries for this unit price override.
amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
quantityobject
Example:
{"minimum":1,"maximum":100}Limits on how many times the related product can be purchased at this price. Useful for discount campaigns. If omitted, defaults to 1-100.
minimumintegerrequired
Default:
1Example:
1Minimum quantity of the product related to this price that can be bought. Required if
maximum set.Range: 1–999999999
maximumintegerrequired
Default:
100Example:
100Maximum quantity of the product related to this price that can be bought. Required if
minimum set. Must be greater than or equal to the minimum value.Range: 1–999999999
custom_dataobject | null
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
product_idstringrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzPaddle ID for the product that this price is for, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$Non-catalog price and product
quantityintegerrequired
Example:
5Quantity to bill for.
Min: 1
priceobjectrequired
Price object for a non-catalog item to charge for. Include a
product object to create a non-catalog product for this non-catalog price.descriptionstringrequired
Internal description for this price, not shown to customers. Typically notes for your team.
Length: 2–500
namestring | null
Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills.
Length: 1–150
billing_cycleobject | null
How often this price should be charged.
null if price is non-recurring (one-time).intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
trial_periodobject | null
Trial period for the product related to this price. The billing cycle begins once the trial period is over.
null for no trial period. Requires billing_cycle.intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
tax_modestring
Default:
account_settingHow tax is calculated for this price.
Values
account_settingPrices use the setting from your account.externalPrices are exclusive of tax.internalPrices are inclusive of tax.locationPrices are inclusive or exclusive of tax, depending on the country of the transaction.
unit_priceobjectrequired
Base price. This price applies to all customers, except for customers located in countries where you have
unit_price_overrides.amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
unit_price_overridesarray
List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries.
Items: max 250
country_codesarrayrequired
Supported two-letter ISO 3166-1 alpha-2 country code. Customers located in the listed countries are charged the override price.
Items: min 1, unique
string
Two-letter ISO 3166-1 alpha-2 representation of a supported country.
unit_priceobjectrequired
Override price. This price applies to customers located in the countries for this unit price override.
amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
quantityobject
Example:
{"minimum":1,"maximum":100}Limits on how many times the related product can be purchased at this price. Useful for discount campaigns. If omitted, defaults to 1-100.
minimumintegerrequired
Default:
1Example:
1Minimum quantity of the product related to this price that can be bought. Required if
maximum set.Range: 1–999999999
maximumintegerrequired
Default:
100Example:
100Maximum quantity of the product related to this price that can be bought. Required if
minimum set. Must be greater than or equal to the minimum value.Range: 1–999999999
custom_dataobject | null
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
productobjectrequired
Product object for a non-catalog item to charge for.
namestringrequired
Name of this product.
Length: 1–200
descriptionstring | null
Short description for this product.
Max length: 2048
tax_categorystringrequired
Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.
Values
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
image_url
Image for this product. Included in the checkout and on some customer documents.
Image Url
A URL to an image.
null
Empty String
custom_dataobject | null
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
custom_dataobject | null
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
proration_billing_modestring
How Paddle should handle proration calculation for changes made to a subscription or its items. Required when making changes that impact billing.
For automatically-collected subscriptions, responses may take longer than usual if a proration billing mode that collects for payment immediately is used.
Values
prorated_immediatelyPaddle calculates the prorated amount for the subscription changes based on the current billing cycle, then creates a transaction to collect immediately.prorated_next_billing_periodPaddle calculates the prorated amount for the subscription changes based on the current billing cycle, then schedules them to be billed on the next renewal.full_immediatelyPaddle does not calculate proration for the subscription changes, creating a transaction to collect for the full amount immediately.full_next_billing_periodPaddle does not calculate proration for the subscription changes, scheduling for the full amount for the changes to be billed on the next renewal.do_not_billPaddle does not bill for the subscription changes.
on_payment_failurestring
Default:
prevent_changeHow Paddle should handle changes made to a subscription or its items if the payment fails during update. If omitted, defaults to
prevent_change.Values
prevent_changeIn case of payment failure, prevent the change to the subscription from applying.apply_changeIn case of payment failure, apply the change and update the subscription.
Response (200)
dataobjectrequired
Represents a subscription preview when previewing a subscription.
statusstringrequired
Status of this subscription. Set automatically by Paddle. Use the pause subscription or cancel subscription operations to change.
Values
activeSubscription is active. Paddle is billing for this subscription and related transactions aren't past due.canceledSubscription is canceled. Automatically set by Paddle when a subscription is canceled. When a subscription is set to cancel on the next billing period, a scheduled change for the cancellation is created. The subscription status moves to canceled when the scheduled change takes effect.past_dueSubscription has an overdue payment. Automatically set by Paddle when payment fails for an automatically-collected transaction, or when payment terms have elapsed for a manually-collected transaction (an invoice).pausedSubscription is paused. Automatically set by Paddle when a subscription is paused. When a subscription is set to pause on the next billing period, a scheduled change for the pause is created. The subscription status moves topausedwhen the scheduled change takes effect.trialingSubscription is in trial.
customer_idstringrequired
Example:
ctm_01grnn4zta5a1mf02jjze7y2ysPaddle ID of the customer that this subscription is for, prefixed with
ctm_.Pattern:
^ctm_[a-z\d]{26}$address_idstringrequired
Example:
add_01gm302t81w94gyjpjpqypkzkfPaddle ID of the address that this subscription is for, prefixed with
add_.Pattern:
^add_[a-z\d]{26}$business_idstring | nullrequired
Example:
biz_01grrebrzaee2qj2fqqhmcyzajUnique Paddle ID for this business entity, prefixed with
biz_.Pattern:
^biz_[a-z\d]{26}$currency_codestringrequired
Supported three-letter ISO 4217 currency code. Transactions for this subscription are created in this currency. Must be
USD, EUR, or GBP if collection_mode is manual.Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
started_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
first_billed_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
next_billed_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
paused_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
canceled_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
discountobject | nullrequired
Details of the discount applied to this subscription.
idstringrequired
Example:
dsc_01gv5kpg05xp104ek2fmgjwttfUnique Paddle ID for this discount, prefixed with
dsc_.Pattern:
^dsc_[a-z\d]{26}$starts_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
ends_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
typestringrequired
Whether this discount applies for multiple billing periods.
Values
recurringDiscount applies to multiple billing periods.one-offDiscount applies to a single billing period only. Returned when a subscription is created in trial with a discount. The discount is removed from the subscription on renewal.
collection_modestringrequired
Default:
automaticHow payment is collected for transactions created for this subscription.
automatic for checkout, manual for invoices.Values
automaticPayment is collected automatically using a checkout initially, then using a payment method on file.manualPayment is collected manually. Customers are sent an invoice with payment terms and can make a payment offline or using a checkout. Requiresbilling_details.
billing_detailsobject | nullrequired
Details for invoicing. Required if
collection_mode is manual.enable_checkoutbooleanrequired
Default:
falseWhether the related transaction may be paid using Paddle Checkout. If omitted when creating a transaction, defaults to
false.purchase_order_numberstringrequired
Customer purchase order number. Appears on invoice documents.
Max length: 100
additional_informationstring | nullrequired
Notes or other information to include on this invoice. Appears on invoice documents.
Max length: 1500
payment_termsobjectrequired
How long a customer has to pay this invoice once issued.
intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
current_billing_periodobject | nullrequired
Current billing period for this subscription. Set automatically by Paddle based on the billing cycle.
null for paused and canceled subscriptions.starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
billing_cycleobjectrequired
How often this subscription renews. Set automatically by Paddle based on the prices on this subscription.
intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
scheduled_changeobject | nullrequired
Change that's scheduled to be applied to a subscription. Use the pause subscription, cancel subscription, and resume subscription operations to create scheduled changes.
null if no scheduled changes.actionstringrequired
Kind of change that's scheduled to be applied to this subscription.
Values
cancelSubscription is scheduled to cancel. Its status changes tocanceledon theeffective_atdate.pauseSubscription is scheduled to pause. Its status changes topausedon theeffective_atdate.resumeSubscription is scheduled to resume. Its status changes toactiveon theeffective_atdate.
effective_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this scheduled change takes effect.
resume_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
management_urlsobjectrequired
Customer portal deep links for this subscription.
Authenticated links are only returned when your API key has Customer portal session (Write) permission. For security, the token appended to authenticated links is temporary. You shouldn't store them.
update_payment_methodstring (uri) | nullrequired
Example:
https://buyer-portal.paddle.com/subscriptions/sub_01gtewvbsyeqyhtp2vtc2mctq8/update-payment-method?token=Link to the page for this subscription in the customer portal with the payment method update form pre-opened. Use as part of workflows to let customers update their payment details.
null for manually-collected subscriptions.cancelstring (uri)required
Example:
https://buyer-portal.paddle.com/subscriptions/sub_01gtewvbsyeqyhtp2vtc2mctq8/cancel?token=Link to the page for this subscription in the customer portal with the subscription cancellation form pre-opened. Use as part of cancel subscription workflows.
itemsarrayrequired
List of items on this subscription. Only recurring items are returned.
Items: 1–100
statusstringrequired
Status of this subscription item. Set automatically by Paddle.
Values
activeThis item is active. It is not in trial and Paddle bills for it.inactiveThis item is not active. Set when the related subscription is paused.trialingThis item is in trial. Paddle has not billed for it.
quantitynumberrequired
Quantity of this item on the subscription.
Min: 1
recurringbooleanrequired
Whether this is a recurring item.
false if one-time.created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this item was added to this subscription.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this item was last updated on this subscription.
previously_billed_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
next_billed_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
trial_datesobject | nullrequired
Trial dates for this item.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
priceobjectrequired
Related price entity for this item. This reflects the price entity at the time it was added to the subscription.
idstringrequired
Example:
pri_01gsz8z1q1n00f12qt82y31smhUnique Paddle ID for this price, prefixed with
pri_.Pattern:
^pri_[a-z\d]{26}$product_idstringrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzPaddle ID for the product that this price is for, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$descriptionstringrequired
Internal description for this price, not shown to customers. Typically notes for your team.
Length: 2–500
typestringrequired
Default:
standardType of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.
Values
customNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
namestring | nullrequired
Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills.
Length: 1–150
billing_cycleobject | nullrequired
How often this price should be charged.
null if price is non-recurring (one-time).intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
trial_periodobject | nullrequired
Trial period for the product related to this price. The billing cycle begins once the trial period is over.
null for no trial period. Requires billing_cycle.intervalstringrequired
Unit of time.
Values
dayweekmonthyear
frequencyintegerrequired
Amount of time.
Min: 1
requires_payment_methodbooleanrequired
Default:
trueWhether this price requires a payment method (
true) or not (false) when trialing. If false, customers can sign up for subscription without entering their payment details, often referred to as a "cardless trial."tax_modestringrequired
Default:
account_settingHow tax is calculated for this price.
Values
account_settingPrices use the setting from your account.externalPrices are exclusive of tax.internalPrices are inclusive of tax.locationPrices are inclusive or exclusive of tax, depending on the country of the transaction.
unit_priceobjectrequired
Base price. This price applies to all customers, except for customers located in countries where you have
unit_price_overrides.amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
unit_price_overridesarrayrequired
List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries.
Items: max 250
country_codesarrayrequired
Supported two-letter ISO 3166-1 alpha-2 country code. Customers located in the listed countries are charged the override price.
Items: min 1, unique
string
Two-letter ISO 3166-1 alpha-2 representation of a supported country.
unit_priceobjectrequired
Override price. This price applies to customers located in the countries for this unit price override.
amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
quantityobjectrequired
Example:
{"minimum":1,"maximum":100}Limits on how many times the related product can be purchased at this price. Useful for discount campaigns.
minimumintegerrequired
Default:
1Example:
1Minimum quantity of the product related to this price that can be bought. Required if
maximum set.Range: 1–999999999
maximumintegerrequired
Default:
100Example:
100Maximum quantity of the product related to this price that can be bought. Required if
minimum set. Must be greater than or equal to the minimum value.Range: 1–999999999
statusstringrequired
Default:
activeWhether this entity can be used in Paddle.
Values
activeEntity is active and can be used.archivedEntity is archived, so can't be used.
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
import_metaobject | nullrequired
Import information for this entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
productobjectrequired
Related product entity for this item. This reflects the product entity at the time it was added to the subscription.
idstringrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzUnique Paddle ID for this product, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$namestringrequired
Name of this product.
Length: 1–200
descriptionstring | nullrequired
Short description for this product.
Max length: 2048
typestringrequired
Default:
standardType of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.
Values
customNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
tax_categorystringrequired
Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.
Values
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
image_urlrequired
Image for this product. Included in the checkout and on some customer documents.
Image Url
A URL to an image.
null
Empty String
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
statusstringrequired
Default:
activeWhether this entity can be used in Paddle.
Values
activeEntity is active and can be used.archivedEntity is archived, so can't be used.
import_metaobject | nullrequired
Import information for this entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
immediate_transactionobject | nullrequired
Preview of the next transaction for this subscription. May include prorated charges that aren't yet billed and one-time charges.
null if the subscription is scheduled to cancel or pause.billing_periodobjectrequired
Billing period for the next transaction.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
detailsobjectrequired
Calculated totals for a transaction preview, including discounts, tax, and currency conversion. Considered the source of truth for totals on a transaction preview.
tax_rates_usedarrayrequired
List of tax rates applied to this transaction preview.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction preview.
totalsobjectrequired
Calculated totals for the tax applied to this transaction preview.
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of the total for a transaction preview.
fee and earnings always return null for transaction previews.subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
creditstringrequired
Example:
0Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a
billed transaction.credit_to_balancestringrequired
Example:
0Additional credit generated from negative
details.line_items. This credit is added to the customer balance.balancestringrequired
Example:
16500Total due on a transaction after credits and any payments.
grand_totalstringrequired
Example:
16500Total due on a transaction after credits but before any payments.
grand_total_taxstringrequired
Example:
83Net tax amount included in
grand_total. Equals the full tax amount unless credits are applied, in which case this value is proportionally reduced.feestring | nullrequired
Example:
825Total fee taken by Paddle for this transaction.
null until the transaction is completed and the fee is processed.earningsstring | nullrequired
Example:
15675Total earnings for this transaction. This is the total minus the Paddle fee.
null until the transaction is completed and the fee is processed.currency_codestringrequired
Three-letter ISO 4217 currency code of the currency used for this transaction.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
line_itemsarrayrequired
Information about line items for this transaction preview. Different from transaction preview
items as they include totals calculated by Paddle. Considered the source of truth for line item totals.price_idstring | nullrequired
Example:
pri_01gsz8z1q1n00f12qt82y31smhUnique Paddle ID for this price, prefixed with
pri_.Pattern:
^pri_[a-z\d]{26}$quantityintegerrequired
Quantity of this transaction line item.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction line item.
unit_totalsobjectrequired
Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
productobjectrequired
Related product entity for this transaction line item price.
idstring | nullrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzUnique Paddle ID for this product, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$namestringrequired
Name of this product.
Length: 1–200
descriptionstring | nullrequired
Short description for this product.
Max length: 2048
typestringrequired
Default:
standardType of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.
Values
customNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
tax_categorystringrequired
Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.
Values
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
image_urlrequired
Image for this product. Included in the checkout and on some customer documents.
Image Url
A URL to an image.
null
Empty String
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
statusstringrequired
Default:
activeWhether this entity can be used in Paddle.
Values
activeEntity is active and can be used.archivedEntity is archived, so can't be used.
import_metaobject | nullrequired
Import information for this entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
prorationobject | nullrequired
How proration was calculated for this item. Populated when a transaction is created from a subscription change, where
proration_billing_mode was prorated_immediately or prorated_next_billing_period. Set automatically by Paddle.ratestringrequired
Rate used to calculate proration.
billing_periodobjectrequired
Billing period that proration is based on.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
adjustmentsarrayrequired
Preview of adjustments for the next transaction.
transaction_idstringrequired
Example:
txn_01h04vsbhqc62t8hmd4z3b578cPaddle ID for this transaction entity that this adjustment relates to, prefixed with
txn_.Pattern:
^txn_[a-z\d]{26}$itemsarrayrequired
List of transaction items that this adjustment is for.
Items: max 100
item_idstringrequired
Example:
txnitm_01gm302t81w94gyjpjpqypkzkfPaddle ID for the transaction item that this adjustment item relates to, prefixed with
txnitm_.Pattern:
^txnitm_[a-z\d]{26}$typestringrequired
Example:
fullType of adjustment for this transaction item.
tax adjustments are automatically created by Paddle.
Include amount when creating a partial adjustment.Values
fullFull total for this transaction item is adjusted.partialPart of this transaction item is adjusted. Includeamountto specify the partial amount adjusted.taxTax for this transaction item is adjusted. Created automatically by Paddle.prorationA prorated amount for this transaction item is adjusted. Created automatically by Paddle in some cases when making changes to a subscription.
amountstring | nullrequired
Amount adjusted for this transaction item. Required when item
type is partial.prorationobject | nullrequired
How proration was calculated for this item. Populated when a transaction is created from a subscription change, where
proration_billing_mode was prorated_immediately or prorated_next_billing_period. Set automatically by Paddle.ratestringrequired
Rate used to calculate proration.
billing_periodobjectrequired
Billing period that proration is based on.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
totalsobjectrequired
Breakdown of the total for an adjustment item.
subtotalstringrequired
Example:
15000Amount multiplied by quantity.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after tax.
totalsobjectrequired
Calculated totals for this adjustment.
subtotalstringrequired
Example:
15000Total before tax. For tax adjustments, the value is 0.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after tax.
feestringrequired
Example:
300Total fee taken by Paddle for this adjustment.
retained_feestring
Example:
300Paddle fees retained for this adjustment.
earningsstringrequired
Example:
14700Total earnings. This is the subtotal minus the Paddle fee.
For tax adjustments, this value is negative, which means a positive effect in the transaction earnings.
This is because the fee is originally calculated from the transaction total, so if a tax adjustment is made,
then the fee portion of it is returned.
currency_codestringrequired
Example:
USDThree-letter ISO 4217 currency code used for this adjustment.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
next_transactionobject | nullrequired
Preview of the next transaction for this subscription. May include prorated charges that aren't yet billed and one-time charges.
null if the subscription is scheduled to cancel or pause.billing_periodobjectrequired
Billing period for the next transaction.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
detailsobjectrequired
Calculated totals for a transaction preview, including discounts, tax, and currency conversion. Considered the source of truth for totals on a transaction preview.
tax_rates_usedarrayrequired
List of tax rates applied to this transaction preview.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction preview.
totalsobjectrequired
Calculated totals for the tax applied to this transaction preview.
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of the total for a transaction preview.
fee and earnings always return null for transaction previews.subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
creditstringrequired
Example:
0Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a
billed transaction.credit_to_balancestringrequired
Example:
0Additional credit generated from negative
details.line_items. This credit is added to the customer balance.balancestringrequired
Example:
16500Total due on a transaction after credits and any payments.
grand_totalstringrequired
Example:
16500Total due on a transaction after credits but before any payments.
grand_total_taxstringrequired
Example:
83Net tax amount included in
grand_total. Equals the full tax amount unless credits are applied, in which case this value is proportionally reduced.feestring | nullrequired
Example:
825Total fee taken by Paddle for this transaction.
null until the transaction is completed and the fee is processed.earningsstring | nullrequired
Example:
15675Total earnings for this transaction. This is the total minus the Paddle fee.
null until the transaction is completed and the fee is processed.currency_codestringrequired
Three-letter ISO 4217 currency code of the currency used for this transaction.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
line_itemsarrayrequired
Information about line items for this transaction preview. Different from transaction preview
items as they include totals calculated by Paddle. Considered the source of truth for line item totals.price_idstring | nullrequired
Example:
pri_01gsz8z1q1n00f12qt82y31smhUnique Paddle ID for this price, prefixed with
pri_.Pattern:
^pri_[a-z\d]{26}$quantityintegerrequired
Quantity of this transaction line item.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction line item.
unit_totalsobjectrequired
Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
productobjectrequired
Related product entity for this transaction line item price.
idstring | nullrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzUnique Paddle ID for this product, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$namestringrequired
Name of this product.
Length: 1–200
descriptionstring | nullrequired
Short description for this product.
Max length: 2048
typestringrequired
Default:
standardType of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.
Values
customNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
tax_categorystringrequired
Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.
Values
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
image_urlrequired
Image for this product. Included in the checkout and on some customer documents.
Image Url
A URL to an image.
null
Empty String
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
statusstringrequired
Default:
activeWhether this entity can be used in Paddle.
Values
activeEntity is active and can be used.archivedEntity is archived, so can't be used.
import_metaobject | nullrequired
Import information for this entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
prorationobject | nullrequired
How proration was calculated for this item. Populated when a transaction is created from a subscription change, where
proration_billing_mode was prorated_immediately or prorated_next_billing_period. Set automatically by Paddle.ratestringrequired
Rate used to calculate proration.
billing_periodobjectrequired
Billing period that proration is based on.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
adjustmentsarrayrequired
Preview of adjustments for the next transaction.
transaction_idstringrequired
Example:
txn_01h04vsbhqc62t8hmd4z3b578cPaddle ID for this transaction entity that this adjustment relates to, prefixed with
txn_.Pattern:
^txn_[a-z\d]{26}$itemsarrayrequired
List of transaction items that this adjustment is for.
Items: max 100
item_idstringrequired
Example:
txnitm_01gm302t81w94gyjpjpqypkzkfPaddle ID for the transaction item that this adjustment item relates to, prefixed with
txnitm_.Pattern:
^txnitm_[a-z\d]{26}$typestringrequired
Example:
fullType of adjustment for this transaction item.
tax adjustments are automatically created by Paddle.
Include amount when creating a partial adjustment.Values
fullFull total for this transaction item is adjusted.partialPart of this transaction item is adjusted. Includeamountto specify the partial amount adjusted.taxTax for this transaction item is adjusted. Created automatically by Paddle.prorationA prorated amount for this transaction item is adjusted. Created automatically by Paddle in some cases when making changes to a subscription.
amountstring | nullrequired
Amount adjusted for this transaction item. Required when item
type is partial.prorationobject | nullrequired
How proration was calculated for this item. Populated when a transaction is created from a subscription change, where
proration_billing_mode was prorated_immediately or prorated_next_billing_period. Set automatically by Paddle.ratestringrequired
Rate used to calculate proration.
billing_periodobjectrequired
Billing period that proration is based on.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
totalsobjectrequired
Breakdown of the total for an adjustment item.
subtotalstringrequired
Example:
15000Amount multiplied by quantity.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after tax.
totalsobjectrequired
Calculated totals for this adjustment.
subtotalstringrequired
Example:
15000Total before tax. For tax adjustments, the value is 0.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after tax.
feestringrequired
Example:
300Total fee taken by Paddle for this adjustment.
retained_feestring
Example:
300Paddle fees retained for this adjustment.
earningsstringrequired
Example:
14700Total earnings. This is the subtotal minus the Paddle fee.
For tax adjustments, this value is negative, which means a positive effect in the transaction earnings.
This is because the fee is originally calculated from the transaction total, so if a tax adjustment is made,
then the fee portion of it is returned.
currency_codestringrequired
Example:
USDThree-letter ISO 4217 currency code used for this adjustment.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
recurring_transaction_detailsobjectrequired
Preview of the recurring transaction for this subscription. This is what the customer can expect to be billed when there are no prorated or one-time charges.
tax_rates_usedarrayrequired
List of tax rates applied to this transaction preview.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction preview.
totalsobjectrequired
Calculated totals for the tax applied to this transaction preview.
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of the total for a transaction preview.
fee and earnings always return null for transaction previews.subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
creditstringrequired
Example:
0Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a
billed transaction.credit_to_balancestringrequired
Example:
0Additional credit generated from negative
details.line_items. This credit is added to the customer balance.balancestringrequired
Example:
16500Total due on a transaction after credits and any payments.
grand_totalstringrequired
Example:
16500Total due on a transaction after credits but before any payments.
grand_total_taxstringrequired
Example:
83Net tax amount included in
grand_total. Equals the full tax amount unless credits are applied, in which case this value is proportionally reduced.feestring | nullrequired
Example:
825Total fee taken by Paddle for this transaction.
null until the transaction is completed and the fee is processed.earningsstring | nullrequired
Example:
15675Total earnings for this transaction. This is the total minus the Paddle fee.
null until the transaction is completed and the fee is processed.currency_codestringrequired
Three-letter ISO 4217 currency code of the currency used for this transaction.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
line_itemsarrayrequired
Information about line items for this transaction preview. Different from transaction preview
items as they include totals calculated by Paddle. Considered the source of truth for line item totals.price_idstring | nullrequired
Example:
pri_01gsz8z1q1n00f12qt82y31smhUnique Paddle ID for this price, prefixed with
pri_.Pattern:
^pri_[a-z\d]{26}$quantityintegerrequired
Quantity of this transaction line item.
tax_ratestringrequired
Example:
0.2Rate used to calculate tax for this transaction line item.
unit_totalsobjectrequired
Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
totalsobjectrequired
Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD).
subtotalstringrequired
Example:
15000Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity.
discountstringrequired
Example:
0Total discount as a result of any discounts applied.
Except for percentage discounts, Paddle applies tax to discounts based on the line item price.tax_mode. If price.tax_mode for a line item is internal, Paddle removes tax from the discount applied.
taxstringrequired
Example:
1500Total tax on the subtotal.
totalstringrequired
Example:
16500Total after discount and tax.
productobjectrequired
Related product entity for this transaction line item price.
idstring | nullrequired
Example:
pro_01gsz97mq9pa4fkyy0wqenepkzUnique Paddle ID for this product, prefixed with
pro_.Pattern:
^pro_[a-z\d]{26}$namestringrequired
Name of this product.
Length: 1–200
descriptionstring | nullrequired
Short description for this product.
Max length: 2048
typestringrequired
Default:
standardType of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.
Values
customNon-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard.standardStandard item. Can be considered part of your catalog and reused across transactions and subscriptions easily.
tax_categorystringrequired
Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.
Values
digital-goodsNon-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered.ebooksDigital books and educational material which is sold with permanent rights for use by the customer.implementation-servicesRemote configuration, set-up, and integrating software on behalf of a customer.professional-servicesServices that involve the application of your expertise and specialized knowledge of a software product.saasProducts that allow users to connect to and use online or cloud-based applications over the Internet.
+ Show all values− Hide values
software-programming-servicesstandardSoftware products that are pre-written and can be downloaded and installed onto a local device.training-servicesTraining and education services related to software products.website-hostingCloud storage service for personal or corporate information, assets, or intellectual property.
image_urlrequired
Image for this product. Included in the checkout and on some customer documents.
Image Url
A URL to an image.
null
Empty String
custom_dataobject | nullrequired
Example:
{"customer_reference_id":"abcd1234"}Your own structured key-value data.
statusstringrequired
Default:
activeWhether this entity can be used in Paddle.
Values
activeEntity is active and can be used.archivedEntity is archived, so can't be used.
import_metaobject | nullrequired
Import information for this entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example:
2024-10-13T07:20:50.52ZRFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
prorationobject | nullrequired
How proration was calculated for this item. Populated when a transaction is created from a subscription change, where
proration_billing_mode was prorated_immediately or prorated_next_billing_period. Set automatically by Paddle.ratestringrequired
Rate used to calculate proration.
billing_periodobjectrequired
Billing period that proration is based on.
starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
update_summaryobject | nullrequired
Impact of this subscription change. Includes whether the change results in a charge or credit, and totals for prorated amounts.
creditobjectrequired
Details of any credit adjustments created for this update. Paddle creates adjustments against existing transactions when prorating.
amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
chargeobjectrequired
Details of the transaction to be created for this update. Paddle creates a transaction to bill for new charges.
amountstringrequired
Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer.
currency_codestringrequired
Supported three-letter ISO 4217 currency code.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
resultobjectrequired
Details of the result of credits and charges. Where the total of any credit adjustments is greater than the total charge, the result is a prorated credit; otherwise, the result is a prorated charge.
actionstringrequired
Whether the subscription change results in a prorated credit or a charge.
Values
creditChanges to the subscription results in a prorated credit.chargeChanges to the subscription results in a prorated charge.
amountstringrequired
Amount representing the result of this update, either a charge or a credit.
currency_codestringrequired
Three-letter ISO 4217 currency code for the transaction or adjustment.
Values
USDUnited States DollarEUREuroGBPPound SterlingJPYJapanese YenAUDAustralian Dollar
+ Show all values− Hide values
CADCanadian DollarCHFSwiss FrancHKDHong Kong DollarSGDSingapore DollarSEKSwedish KronaARSArgentine PesoBRLBrazilian RealCLPChilean PesoCNYChinese YuanCOPColombian PesoCZKCzech KorunaDKKDanish KroneHUFHungarian ForintILSIsraeli ShekelINRIndian RupeeKRWSouth Korean WonMXNMexican PesoNOKNorwegian KroneNZDNew Zealand DollarPENPeruvian SolPLNPolish ZlotyRUBRussian RubleTHBThai BahtTRYTurkish LiraTWDNew Taiwan DollarUAHUkrainian HryvniaVNDVietnamese DongZARSouth African Rand
import_metaobject | nullrequired
Import information for the subscription entity.
null if this entity is not imported.external_idstring | null
Example:
9b95b0b8-e10f-441a-862e-1936a6d818abReference or identifier for this entity from the provider where it was imported from.
Length: 1–200
imported_fromstringrequired
Example:
paddle_classicName of the platform or provider where this entity was imported from.
Length: 1–200
consent_requirementsarrayrequired
List of active consent requirements for the subscription's current billing period.
idstringrequired
Example:
subconreq_01gm302t81w94gyjpjpqypkzkfUnique Paddle ID for this subscription consent requirement entity, prefixed with
subconreq_.Pattern:
^subconreq_[a-z\d]{26}$requirementstringrequired
Type of consent required for successful renewal.
Values
trial_endingConsent required because the trial period is ending.introductory_discount_endingConsent required because an initial discount is ending.
statusstringrequired
Status of this consent requirement.
Values
pendingConsent not yet granted. Subscription is canceled on next renewal.grantedConsent granted. Subscription renews normally.voidedConsent voided. Consent requirement is no longer applicable, either because the consent is no longer required, or another consent requirement has replaced it.
created_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
consent_periodobject | nullrequired
Period during which consent for this subscription can be granted.
null if there is no next_billed_at or the consent requirement does not apply to the current billing period.starts_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period starts.
ends_atstring (date-time)required
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string of when this period ends.
granted_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
voided_atstring (date-time) | nullrequired
Example:
2024-10-12T07:20:50.52ZRFC 3339 datetime string.
metaobjectrequired
Information about this response.
request_idstringrequired
Example:
b15ec92e-8688-40d4-a04d-f44cbec93355Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
{ "items": [ { "price_id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "quantity": 20 }, { "price_id": "pri_01h1vjfevh5etwq3rb416a23h2", "quantity": 1 }, { "price_id": "pri_01gsz95g2zrkagg294kpstx54r", "quantity": 1 } ], "proration_billing_mode": "prorated_immediately"}{ "data": { "status": "active", "customer_id": "ctm_01hrffh7gvp29kc7xahm8wddwa", "address_id": "add_01hxh60j19j6gj877cywv20g13", "business_id": null, "currency_code": "USD", "created_at": "2024-05-10T12:01:47.199Z", "updated_at": "2024-05-13T10:36:58.039Z", "started_at": "2024-05-10T12:01:46.293348Z", "first_billed_at": "2024-05-10T12:01:46.293348Z", "next_billed_at": "2024-06-10T12:01:46.293348Z", "paused_at": null, "canceled_at": null, "collection_mode": "automatic", "billing_details": null, "current_billing_period": { "starts_at": "2024-05-10T12:01:46.293348Z", "ends_at": "2024-06-10T12:01:46.293348Z" }, "billing_cycle": { "frequency": 1, "interval": "month" }, "recurring_transaction_details": { "tax_rates_used": [ { "tax_rate": "0.08875", "totals": { "subtotal": "95000", "discount": "0", "tax": "8431", "total": "103431" } } ], "totals": { "subtotal": "95000", "tax": "8431", "discount": "0", "total": "103431", "fee": null, "credit": "0", "credit_to_balance": "0", "balance": "103431", "grand_total": "103431", "grand_total_tax": "8431", "earnings": null, "currency_code": "USD" }, "line_items": [ { "price_id": "pri_01h1vjfevh5etwq3rb416a23h2", "quantity": 1, "totals": { "subtotal": "10000", "tax": "887", "discount": "0", "total": "10887" }, "product": { "id": "pro_01h1vjes1y163xfj1rh1tkfb65", "name": "Analytics addon", "type": "standard", "tax_category": "standard", "description": "Unlock advanced insights into your flight data with enhanced analytics and reporting features. Includes customizable reporting templates and trend analysis across flights.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/97dRpA6SXzcE6ekK9CAr_analytics.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-06-01T13:30:50.302Z", "updated_at": "2024-04-05T15:47:17.163Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "10000", "discount": "0", "tax": "887", "total": "10887" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-05-10T12:01:46.293348Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz95g2zrkagg294kpstx54r", "quantity": 1, "totals": { "subtotal": "25000", "tax": "2219", "discount": "0", "total": "27219" }, "product": { "id": "pro_01gsz92krfzy3hcx5h5rtgnfwz", "name": "VIP support", "type": "standard", "tax_category": "standard", "description": "Get exclusive access to our expert team of product specialists, available to help you make the most of your AeroEdit subscription.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/qgyipKJwRtq98YNboipo_vip-support.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-02-23T13:58:17.615Z", "updated_at": "2024-04-05T15:44:02.893Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "25000", "discount": "0", "tax": "2219", "total": "27219" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-05-10T12:01:46.293348Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "quantity": 20, "totals": { "subtotal": "60000", "tax": "5325", "discount": "0", "total": "65325" }, "product": { "id": "pro_01gsz4t5hdjse780zja8vvr7jg", "name": "AeroEdit Pro", "type": "standard", "tax_category": "standard", "description": "Designed for professional pilots, including all features plus in Basic plus compliance monitoring, route optimization, and third-party integrations.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": true, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": "Move from Basic to Pro to take advantage of aircraft performance, advanced route planning, and compliance monitoring." }, "status": "active", "import_meta": null, "created_at": "2023-02-23T12:43:46.605Z", "updated_at": "2024-04-05T15:53:44.687Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "3000", "discount": "0", "tax": "266", "total": "3266" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-05-10T12:01:46.293348Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } } ] }, "next_transaction": { "billing_period": { "starts_at": "2024-06-10T12:01:46.293348Z", "ends_at": "2024-07-10T12:01:46.293348Z" }, "details": { "tax_rates_used": [ { "tax_rate": "0.08875", "totals": { "subtotal": "95000", "discount": "0", "tax": "8431", "total": "103431" } } ], "totals": { "subtotal": "95000", "tax": "8431", "discount": "0", "total": "103431", "fee": null, "credit": "0", "credit_to_balance": "0", "balance": "103431", "grand_total": "103431", "grand_total_tax": "8431", "earnings": null, "currency_code": "USD" }, "line_items": [ { "price_id": "pri_01h1vjfevh5etwq3rb416a23h2", "quantity": 1, "totals": { "subtotal": "10000", "tax": "887", "discount": "0", "total": "10887" }, "product": { "id": "pro_01h1vjes1y163xfj1rh1tkfb65", "name": "Analytics addon", "type": "standard", "tax_category": "standard", "description": "Unlock advanced insights into your flight data with enhanced analytics and reporting features. Includes customizable reporting templates and trend analysis across flights.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/97dRpA6SXzcE6ekK9CAr_analytics.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-06-01T13:30:50.302Z", "updated_at": "2024-04-05T15:47:17.163Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "10000", "discount": "0", "tax": "887", "total": "10887" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-06-10T12:01:46.293348Z", "ends_at": "2024-07-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz95g2zrkagg294kpstx54r", "quantity": 1, "totals": { "subtotal": "25000", "tax": "2219", "discount": "0", "total": "27219" }, "product": { "id": "pro_01gsz92krfzy3hcx5h5rtgnfwz", "name": "VIP support", "type": "standard", "tax_category": "standard", "description": "Get exclusive access to our expert team of product specialists, available to help you make the most of your AeroEdit subscription.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/qgyipKJwRtq98YNboipo_vip-support.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-02-23T13:58:17.615Z", "updated_at": "2024-04-05T15:44:02.893Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "25000", "discount": "0", "tax": "2219", "total": "27219" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-06-10T12:01:46.293348Z", "ends_at": "2024-07-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "quantity": 20, "totals": { "subtotal": "60000", "tax": "5325", "discount": "0", "total": "65325" }, "product": { "id": "pro_01gsz4t5hdjse780zja8vvr7jg", "name": "AeroEdit Pro", "type": "standard", "tax_category": "standard", "description": "Designed for professional pilots, including all features plus in Basic plus compliance monitoring, route optimization, and third-party integrations.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": true, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": "Move from Basic to Pro to take advantage of aircraft performance, advanced route planning, and compliance monitoring." }, "status": "active", "import_meta": null, "created_at": "2023-02-23T12:43:46.605Z", "updated_at": "2024-04-05T15:53:44.687Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "3000", "discount": "0", "tax": "266", "total": "3266" }, "proration": { "rate": "1", "billing_period": { "starts_at": "2024-06-10T12:01:46.293348Z", "ends_at": "2024-07-10T12:01:46.293348Z" } } } ] }, "adjustments": [] }, "immediate_transaction": { "billing_period": { "starts_at": "2024-05-13T10:36:59.473Z", "ends_at": "2024-06-10T12:01:46.293348Z" }, "details": { "tax_rates_used": [ { "tax_rate": "0.08875", "totals": { "subtotal": "72410", "discount": "0", "tax": "6428", "total": "78838" } } ], "totals": { "subtotal": "72410", "tax": "6428", "discount": "0", "total": "78838", "fee": null, "credit": "0", "credit_to_balance": "0", "balance": "78838", "grand_total": "78838", "grand_total_tax": "6428", "earnings": null, "currency_code": "USD" }, "line_items": [ { "price_id": "pri_01gsz95g2zrkagg294kpstx54r", "quantity": 1, "totals": { "subtotal": "22628", "tax": "2009", "discount": "0", "total": "24637" }, "product": { "id": "pro_01gsz92krfzy3hcx5h5rtgnfwz", "name": "VIP support", "type": "standard", "tax_category": "standard", "description": "Get exclusive access to our expert team of product specialists, available to help you make the most of your AeroEdit subscription.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/qgyipKJwRtq98YNboipo_vip-support.png", "custom_data": null, "status": "active", "import_meta": null, "created_at": "2023-02-23T13:58:17.615Z", "updated_at": "2024-04-05T15:44:02.893Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "22628", "discount": "0", "tax": "2009", "total": "24637" }, "proration": { "rate": "0.90513", "billing_period": { "starts_at": "2024-05-13T10:36:57.967Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "quantity": 20, "totals": { "subtotal": "54308", "tax": "4820", "discount": "0", "total": "59128" }, "product": { "id": "pro_01gsz4t5hdjse780zja8vvr7jg", "name": "AeroEdit Pro", "type": "standard", "tax_category": "standard", "description": "Designed for professional pilots, including all features plus in Basic plus compliance monitoring, route optimization, and third-party integrations.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": true, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": "Move from Basic to Pro to take advantage of aircraft performance, advanced route planning, and compliance monitoring." }, "status": "active", "import_meta": null, "created_at": "2023-02-23T12:43:46.605Z", "updated_at": "2024-04-05T15:53:44.687Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "2715", "discount": "0", "tax": "241", "total": "2956" }, "proration": { "rate": "0.90513", "billing_period": { "starts_at": "2024-05-13T10:36:57.97Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } }, { "price_id": "pri_01gsz8ntc6z7npqqp6j4ys0w1w", "quantity": -5, "totals": { "subtotal": "-4526", "tax": "-401", "discount": "0", "total": "-4927" }, "product": { "id": "pro_01gsz4s0w61y0pp88528f1wvvb", "name": "AeroEdit Basic", "type": "standard", "tax_category": "standard", "description": "Ideal for hobbyist pilots AeroEdit Basic offers flight log creation, editing, basic performance tracking, route planning, and export options.", "image_url": "https://paddle.s3.amazonaws.com/user/165798/oi0r8qNmQzuNpj9pLHcT_basic.png", "custom_data": { "features": { "aircraft_performance": false, "compliance_monitoring": false, "flight_log_management": true, "payment_by_invoice": false, "route_planning": false, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": null }, "status": "active", "import_meta": null, "created_at": "2023-02-23T12:43:09.062Z", "updated_at": "2024-04-05T15:56:39.477Z" }, "tax_rate": "0.08875", "unit_totals": { "subtotal": "905", "discount": "0", "tax": "80", "total": "985" }, "proration": { "rate": "0.90513", "billing_period": { "starts_at": "2024-05-13T10:36:57.959Z", "ends_at": "2024-06-10T12:01:46.293348Z" } } } ] }, "adjustments": [] }, "scheduled_change": null, "items": [ { "status": "active", "quantity": 1, "recurring": true, "created_at": "2024-05-10T12:01:47.199Z", "updated_at": "2024-05-10T12:01:47.199Z", "previously_billed_at": "2024-05-10T12:01:46.293348Z", "next_billed_at": "2024-06-10T12:01:46.293348Z", "trial_dates": null, "price": { "id": "pri_01h1vjfevh5etwq3rb416a23h2", "product_id": "pro_01h1vjes1y163xfj1rh1tkfb65", "type": "standard", "description": "Monthly", "name": "Monthly (recurring addon)", "tax_mode": "account_setting", "billing_cycle": { "frequency": 1, "interval": "month" }, "trial_period": null, "unit_price": { "amount": "10000", "currency_code": "USD" }, "unit_price_overrides": [], "custom_data": null, "status": "active", "quantity": { "minimum": 1, "maximum": 100 }, "import_meta": null, "created_at": "2023-06-01T13:31:12.625056Z", "updated_at": "2024-04-12T10:42:45.476453Z" }, "product": { "id": "pro_01h1vjes1y163xfj1rh1tkfb65", "name": "Analytics addon", "type": "standard", "description": "Unlock advanced insights into your flight data with enhanced analytics and reporting features. Includes customizable reporting templates and trend analysis across flights.", "tax_category": "standard", "image_url": "https://paddle.s3.amazonaws.com/user/165798/97dRpA6SXzcE6ekK9CAr_analytics.png", "custom_data": null, "status": "active", "created_at": "2023-06-01T13:30:50.302Z", "updated_at": "2024-04-05T15:47:17.163Z", "import_meta": null } }, { "status": "active", "quantity": 1, "recurring": true, "created_at": "2024-05-13T10:36:57.964Z", "updated_at": "2024-05-13T10:36:57.964Z", "previously_billed_at": "2024-05-13T10:36:57.964Z", "next_billed_at": "2024-06-10T12:01:46.293348Z", "trial_dates": null, "price": { "id": "pri_01gsz95g2zrkagg294kpstx54r", "product_id": "pro_01gsz92krfzy3hcx5h5rtgnfwz", "type": "standard", "description": "Monthly (recurring addon)", "name": "Monthly (recurring addon)", "tax_mode": "account_setting", "billing_cycle": { "frequency": 1, "interval": "month" }, "trial_period": null, "unit_price": { "amount": "25000", "currency_code": "USD" }, "unit_price_overrides": [], "custom_data": null, "status": "active", "quantity": { "minimum": 1, "maximum": 1 }, "import_meta": null, "created_at": "2023-02-23T13:59:52.159927Z", "updated_at": "2024-04-09T07:27:48.018296Z" }, "product": { "id": "pro_01gsz92krfzy3hcx5h5rtgnfwz", "name": "VIP support", "type": "standard", "description": "Get exclusive access to our expert team of product specialists, available to help you make the most of your AeroEdit subscription.", "tax_category": "standard", "image_url": "https://paddle.s3.amazonaws.com/user/165798/qgyipKJwRtq98YNboipo_vip-support.png", "custom_data": null, "status": "active", "created_at": "2023-02-23T13:58:17.615Z", "updated_at": "2024-04-05T15:44:02.893Z", "import_meta": null } }, { "status": "active", "quantity": 20, "recurring": true, "created_at": "2024-05-13T10:36:57.964Z", "updated_at": "2024-05-13T10:36:57.964Z", "previously_billed_at": "2024-05-13T10:36:57.964Z", "next_billed_at": "2024-06-10T12:01:46.293348Z", "trial_dates": null, "price": { "id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "product_id": "pro_01gsz4t5hdjse780zja8vvr7jg", "type": "standard", "description": "Monthly", "name": "Monthly (per seat)", "tax_mode": "account_setting", "billing_cycle": { "frequency": 1, "interval": "month" }, "trial_period": null, "unit_price": { "amount": "3000", "currency_code": "USD" }, "unit_price_overrides": [], "custom_data": null, "status": "active", "quantity": { "minimum": 1, "maximum": 999 }, "import_meta": null, "created_at": "2023-02-23T13:55:22.538367Z", "updated_at": "2024-04-11T13:54:52.254748Z" }, "product": { "id": "pro_01gsz4t5hdjse780zja8vvr7jg", "name": "AeroEdit Pro", "type": "standard", "description": "Designed for professional pilots, including all features plus in Basic plus compliance monitoring, route optimization, and third-party integrations.", "tax_category": "standard", "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png", "custom_data": { "features": { "aircraft_performance": true, "compliance_monitoring": true, "flight_log_management": true, "payment_by_invoice": false, "route_planning": true, "sso": false }, "suggested_addons": [ "pro_01h1vjes1y163xfj1rh1tkfb65", "pro_01gsz97mq9pa4fkyy0wqenepkz" ], "upgrade_description": "Move from Basic to Pro to take advantage of aircraft performance, advanced route planning, and compliance monitoring." }, "status": "active", "created_at": "2023-02-23T12:43:46.605Z", "updated_at": "2024-04-05T15:53:44.687Z", "import_meta": null } } ], "custom_data": null, "management_urls": { "update_payment_method": "https://buyer-portal.paddle.com/subscriptions/sub_01hxh62z5zb2jeebtnrjfkk15b/update-payment-method", "cancel": "https://buyer-portal.paddle.com/subscriptions/sub_01hxh62z5zb2jeebtnrjfkk15b/cancel" }, "discount": null, "update_summary": { "credit": { "amount": "-4927", "currency_code": "USD" }, "charge": { "amount": "83765", "currency_code": "USD" }, "result": { "action": "charge", "amount": "78838", "currency_code": "USD" } }, "import_meta": null, "consent_requirements": [] }, "meta": { "request_id": "d3d9d246-7adf-4f6f-a960-c17e0f314071" }}