---
title: "Changes to Preview a transaction"
method: POST
path: "/transactions/preview"
---

# Changes to Preview a transaction

`POST /transactions/preview`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 10 breaking, 19 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 8 warning, 44 info
- **2026-02-02** (v1) `9ba8be0f2006`: 12 breaking, 14 warning, 62 info
- **2025-05-27** (v1) `e57c515077cc`: 1 warning
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 16 info
- **2025-03-07** (v1) `a3359d7731fd`: 10 breaking, 2 info
- **2025-02-03** (v1) `50bbef23e6a1`: 1 info
- **2024-12-19** (v1) `6be8d2a4c7e1`: 3 breaking, 1 info
- **2024-12-06** (v1) `274e5b2be190`: 13 breaking, 4 warning, 463 info
- **2024-08-06** (v1) `968e505782d4`: 5 info
- **2024-07-05** (v1) `8f7044f788af`: 6 breaking, 6 warning
- **2024-05-14** (v1) `61fe84bfd516`: 14 breaking, 17 info
- **2024-02-19** (v1) `a4a4068ff792`: 24 breaking, 14 warning, 8 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 10 breaking, 19 info
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/address/anyOf[subschema #1: AddressPreview]/country_code/allOf[#/components/schemas/CountryCode]/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/items/price/allOf[subschema #1: Price preview]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #2: Country and ZIP/postal code]/address/allOf[subschema #1: AddressPreview]/country_code/allOf[#/components/schemas/CountryCode]/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/PriceTrialDuration` to the `data/items/items/price/allOf[subschema #1: Price preview]/trial_period` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Duration` from the `data/items/items/price/allOf[subschema #1: Price preview]/trial_period` response property `anyOf` list for the response status `200`
- **2026-07-09** (v1) `e1ac347eb3c5`: 8 warning, 44 info
  - added the new `CLP` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `CLP` enum value to the `data/details/allOf[subschema #1: Transaction details (preview)]/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price preview]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price preview]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `PEN` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `PEN` enum value to the `data/details/allOf[subschema #1: Transaction details (preview)]/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price preview]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price preview]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new optional request property `anyOf[subschema #1: No location information]/discount`
  - added the new optional request property `anyOf[subschema #2: Country and ZIP/postal code]/discount`
  - added the new optional request property `anyOf[subschema #3: IP address]/discount`
  - added the new optional request property `anyOf[subschema #4: Existing customer Paddle IDs]/discount`
  - added the new `CLP` enum value to the request property `anyOf[subschema #1: No location information]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `CLP` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `CLP` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #3: IP address]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `CLP` enum value to the request property `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #3: IP address]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #4: Existing customer Paddle IDs]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `CLP` enum value to the request property `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `anyOf[subschema #4: Existing customer Paddle IDs]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #1: No location information]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `PEN` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/currency_code/anyOf[subschema #1: Currency code]/`
  - added the new `PEN` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `anyOf[subschema #2: Country and ZIP/postal code]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - …12 more
- **2026-02-02** (v1) `9ba8be0f2006`: 12 breaking, 14 warning, 62 info
  - removed `#/components/schemas/transaction-preview-create, #/components/schemas/transaction-preview-create-address, #/components/schemas/transaction-preview-create-ip-address, #/components/schemas/transaction-preview-create-paddle-ids` from the request body `anyOf` list
  - request body became required
  - response property `data/customer_ip_address` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/currency_code` response property's maxLength was unset from `3` for the response status `200`
  - the `data/currency_code` response property's minLength was decreased from `3` to `0` for the response status `200`
  - the `data/currency_code` response's property type changed from `string` to no type for status `200`
  - the `data/details` response's property type changed from `object` to no type for status `200`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `error/code` from the response with the `default` status
  - removed the required property `error/detail` from the response with the `default` status
  - removed the required property `error/documentation_url` from the response with the `default` status
  - removed the required property `error/type` from the response with the `default` status
  - removed the optional property `data/details/line_items` from the response with the `200` status
  - removed the optional property `data/details/tax_rates_used` from the response with the `200` status
  - removed the optional property `data/details/totals` from the response with the `200` status
  - removed the optional property `error/errors` from the response with the `default` status
  - added the new `blik` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `kakao_pay` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `mb_way` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `naver_pay` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `payco` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `pix` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `samsung_pay` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `south_korea_local_card` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `upi` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added the new `wechat_pay` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
  - added `#/components/schemas/TransactionPreviewCreateWithoutAddress, #/components/schemas/TransactionPreviewCreateAddress, #/components/schemas/TransactionPreviewCreateIpAddress, #/components/schemas/TransactionPreviewCreatePaddleIds` to the request body `anyOf` list
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - added `#/components/schemas/CurrencyCode` to the `data/currency_code` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TransactionPreviewDetails` to the `data/details` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/transaction_preview_item_base, subschema #2` from the `data/items/items/` response property `allOf` list for the response status `200`
  - added `#/components/schemas/AddressId, subschema #2` to the `data/address_id` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/AddressPreview, subschema #2` to the `data/address` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/BusinessId, subschema #2` to the `data/business_id` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/CustomerId, subschema #2` to the `data/customer_id` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/DiscountId, subschema #2` to the `data/discount_id` response property `anyOf` list for the response status `200`
  - the response property `data/address` became required for the status `200`
  - the response property `data/address_id` became required for the status `200`
  - the response property `data/available_payment_methods` became required for the status `200`
  - the response property `data/business_id` became required for the status `200`
  - …48 more
- **2025-05-27** (v1) `e57c515077cc`: 1 warning
  - added the new `korea_local` enum value to the `data/available_payment_methods/items/` response property for the response status `200`
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 16 info
  - the `data/items/items/allOf[subschema #2]/price/description` response property's maxLength was increased from `200` to `500` for the response status `200`
  - the `data/items/items/allOf[subschema #2]/price/name` response property's maxLength was increased from `50` to `150` for the response status `200`
  - the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #1: No location information]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #2: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #2: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #2: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #2: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #3: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #3: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #3: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #3: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
- **2025-03-07** (v1) `a3359d7731fd`: 10 breaking, 2 info
  - the `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - added `#/components/schemas/external_id, subschema #2` to the `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/external_id, subschema #2` to the `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/migration_provider_public` to the `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/migration_provider_public` to the `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - the `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - the `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - the response required property `data/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
  - the response required property `data/items/items/allOf[subschema #2]/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
- **2025-02-03** (v1) `50bbef23e6a1`: 1 info
  - added the optional property `data/details/line_items/items/proration` to the response with the `200` status
- **2024-12-19** (v1) `6be8d2a4c7e1`: 3 breaking, 1 info
  - the request property `anyOf[subschema #2: Country and ZIP/postal code]/allOf[subschema #1]/address` became required
  - the request property `anyOf[subschema #3: IP address]/allOf[subschema #1]/customer_ip_address` became required
  - the request property `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #1]/address_id` became required
  - the request property `anyOf[subschema #4: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/customer_id` became optional
- **2024-12-06** (v1) `274e5b2be190`: 13 breaking, 4 warning, 463 info
  - removed `#/components/schemas/transaction-preview-create-address, #/components/schemas/transaction-preview-create-ip-address, #/components/schemas/transaction-preview-create-paddle-ids` from the request body `oneOf` list
  - added `#/components/schemas/country_code_supported` to the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/country_code_supported` to the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/price_id, subschema #2` to the `data/details/line_items/items/price_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/price_id, subschema #2` to the `data/items/items/allOf[subschema #2]/price/id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/product_id, subschema #2` to the `data/details/line_items/items/product/id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/product_id, subschema #2` to the `data/items/items/allOf[subschema #2]/price/product_id` response property `oneOf` list for the response status `200`
  - the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response's property type changed from `string` to no type for status `200`
  - the `data/details/line_items/items/price_id` response's property type changed from `string` to no type for status `200`
  - the `data/details/line_items/items/product/id` response's property type changed from `string` to no type for status `200`
  - the `data/items/items/allOf[subschema #2]/price/id` response's property type changed from `string` to no type for status `200`
  - the `data/items/items/allOf[subschema #2]/price/product_id` response's property type changed from `string` to no type for status `200`
  - the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response's property type changed from `string` to no type for status `200`
  - added the new `VND` enum value to the `data/currency_code` response property for the response status `200`
  - added the new `VND` enum value to the `data/details/totals/allOf[subschema #2]/currency_code` response property for the response status `200`
  - added the new `VND` enum value to the `data/items/items/allOf[subschema #2]/price/unit_price/currency_code` response property for the response status `200`
  - added the new `VND` enum value to the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/unit_price/currency_code` response property for the response status `200`
  - added `#/components/schemas/transaction-preview-create, #/components/schemas/transaction-preview-create-address, #/components/schemas/transaction-preview-create-ip-address, #/components/schemas/transaction-preview-create-paddle-ids` to the request body `anyOf` list
  - removed the `AD` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AD` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AE` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AE` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AG` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AG` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AI` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AI` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AL` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AL` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AM` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AM` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AO` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AO` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AR` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AR` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AS` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AS` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AT` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AT` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AU` enum value from the `data/address/oneOf[subschema #1: AddressPreview]/country_code` response property for the response status `200`
  - removed the `AU` enum value from the `data/items/items/allOf[subschema #2]/price/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - …440 more
- **2024-08-06** (v1) `968e505782d4`: 5 info
  - api operation id `preview-transaction` removed and replaced with `preview-transaction-create`
  - the response optional property `data/details/line_items/items/unit_totals/discount` became read-only for the status `200`
  - the response optional property `data/details/line_items/items/unit_totals/subtotal` became read-only for the status `200`
  - the response optional property `data/details/line_items/items/unit_totals/tax` became read-only for the status `200`
  - the response optional property `data/details/line_items/items/unit_totals/total` became read-only for the status `200`
- **2024-07-05** (v1) `8f7044f788af`: 6 breaking, 6 warning
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #1: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #1: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #2: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #2: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #3: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - added `#/components/schemas/transaction-price-create-base` to the `oneOf[subschema #3: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #1: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #1: Country and ZIP/postal code]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #2: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #2: IP address]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #3: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #2: Non-catalog price for an existing product]/allOf[subschema #2]/price` request property `allOf` list
  - removed `#/components/schemas/transaction-subscription-price-create-base` from the `oneOf[subschema #3: Existing customer Paddle IDs]/allOf[subschema #2: TransactionPreviewCreate]/items/items/oneOf[subschema #3: Non-catalog price and product]/allOf[subschema #2]/price` request property `allOf` list
- …earlier changes are on the page: https://skmtc.dev/paddlehq/apis/paddle-api/changes/transactions/preview/post

---

[Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/transactions/preview/post.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/transactions/preview/post)
