> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt). # PATCH /subscriptions/{subscription_id}/preview **Preview an update to a subscription** 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. **Required permissions:** `subscription.read` ## Path parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `subscription_id` | string | required | Paddle ID of the subscription entity to work with. | ## Request body - `customer_id`: string — Paddle 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_id`: string — Paddle 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_id`: string | null — Paddle ID of the business that this subscription is for, prefixed with `biz_`. Include to change the business for a subscription. (pattern: `^biz_[a-z\d]{26}$`) - `currency_code`: string — 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`. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `next_billed_at`: string (date-time) — RFC 3339 datetime string of when this subscription is next scheduled to be billed. Include to change the next billing date. - `discount`: object | null — Details of the discount applied to this subscription. Include to add a discount to a subscription. `null` to remove a discount. - `id`: string (required) — Unique Paddle ID for this discount, prefixed with `dsc_`. (pattern: `^dsc_[a-z\d]{26}$`) - `effective_from`: string (required) — When this discount should take effect from. - `next_billing_period` — Takes effect on the next billing period. - `immediately` — Takes effect immediately. - `collection_mode`: string — How payment is collected for transactions created for this subscription. `automatic` for checkout, `manual` for invoices. - `automatic` — Payment is collected automatically using a checkout initially, then using a payment method on file. - `manual` — Payment is collected manually. Customers are sent an invoice with payment terms and can make a payment offline or using a checkout. Requires `billing_details`. - `billing_details`: object | null — Details for invoicing. Required if `collection_mode` is `manual`. `null` if changing `collection_mode` to `automatic`. - `enable_checkout`: boolean — Whether the related transaction may be paid using Paddle Checkout. (default: `false`) - `purchase_order_number`: string — Customer purchase order number. Appears on invoice documents. (Max length: 100) - `additional_information`: string | null — Notes or other information to include on this invoice. Appears on invoice documents. (Max length: 1500) - `payment_terms`: object — How long a customer has to pay this invoice once issued. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `scheduled_change`: null — 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. - `items`: array — 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_id`: string (required) — Paddle ID for the price to add to this subscription, prefixed with `pri_`. (pattern: `^pri_[a-z\d]{26}$`) - `quantity`: number — 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 - `quantity`: integer (required) — Quantity to bill for. (Min: 1) - `price`: object (required) — 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. - `description`: string (required) — Internal description for this price, not shown to customers. Typically notes for your team. (Length: 2–500) - `name`: string | 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_cycle`: object | null — How often this price should be charged. `null` if price is non-recurring (one-time). - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `trial_period`: object | 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`. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `tax_mode`: string — How tax is calculated for this price. (default: `"account_setting"`) - `account_setting` — Prices use the setting from your account. - `external` — Prices are exclusive of tax. - `internal` — Prices are inclusive of tax. - `location` — Prices are inclusive or exclusive of tax, depending on the country of the transaction. - `unit_price`: object (required) — Base price. This price applies to all customers, except for customers located in countries where you have `unit_price_overrides`. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `unit_price_overrides`: array — 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_codes`: array (required) — 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 code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AD` — Andorra - `AE` — United Arab Emirates - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei - `BO` — Bolivia - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba) - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BZ` — Belize - `CA` — Canada - `CC` — Cocos Islands - `CG` — Republic of Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire (Ivory Coast) - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CV` — Cape Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia (Czech Republic) - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands - `FM` — Micronesia - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KR` — South Korea - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic (Laos) - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova - `ME` — Montenegro - `MF` — Saint Martin - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — Macedonia - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestinian territories - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Reunion - `RO` — Romania - `RS` — Republic of Serbia - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SR` — Suriname - `ST` — São Tomé and Príncipe - `SV` — El Salvador - `SX` — Sint Maarten - `SZ` — Swaziland - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern and Antarctic Lands - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Turkey - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan - `TZ` — Tanzania - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City) - `VC` — Saint Vincent and the Grenadines - `VG` — British Virgin Islands - `VI` — U.S. Virgin Islands - `VN` — Vietnam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `XK` — Kosovo - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AF` — Afghanistan - `AQ` — Antarctica - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX. - `BY` — Belarus - `CD` — Democratic Republic of Congo - `CF` — Central African Republic - `CU` — Cuba - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME. - `HT` — Haiti - `IR` — Iran - `KP` — North Korea - `LY` — Libya - `ML` — Mali - `MM` — Myanmar (Burma) - `NI` — Nicaragua - `RU` — Russia - `SO` — Somalia - `SS` — South Sudan - `SD` — Sudan - `SY` — Syria - `VE` — Venezuela - `YE` — Yemen - `ZW` — Zimbabwe - `unit_price`: object (required) — Override price. This price applies to customers located in the countries for this unit price override. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `quantity`: object — Limits on how many times the related product can be purchased at this price. Useful for discount campaigns. If omitted, defaults to 1-100. - `minimum`: integer (required) — Minimum quantity of the product related to this price that can be bought. Required if `maximum` set. (Range: 1–999999999; default: `1`) - `maximum`: integer (required) — Maximum 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; default: `100`) - `custom_data`: object | null — Your own structured key-value data. - `product_id`: string (required) — Paddle ID for the product that this price is for, prefixed with `pro_`. (pattern: `^pro_[a-z\d]{26}$`) - Non-catalog price and product - `quantity`: integer (required) — Quantity to bill for. (Min: 1) - `price`: object (required) — 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. - `description`: string (required) — Internal description for this price, not shown to customers. Typically notes for your team. (Length: 2–500) - `name`: string | 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_cycle`: object | null — How often this price should be charged. `null` if price is non-recurring (one-time). - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `trial_period`: object | 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`. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `tax_mode`: string — How tax is calculated for this price. (default: `"account_setting"`) - `account_setting` — Prices use the setting from your account. - `external` — Prices are exclusive of tax. - `internal` — Prices are inclusive of tax. - `location` — Prices are inclusive or exclusive of tax, depending on the country of the transaction. - `unit_price`: object (required) — Base price. This price applies to all customers, except for customers located in countries where you have `unit_price_overrides`. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `unit_price_overrides`: array — 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_codes`: array (required) — 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 code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AD` — Andorra - `AE` — United Arab Emirates - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei - `BO` — Bolivia - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba) - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BZ` — Belize - `CA` — Canada - `CC` — Cocos Islands - `CG` — Republic of Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire (Ivory Coast) - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CV` — Cape Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia (Czech Republic) - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands - `FM` — Micronesia - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KR` — South Korea - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic (Laos) - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova - `ME` — Montenegro - `MF` — Saint Martin - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — Macedonia - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestinian territories - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Reunion - `RO` — Romania - `RS` — Republic of Serbia - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SR` — Suriname - `ST` — São Tomé and Príncipe - `SV` — El Salvador - `SX` — Sint Maarten - `SZ` — Swaziland - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern and Antarctic Lands - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Turkey - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan - `TZ` — Tanzania - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City) - `VC` — Saint Vincent and the Grenadines - `VG` — British Virgin Islands - `VI` — U.S. Virgin Islands - `VN` — Vietnam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `XK` — Kosovo - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AF` — Afghanistan - `AQ` — Antarctica - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX. - `BY` — Belarus - `CD` — Democratic Republic of Congo - `CF` — Central African Republic - `CU` — Cuba - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME. - `HT` — Haiti - `IR` — Iran - `KP` — North Korea - `LY` — Libya - `ML` — Mali - `MM` — Myanmar (Burma) - `NI` — Nicaragua - `RU` — Russia - `SO` — Somalia - `SS` — South Sudan - `SD` — Sudan - `SY` — Syria - `VE` — Venezuela - `YE` — Yemen - `ZW` — Zimbabwe - `unit_price`: object (required) — Override price. This price applies to customers located in the countries for this unit price override. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `quantity`: object — Limits on how many times the related product can be purchased at this price. Useful for discount campaigns. If omitted, defaults to 1-100. - `minimum`: integer (required) — Minimum quantity of the product related to this price that can be bought. Required if `maximum` set. (Range: 1–999999999; default: `1`) - `maximum`: integer (required) — Maximum 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; default: `100`) - `custom_data`: object | null — Your own structured key-value data. - `product`: object (required) — Product object for a non-catalog item to charge for. - `name`: string (required) — Name of this product. (Length: 1–200) - `description`: string | null — Short description for this product. (Max length: 2048) - `tax_category`: string (required) — Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account. - `digital-goods` — Non-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered. - `ebooks` — Digital books and educational material which is sold with permanent rights for use by the customer. - `implementation-services` — Remote configuration, set-up, and integrating software on behalf of a customer. - `professional-services` — Services that involve the application of your expertise and specialized knowledge of a software product. - `saas` — Products that allow users to connect to and use online or cloud-based applications over the Internet. - `software-programming-services` — Services that can be used to customize and white label software products. - `standard` — Software products that are pre-written and can be downloaded and installed onto a local device. - `training-services` — Training and education services related to software products. - `website-hosting` — Cloud 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. - Empty String - `custom_data`: object | null — Your own structured key-value data. - `custom_data`: object | null — Your own structured key-value data. - `proration_billing_mode`: string — 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. - `prorated_immediately` — Paddle calculates the prorated amount for the subscription changes based on the current billing cycle, then creates a transaction to collect immediately. - `prorated_next_billing_period` — Paddle 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_immediately` — Paddle does not calculate proration for the subscription changes, creating a transaction to collect for the full amount immediately. - `full_next_billing_period` — Paddle 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_bill` — Paddle does not bill for the subscription changes. - `on_payment_failure`: string — How Paddle should handle changes made to a subscription or its items if the payment fails during update. If omitted, defaults to `prevent_change`. (default: `"prevent_change"`) - `prevent_change` — In case of payment failure, prevent the change to the subscription from applying. - `apply_change` — In case of payment failure, apply the change and update the subscription. ### Request example ```json { "items": [ { "price_id": "pri_01gsz8x8sawmvhz1pv30nge1ke", "quantity": 20 }, { "price_id": "pri_01h1vjfevh5etwq3rb416a23h2", "quantity": 1 }, { "price_id": "pri_01gsz95g2zrkagg294kpstx54r", "quantity": 1 } ], "proration_billing_mode": "prorated_immediately" } ``` ## Response (200) - `data`: object (required) — Represents a subscription preview when previewing a subscription. - `status`: string (required) — Status of this subscription. Set automatically by Paddle. Use the pause subscription or cancel subscription operations to change. - `active` — Subscription is active. Paddle is billing for this subscription and related transactions aren't past due. - `canceled` — Subscription 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_due` — Subscription 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). - `paused` — Subscription 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 to `paused` when the scheduled change takes effect. - `trialing` — Subscription is in trial. - `customer_id`: string (required) — Paddle ID of the customer that this subscription is for, prefixed with `ctm_`. (pattern: `^ctm_[a-z\d]{26}$`) - `address_id`: string (required) — Paddle ID of the address that this subscription is for, prefixed with `add_`. (pattern: `^add_[a-z\d]{26}$`) - `business_id`: string | null (required) — Paddle ID of the business that this subscription is for, prefixed with `biz_`. (pattern: `^biz_[a-z\d]{26}$`) - `currency_code`: string (required) — 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`. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `started_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this subscription started. This may be different from `first_billed_at` if the subscription started in trial. - `first_billed_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this subscription was first billed. This may be different from `started_at` if the subscription started in trial. - `next_billed_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this subscription is next scheduled to be billed. - `paused_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this subscription was paused. Set automatically by Paddle when the pause subscription operation is used. `null` if not paused. - `canceled_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this subscription was canceled. Set automatically by Paddle when the cancel subscription operation is used. `null` if not canceled. - `discount`: object | null (required) — Details of the discount applied to this subscription. - `id`: string (required) — Unique Paddle ID for this discount, prefixed with `dsc_`. (pattern: `^dsc_[a-z\d]{26}$`) - `starts_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this discount was first applied. `null` for canceled subscriptions where a discount was redeemed but never applied to a transaction. - `ends_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this discount no longer applies. Where a discount has `maximum_recurring_intervals`, this is the date of the last billing period where this discount applies. `null` where a discount recurs forever. - `type`: string (required) — Whether this discount applies for multiple billing periods. - `recurring` — Discount applies to multiple billing periods. - `one-off` — Discount 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_mode`: string (required) — How payment is collected for transactions created for this subscription. `automatic` for checkout, `manual` for invoices. (default: `"automatic"`) - `automatic` — Payment is collected automatically using a checkout initially, then using a payment method on file. - `manual` — Payment is collected manually. Customers are sent an invoice with payment terms and can make a payment offline or using a checkout. Requires `billing_details`. - `billing_details`: object | null (required) — Details for invoicing. Required if `collection_mode` is `manual`. - `enable_checkout`: boolean (required) — Whether the related transaction may be paid using Paddle Checkout. If omitted when creating a transaction, defaults to `false`. (default: `false`) - `purchase_order_number`: string (required) — Customer purchase order number. Appears on invoice documents. (Max length: 100) - `additional_information`: string | null (required) — Notes or other information to include on this invoice. Appears on invoice documents. (Max length: 1500) - `payment_terms`: object (required) — How long a customer has to pay this invoice once issued. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `current_billing_period`: object | null (required) — Current billing period for this subscription. Set automatically by Paddle based on the billing cycle. `null` for `paused` and `canceled` subscriptions. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `billing_cycle`: object (required) — How often this subscription renews. Set automatically by Paddle based on the prices on this subscription. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `scheduled_change`: object | null (required) — 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. - `action`: string (required) — Kind of change that's scheduled to be applied to this subscription. - `cancel` — Subscription is scheduled to cancel. Its status changes to `canceled` on the `effective_at` date. - `pause` — Subscription is scheduled to pause. Its status changes to `paused` on the `effective_at` date. - `resume` — Subscription is scheduled to resume. Its status changes to `active` on the `effective_at` date. - `effective_at`: string (date-time) (required) — RFC 3339 datetime string of when this scheduled change takes effect. - `resume_at`: string (date-time) | null (required) — RFC 3339 datetime string of when a paused subscription should resume. Only used for `pause` scheduled changes. - `management_urls`: object (required) — 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_method`: string (uri) | null (required) — 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. - `cancel`: string (uri) (required) — 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. - `items`: array (required) — List of items on this subscription. Only recurring items are returned. (Items: 1–100) - `status`: string (required) — Status of this subscription item. Set automatically by Paddle. - `active` — This item is active. It is not in trial and Paddle bills for it. - `inactive` — This item is not active. Set when the related subscription is paused. - `trialing` — This item is in trial. Paddle has not billed for it. - `quantity`: number (required) — Quantity of this item on the subscription. (Min: 1) - `recurring`: boolean (required) — Whether this is a recurring item. `false` if one-time. - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this item was added to this subscription. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this item was last updated on this subscription. - `previously_billed_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this item was last billed. - `next_billed_at`: string (date-time) | null (required) — RFC 3339 datetime string of when this item is next scheduled to be billed. - `trial_dates`: object | null (required) — Trial dates for this item. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `price`: object (required) — Related price entity for this item. This reflects the price entity at the time it was added to the subscription. - `id`: string (required) — Unique Paddle ID for this price, prefixed with `pri_`. (pattern: `^pri_[a-z\d]{26}$`) - `product_id`: string (required) — Paddle ID for the product that this price is for, prefixed with `pro_`. (pattern: `^pro_[a-z\d]{26}$`) - `description`: string (required) — Internal description for this price, not shown to customers. Typically notes for your team. (Length: 2–500) - `type`: string (required) — Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard. (default: `"standard"`) - `custom` — Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard. - `standard` — Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily. - `name`: string | null (required) — Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills. (Length: 1–150) - `billing_cycle`: object | null (required) — How often this price should be charged. `null` if price is non-recurring (one-time). - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `trial_period`: object | null (required) — 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`. - `interval`: string (required) — Unit of time. - `day` - `week` - `month` - `year` - `frequency`: integer (required) — Amount of time. (Min: 1) - `requires_payment_method`: boolean (required) — Whether 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." (default: `true`) - `unit_price`: object | null — Trial price. Customers are billed this amount for the duration of the trial period. Applies to all customers except those in countries with `unit_price_overrides`. If `null`, customers are not charged during the trial. - `amount`: string (required) — 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_code`: string — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `unit_price_overrides`: array — List of unit price overrides for trial pricing. Use to override base trial price with a custom trial price and currency for a country or group of countries. (Items: max 250) - `country_codes`: array (required) — 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 code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AD` — Andorra - `AE` — United Arab Emirates - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei - `BO` — Bolivia - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba) - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BZ` — Belize - `CA` — Canada - `CC` — Cocos Islands - `CG` — Republic of Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire (Ivory Coast) - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CV` — Cape Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia (Czech Republic) - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands - `FM` — Micronesia - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KR` — South Korea - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic (Laos) - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova - `ME` — Montenegro - `MF` — Saint Martin - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — Macedonia - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestinian territories - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Reunion - `RO` — Romania - `RS` — Republic of Serbia - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SR` — Suriname - `ST` — São Tomé and Príncipe - `SV` — El Salvador - `SX` — Sint Maarten - `SZ` — Swaziland - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern and Antarctic Lands - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Turkey - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan - `TZ` — Tanzania - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City) - `VC` — Saint Vincent and the Grenadines - `VG` — British Virgin Islands - `VI` — U.S. Virgin Islands - `VN` — Vietnam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `XK` — Kosovo - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AF` — Afghanistan - `AQ` — Antarctica - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX. - `BY` — Belarus - `CD` — Democratic Republic of Congo - `CF` — Central African Republic - `CU` — Cuba - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME. - `HT` — Haiti - `IR` — Iran - `KP` — North Korea - `LY` — Libya - `ML` — Mali - `MM` — Myanmar (Burma) - `NI` — Nicaragua - `RU` — Russia - `SO` — Somalia - `SS` — South Sudan - `SD` — Sudan - `SY` — Syria - `VE` — Venezuela - `YE` — Yemen - `ZW` — Zimbabwe - `unit_price`: object (required) — Override price. This price applies to customers located in the countries for this unit price override. - `amount`: string (required) — 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_code`: string — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `tax_mode`: string (required) — How tax is calculated for this price. (default: `"account_setting"`) - `account_setting` — Prices use the setting from your account. - `external` — Prices are exclusive of tax. - `internal` — Prices are inclusive of tax. - `location` — Prices are inclusive or exclusive of tax, depending on the country of the transaction. - `unit_price`: object (required) — Base price. This price applies to all customers, except for customers located in countries where you have `unit_price_overrides`. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `unit_price_overrides`: array (required) — 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_codes`: array (required) — 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 code for a country that Paddle supports sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AD` — Andorra - `AE` — United Arab Emirates - `AG` — Antigua and Barbuda - `AI` — Anguilla - `AL` — Albania - `AM` — Armenia - `AO` — Angola - `AR` — Argentina - `AS` — American Samoa - `AT` — Austria - `AU` — Australia - `AW` — Aruba - `AX` — Åland Islands - `AZ` — Azerbaijan - `BA` — Bosnia and Herzegovina - `BB` — Barbados - `BD` — Bangladesh - `BE` — Belgium - `BF` — Burkina Faso - `BG` — Bulgaria - `BH` — Bahrain - `BI` — Burundi - `BJ` — Benin - `BL` — Saint Barthélemy - `BM` — Bermuda - `BN` — Brunei - `BO` — Bolivia - `BQ` — Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba) - `BR` — Brazil - `BS` — Bahamas - `BT` — Bhutan - `BV` — Bouvet Island - `BW` — Botswana - `BZ` — Belize - `CA` — Canada - `CC` — Cocos Islands - `CG` — Republic of Congo - `CH` — Switzerland - `CI` — Côte d'Ivoire (Ivory Coast) - `CK` — Cook Islands - `CL` — Chile - `CM` — Cameroon - `CN` — China - `CO` — Colombia - `CR` — Costa Rica - `CV` — Cape Verde - `CW` — Curaçao - `CX` — Christmas Island - `CY` — Cyprus - `CZ` — Czechia (Czech Republic) - `DE` — Germany - `DJ` — Djibouti - `DK` — Denmark - `DM` — Dominica - `DO` — Dominican Republic - `DZ` — Algeria - `EC` — Ecuador - `EE` — Estonia - `EG` — Egypt - `EH` — Western Sahara - `ER` — Eritrea - `ES` — Spain - `ET` — Ethiopia - `FI` — Finland - `FJ` — Fiji - `FK` — Falkland Islands - `FM` — Micronesia - `FO` — Faroe Islands - `FR` — France - `GA` — Gabon - `GB` — United Kingdom - `GD` — Grenada - `GE` — Georgia - `GF` — French Guiana - `GG` — Guernsey - `GH` — Ghana - `GI` — Gibraltar - `GL` — Greenland - `GM` — Gambia - `GN` — Guinea - `GP` — Guadeloupe - `GQ` — Equatorial Guinea - `GR` — Greece - `GS` — South Georgia and the South Sandwich Islands - `GT` — Guatemala - `GU` — Guam - `GW` — Guinea-Bissau - `GY` — Guyana - `HK` — Hong Kong - `HM` — Heard Island and McDonald Islands - `HN` — Honduras - `HR` — Croatia - `HU` — Hungary - `ID` — Indonesia - `IE` — Ireland - `IL` — Israel - `IM` — Isle of Man - `IN` — India - `IO` — British Indian Ocean Territory - `IQ` — Iraq - `IS` — Iceland - `IT` — Italy - `JE` — Jersey - `JM` — Jamaica - `JO` — Jordan - `JP` — Japan - `KE` — Kenya - `KG` — Kyrgyzstan - `KH` — Cambodia - `KI` — Kiribati - `KM` — Comoros - `KN` — Saint Kitts and Nevis - `KR` — South Korea - `KW` — Kuwait - `KY` — Cayman Islands - `KZ` — Kazakhstan - `LA` — Lao People's Democratic Republic (Laos) - `LB` — Lebanon - `LC` — Saint Lucia - `LI` — Liechtenstein - `LK` — Sri Lanka - `LR` — Liberia - `LS` — Lesotho - `LT` — Lithuania - `LU` — Luxembourg - `LV` — Latvia - `MA` — Morocco - `MC` — Monaco - `MD` — Moldova - `ME` — Montenegro - `MF` — Saint Martin - `MG` — Madagascar - `MH` — Marshall Islands - `MK` — Macedonia - `MN` — Mongolia - `MO` — Macao - `MP` — Northern Mariana Islands - `MQ` — Martinique - `MR` — Mauritania - `MS` — Montserrat - `MT` — Malta - `MU` — Mauritius - `MV` — Maldives - `MW` — Malawi - `MX` — Mexico - `MY` — Malaysia - `MZ` — Mozambique - `NA` — Namibia - `NC` — New Caledonia - `NE` — Niger - `NF` — Norfolk Island - `NG` — Nigeria - `NL` — Netherlands - `NO` — Norway - `NP` — Nepal - `NR` — Nauru - `NU` — Niue - `NZ` — New Zealand - `OM` — Oman - `PA` — Panama - `PE` — Peru - `PF` — French Polynesia - `PG` — Papua New Guinea - `PH` — Philippines - `PK` — Pakistan - `PL` — Poland - `PM` — Saint Pierre and Miquelon - `PN` — Pitcairn - `PR` — Puerto Rico - `PS` — Palestinian territories - `PT` — Portugal - `PW` — Palau - `PY` — Paraguay - `QA` — Qatar - `RE` — Reunion - `RO` — Romania - `RS` — Republic of Serbia - `RW` — Rwanda - `SA` — Saudi Arabia - `SB` — Solomon Islands - `SC` — Seychelles - `SE` — Sweden - `SG` — Singapore - `SH` — Saint Helena - `SI` — Slovenia - `SJ` — Svalbard and Jan Mayen - `SK` — Slovakia - `SL` — Sierra Leone - `SM` — San Marino - `SN` — Senegal - `SR` — Suriname - `ST` — São Tomé and Príncipe - `SV` — El Salvador - `SX` — Sint Maarten - `SZ` — Swaziland - `TC` — Turks and Caicos Islands - `TD` — Chad - `TF` — French Southern and Antarctic Lands - `TG` — Togo - `TH` — Thailand - `TJ` — Tajikistan - `TK` — Tokelau - `TL` — Timor-Leste - `TM` — Turkmenistan - `TN` — Tunisia - `TO` — Tonga - `TR` — Turkey - `TT` — Trinidad and Tobago - `TV` — Tuvalu - `TW` — Taiwan - `TZ` — Tanzania - `UA` — Ukraine - `UG` — Uganda - `UM` — United States Minor Outlying Islands - `US` — United States - `UY` — Uruguay - `UZ` — Uzbekistan - `VA` — Holy See (Vatican City) - `VC` — Saint Vincent and the Grenadines - `VG` — British Virgin Islands - `VI` — U.S. Virgin Islands - `VN` — Vietnam - `VU` — Vanuatu - `WF` — Wallis and Futuna - `WS` — Samoa - `XK` — Kosovo - `YT` — Mayotte - `ZA` — South Africa - `ZM` — Zambia - string — Two-letter code for a country that Paddle does not support sales to. Typically an ISO 3166-1 alpha-2 code, though Paddle uses a small number of codes that ISO doesn't currently assign. - `AF` — Afghanistan - `AQ` — Antarctica - `AN` — Netherlands Antilles. Withdrawn ISO 3166-1 code, succeeded by BQ, CW and SX. - `BY` — Belarus - `CD` — Democratic Republic of Congo - `CF` — Central African Republic - `CU` — Cuba - `CS` — Serbia and Montenegro. Withdrawn ISO 3166-1 code, succeeded by RS and ME. - `HT` — Haiti - `IR` — Iran - `KP` — North Korea - `LY` — Libya - `ML` — Mali - `MM` — Myanmar (Burma) - `NI` — Nicaragua - `RU` — Russia - `SO` — Somalia - `SS` — South Sudan - `SD` — Sudan - `SY` — Syria - `VE` — Venezuela - `YE` — Yemen - `ZW` — Zimbabwe - `unit_price`: object (required) — Override price. This price applies to customers located in the countries for this unit price override. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `quantity`: object (required) — Limits on how many times the related product can be purchased at this price. Useful for discount campaigns. - `minimum`: integer (required) — Minimum quantity of the product related to this price that can be bought. Required if `maximum` set. (Range: 1–999999999; default: `1`) - `maximum`: integer (required) — Maximum 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; default: `100`) - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`) - `active` — Entity is active and can be used. - `archived` — Entity is archived, so can't be used. - `custom_data`: object | null (required) — Your own structured key-value data. - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `product`: object (required) — Related product entity for this item. This reflects the product entity at the time it was added to the subscription. - `id`: string (required) — Unique Paddle ID for this product, prefixed with `pro_`. (pattern: `^pro_[a-z\d]{26}$`) - `name`: string (required) — Name of this product. (Length: 1–200) - `description`: string | null (required) — Short description for this product. (Max length: 2048) - `type`: string (required) — Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard. (default: `"standard"`) - `custom` — Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard. - `standard` — Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily. - `tax_category`: string (required) — Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account. - `digital-goods` — Non-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered. - `ebooks` — Digital books and educational material which is sold with permanent rights for use by the customer. - `implementation-services` — Remote configuration, set-up, and integrating software on behalf of a customer. - `professional-services` — Services that involve the application of your expertise and specialized knowledge of a software product. - `saas` — Products that allow users to connect to and use online or cloud-based applications over the Internet. - `software-programming-services` — Services that can be used to customize and white label software products. - `standard` — Software products that are pre-written and can be downloaded and installed onto a local device. - `training-services` — Training and education services related to software products. - `website-hosting` — Cloud storage service for personal or corporate information, assets, or intellectual property. - `image_url` (required) — Image for this product. Included in the checkout and on some customer documents. - Image Url — A URL to an image. - Empty String - `custom_data`: object | null (required) — Your own structured key-value data. - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`) - `active` — Entity is active and can be used. - `archived` — Entity is archived, so can't be used. - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `custom_data`: object | null (required) — Your own structured key-value data. - `immediate_transaction`: object | null (required) — Preview of the immediate transaction created as a result of changes to the subscription. Returns a complete object where `proration_billing_mode` is `prorated_immediately` or `full_immediately`; `null` otherwise. - `billing_period`: object (required) — Billing period for the next transaction. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `details`: object (required) — 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_used`: array (required) — List of tax rates applied to this transaction preview. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction preview. - `totals`: object (required) — Calculated totals for the tax applied to this transaction preview. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of the total for a transaction preview. `fee` and `earnings` always return `null` for transaction previews. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `credit`: string (required) — Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a `billed` transaction. - `credit_to_balance`: string (required) — Additional credit generated from negative `details.line_items`. This credit is added to the customer balance. - `balance`: string (required) — Total due on a transaction after credits and any payments. - `grand_total`: string (required) — Total due on a transaction after credits but before any payments. - `grand_total_tax`: string (required) — Net tax amount included in `grand_total`. Equals the full `tax` amount unless credits are applied, in which case this value is proportionally reduced. - `fee`: string | null (required) — Total fee taken by Paddle for this transaction. `null` until the transaction is `completed` and the fee is processed. - `earnings`: string | null (required) — Total earnings for this transaction. This is the total minus the Paddle fee. `null` until the transaction is `completed` and the fee is processed. - `currency_code`: string (required) — Three-letter ISO 4217 currency code of the currency used for this transaction. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `line_items`: array (required) — 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_id`: string | null (required) — Paddle ID for the price related to this transaction line item, prefixed with `pri_`. The value is null for custom prices being previewed. (pattern: `^pri_[a-z\d]{26}$`) - `quantity`: integer (required) — Quantity of this transaction line item. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction line item. - `unit_totals`: object (required) — Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `product`: object (required) — Related product entity for this transaction line item price. - `id`: string | null (required) — Unique Paddle ID for this product, prefixed with `pro_`. The value is null for custom products being previewed. (pattern: `^pro_[a-z\d]{26}$`) - `name`: string (required) — Name of this product. (Length: 1–200) - `description`: string | null (required) — Short description for this product. (Max length: 2048) - `type`: string (required) — Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard. (default: `"standard"`) - `custom` — Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard. - `standard` — Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily. - `tax_category`: string (required) — Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account. - `digital-goods` — Non-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered. - `ebooks` — Digital books and educational material which is sold with permanent rights for use by the customer. - `implementation-services` — Remote configuration, set-up, and integrating software on behalf of a customer. - `professional-services` — Services that involve the application of your expertise and specialized knowledge of a software product. - `saas` — Products that allow users to connect to and use online or cloud-based applications over the Internet. - `software-programming-services` — Services that can be used to customize and white label software products. - `standard` — Software products that are pre-written and can be downloaded and installed onto a local device. - `training-services` — Training and education services related to software products. - `website-hosting` — Cloud storage service for personal or corporate information, assets, or intellectual property. - `image_url` (required) — Image for this product. Included in the checkout and on some customer documents. - Image Url — A URL to an image. - Empty String - `custom_data`: object | null (required) — Your own structured key-value data. - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`) - `active` — Entity is active and can be used. - `archived` — Entity is archived, so can't be used. - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `proration`: object | null (required) — How proration was calculated for this item. - `rate`: string (required) — Rate used to calculate proration. - `billing_period`: object (required) — Billing period that proration is based on. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `adjustments`: array (required) — Preview of adjustments for the next transaction. - `transaction_id`: string (required) — Paddle ID for this transaction entity that this adjustment relates to, prefixed with `txn_`. (pattern: `^txn_[a-z\d]{26}$`) - `items`: array (required) — List of transaction items that this adjustment is for. (Items: max 100) - `item_id`: string (required) — Paddle ID for the transaction item that this adjustment item relates to, prefixed with `txnitm_`. (pattern: `^txnitm_[a-z\d]{26}$`) - `type`: string (required) — Type of adjustment for this transaction item. `tax` adjustments are automatically created by Paddle. Include `amount` when creating a `partial` adjustment. - `full` — Full total for this transaction item is adjusted. - `partial` — Part of this transaction item is adjusted. Include `amount` to specify the partial amount adjusted. - `tax` — Tax for this transaction item is adjusted. Created automatically by Paddle. - `proration` — A prorated amount for this transaction item is adjusted. Created automatically by Paddle in some cases when making changes to a subscription. - `amount`: string | null (required) — Amount adjusted for this transaction item. Required when item `type` is `partial`. - `proration`: object | null (required) — How proration was calculated for this adjustment item. - `rate`: string (required) — Rate used to calculate proration. - `billing_period`: object (required) — Billing period that proration is based on. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `totals`: object (required) — Breakdown of the total for an adjustment item. - `subtotal`: string (required) — Amount multiplied by quantity. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after tax. - `totals`: object (required) — Calculated totals for this adjustment. - `subtotal`: string (required) — Total before tax. For tax adjustments, the value is 0. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after tax. - `fee`: string (required) — Total fee taken by Paddle for this adjustment. - `retained_fee`: string — Paddle fees retained for this adjustment. - `earnings`: string (required) — Total 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_code`: string (required) — Three-letter ISO 4217 currency code used for this adjustment. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `next_transaction`: object | null (required) — Preview of the next transaction for this subscription. Includes charges created where `proration_billing_mode` is `prorated_next_billing_period` or `full_next_billing_period`, as well as one-time charges. `null` if the subscription is scheduled to cancel or pause. - `billing_period`: object (required) — Billing period for the next transaction. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `details`: object (required) — 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_used`: array (required) — List of tax rates applied to this transaction preview. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction preview. - `totals`: object (required) — Calculated totals for the tax applied to this transaction preview. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of the total for a transaction preview. `fee` and `earnings` always return `null` for transaction previews. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `credit`: string (required) — Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a `billed` transaction. - `credit_to_balance`: string (required) — Additional credit generated from negative `details.line_items`. This credit is added to the customer balance. - `balance`: string (required) — Total due on a transaction after credits and any payments. - `grand_total`: string (required) — Total due on a transaction after credits but before any payments. - `grand_total_tax`: string (required) — Net tax amount included in `grand_total`. Equals the full `tax` amount unless credits are applied, in which case this value is proportionally reduced. - `fee`: string | null (required) — Total fee taken by Paddle for this transaction. `null` until the transaction is `completed` and the fee is processed. - `earnings`: string | null (required) — Total earnings for this transaction. This is the total minus the Paddle fee. `null` until the transaction is `completed` and the fee is processed. - `currency_code`: string (required) — Three-letter ISO 4217 currency code of the currency used for this transaction. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `line_items`: array (required) — 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_id`: string | null (required) — Paddle ID for the price related to this transaction line item, prefixed with `pri_`. The value is null for custom prices being previewed. (pattern: `^pri_[a-z\d]{26}$`) - `quantity`: integer (required) — Quantity of this transaction line item. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction line item. - `unit_totals`: object (required) — Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `product`: object (required) — Related product entity for this transaction line item price. - `id`: string | null (required) — Unique Paddle ID for this product, prefixed with `pro_`. The value is null for custom products being previewed. (pattern: `^pro_[a-z\d]{26}$`) - `name`: string (required) — Name of this product. (Length: 1–200) - `description`: string | null (required) — Short description for this product. (Max length: 2048) - `type`: string (required) — Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard. (default: `"standard"`) - `custom` — Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard. - `standard` — Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily. - `tax_category`: string (required) — Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account. - `digital-goods` — Non-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered. - `ebooks` — Digital books and educational material which is sold with permanent rights for use by the customer. - `implementation-services` — Remote configuration, set-up, and integrating software on behalf of a customer. - `professional-services` — Services that involve the application of your expertise and specialized knowledge of a software product. - `saas` — Products that allow users to connect to and use online or cloud-based applications over the Internet. - `software-programming-services` — Services that can be used to customize and white label software products. - `standard` — Software products that are pre-written and can be downloaded and installed onto a local device. - `training-services` — Training and education services related to software products. - `website-hosting` — Cloud storage service for personal or corporate information, assets, or intellectual property. - `image_url` (required) — Image for this product. Included in the checkout and on some customer documents. - Image Url — A URL to an image. - Empty String - `custom_data`: object | null (required) — Your own structured key-value data. - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`) - `active` — Entity is active and can be used. - `archived` — Entity is archived, so can't be used. - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `proration`: object | null (required) — How proration was calculated for this item. - `rate`: string (required) — Rate used to calculate proration. - `billing_period`: object (required) — Billing period that proration is based on. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `adjustments`: array (required) — Preview of adjustments for the next transaction. - `transaction_id`: string (required) — Paddle ID for this transaction entity that this adjustment relates to, prefixed with `txn_`. (pattern: `^txn_[a-z\d]{26}$`) - `items`: array (required) — List of transaction items that this adjustment is for. (Items: max 100) - `item_id`: string (required) — Paddle ID for the transaction item that this adjustment item relates to, prefixed with `txnitm_`. (pattern: `^txnitm_[a-z\d]{26}$`) - `type`: string (required) — Type of adjustment for this transaction item. `tax` adjustments are automatically created by Paddle. Include `amount` when creating a `partial` adjustment. - `full` — Full total for this transaction item is adjusted. - `partial` — Part of this transaction item is adjusted. Include `amount` to specify the partial amount adjusted. - `tax` — Tax for this transaction item is adjusted. Created automatically by Paddle. - `proration` — A prorated amount for this transaction item is adjusted. Created automatically by Paddle in some cases when making changes to a subscription. - `amount`: string | null (required) — Amount adjusted for this transaction item. Required when item `type` is `partial`. - `proration`: object | null (required) — How proration was calculated for this adjustment item. - `rate`: string (required) — Rate used to calculate proration. - `billing_period`: object (required) — Billing period that proration is based on. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `totals`: object (required) — Breakdown of the total for an adjustment item. - `subtotal`: string (required) — Amount multiplied by quantity. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after tax. - `totals`: object (required) — Calculated totals for this adjustment. - `subtotal`: string (required) — Total before tax. For tax adjustments, the value is 0. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after tax. - `fee`: string (required) — Total fee taken by Paddle for this adjustment. - `retained_fee`: string — Paddle fees retained for this adjustment. - `earnings`: string (required) — Total 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_code`: string (required) — Three-letter ISO 4217 currency code used for this adjustment. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `recurring_transaction_details`: object (required) — 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_used`: array (required) — List of tax rates applied to this transaction preview. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction preview. - `totals`: object (required) — Calculated totals for the tax applied to this transaction preview. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of the total for a transaction preview. `fee` and `earnings` always return `null` for transaction previews. - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `credit`: string (required) — Total credit applied to this transaction. This includes credits applied using a customer's credit balance and adjustments to a `billed` transaction. - `credit_to_balance`: string (required) — Additional credit generated from negative `details.line_items`. This credit is added to the customer balance. - `balance`: string (required) — Total due on a transaction after credits and any payments. - `grand_total`: string (required) — Total due on a transaction after credits but before any payments. - `grand_total_tax`: string (required) — Net tax amount included in `grand_total`. Equals the full `tax` amount unless credits are applied, in which case this value is proportionally reduced. - `fee`: string | null (required) — Total fee taken by Paddle for this transaction. `null` until the transaction is `completed` and the fee is processed. - `earnings`: string | null (required) — Total earnings for this transaction. This is the total minus the Paddle fee. `null` until the transaction is `completed` and the fee is processed. - `currency_code`: string (required) — Three-letter ISO 4217 currency code of the currency used for this transaction. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `line_items`: array (required) — 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_id`: string | null (required) — Paddle ID for the price related to this transaction line item, prefixed with `pri_`. The value is null for custom prices being previewed. (pattern: `^pri_[a-z\d]{26}$`) - `quantity`: integer (required) — Quantity of this transaction line item. - `tax_rate`: string (required) — Rate used to calculate tax for this transaction line item. - `unit_totals`: object (required) — Breakdown of the charge for one unit in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `totals`: object (required) — Breakdown of a charge in the lowest denomination of a currency (e.g. cents for USD). - `subtotal`: string (required) — Subtotal before discount, tax, and deductions. If an item, unit price multiplied by quantity. - `discount`: string (required) — Total 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. - `tax`: string (required) — Total tax on the subtotal. - `total`: string (required) — Total after discount and tax. - `product`: object (required) — Related product entity for this transaction line item price. - `id`: string | null (required) — Unique Paddle ID for this product, prefixed with `pro_`. The value is null for custom products being previewed. (pattern: `^pro_[a-z\d]{26}$`) - `name`: string (required) — Name of this product. (Length: 1–200) - `description`: string | null (required) — Short description for this product. (Max length: 2048) - `type`: string (required) — Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard. (default: `"standard"`) - `custom` — Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard. - `standard` — Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily. - `tax_category`: string (required) — Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account. - `digital-goods` — Non-customizable digital files or media (not software) acquired with an up front payment that can be accessed without any physical product being delivered. - `ebooks` — Digital books and educational material which is sold with permanent rights for use by the customer. - `implementation-services` — Remote configuration, set-up, and integrating software on behalf of a customer. - `professional-services` — Services that involve the application of your expertise and specialized knowledge of a software product. - `saas` — Products that allow users to connect to and use online or cloud-based applications over the Internet. - `software-programming-services` — Services that can be used to customize and white label software products. - `standard` — Software products that are pre-written and can be downloaded and installed onto a local device. - `training-services` — Training and education services related to software products. - `website-hosting` — Cloud storage service for personal or corporate information, assets, or intellectual property. - `image_url` (required) — Image for this product. Included in the checkout and on some customer documents. - Image Url — A URL to an image. - Empty String - `custom_data`: object | null (required) — Your own structured key-value data. - `status`: string (required) — Whether this entity can be used in Paddle. (default: `"active"`) - `active` — Entity is active and can be used. - `archived` — Entity is archived, so can't be used. - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle. - `proration`: object | null (required) — How proration was calculated for this item. - `rate`: string (required) — Rate used to calculate proration. - `billing_period`: object (required) — Billing period that proration is based on. - `starts_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `update_summary`: object | null (required) — Impact of this subscription change. Includes whether the change results in a charge or credit, and totals for prorated amounts. - `credit`: object (required) — Details of any credit adjustments created for this update. Paddle creates adjustments against existing transactions when prorating. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `charge`: object (required) — Details of the transaction to be created for this update. Paddle creates a transaction to bill for new charges. - `amount`: string (required) — 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_code`: string (required) — Supported three-letter ISO 4217 currency code. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `result`: object (required) — 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. - `action`: string (required) — Whether the subscription change results in a prorated credit or a charge. - `credit` — Changes to the subscription results in a prorated credit. - `charge` — Changes to the subscription results in a prorated charge. - `amount`: string (required) — Amount representing the result of this update, either a charge or a credit. - `currency_code`: string (required) — Three-letter ISO 4217 currency code for the transaction or adjustment. - `USD` — United States Dollar - `EUR` — Euro - `GBP` — Pound Sterling - `JPY` — Japanese Yen - `AUD` — Australian Dollar - `CAD` — Canadian Dollar - `CHF` — Swiss Franc - `HKD` — Hong Kong Dollar - `SGD` — Singapore Dollar - `SEK` — Swedish Krona - `ARS` — Argentine Peso - `BRL` — Brazilian Real - `CLP` — Chilean Peso - `CNY` — Chinese Yuan - `COP` — Colombian Peso - `CZK` — Czech Koruna - `DKK` — Danish Krone - `HUF` — Hungarian Forint - `ILS` — Israeli Shekel - `INR` — Indian Rupee - `KRW` — South Korean Won - `MXN` — Mexican Peso - `NOK` — Norwegian Krone - `NZD` — New Zealand Dollar - `PEN` — Peruvian Sol - `PLN` — Polish Zloty - `RUB` — Russian Ruble - `THB` — Thai Baht - `TRY` — Turkish Lira - `TWD` — New Taiwan Dollar - `UAH` — Ukrainian Hryvnia - `VND` — Vietnamese Dong - `ZAR` — South African Rand - `import_meta`: object | null (required) — Import information for this entity. `null` if this entity is not imported. - `external_id`: string | null — Reference or identifier for this entity from the provider where it was imported from. (Length: 1–200) - `imported_from`: string (required) — Name of the platform or provider where this entity was imported from. (Length: 1–200) - `consent_requirements`: array (required) — List of active consent requirements for the subscription's current billing period. - `id`: string (required) — Unique Paddle ID for this subscription consent requirement entity, prefixed with `subconreq_`. (pattern: `^subconreq_[a-z\d]{26}$`) - `requirement`: string (required) — Type of consent required for successful renewal. - `trial_ending` — Consent required because the trial period is ending. - `introductory_discount_ending` — Consent required because an initial discount is ending. - `status`: string (required) — Status of this consent requirement. - `pending` — Consent not yet granted. Subscription is canceled on next renewal. - `granted` — Consent granted. Subscription renews normally. - `voided` — Consent voided. Consent requirement is no longer applicable, either because the consent is no longer required, or another consent requirement has replaced it. - `created_at`: string (date-time) (required) — RFC 3339 datetime string of when this entity was created. Set automatically by Paddle. - `consent_period`: object | null (required) — 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_at`: string (date-time) (required) — RFC 3339 datetime string of when this period starts. - `ends_at`: string (date-time) (required) — RFC 3339 datetime string of when this period ends. - `granted_at`: string (date-time) | null (required) — RFC 3339 datetime string of when the customer granted their consent. `null` if not yet granted. - `voided_at`: string (date-time) | null (required) — RFC 3339 datetime string of when consent was voided or no longer required. `null` if not voided. - `meta`: object (required) — Information about this response. - `request_id`: string (required) — Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request. ### Response example ```json { "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" } } ```