Account2

Addresses4

Adjustments3

API root1

Businesses4

Checkout domains4

Client tokens4

Countries1

Currencies1

Customer portals1

Customers6

Discount groups4

Discounts4

Event types1

Events1

IP addresses1

Metrics9

Notification logs1

Notification settings5

Notifications3

Payment methods3

Prices4

Pricing preview1

Products4

Reports4

Settings18

Simulation run events3

Simulation runs3

Simulation types1

Simulations4

Subscription history1

Subscriptions11

Transactions7

Verifications2

Webhooks

Addresses3

Adjustments2

API keys6

Businesses3

Client tokens3

Customers3

Discount groups2

Discounts3

Payment methods2

Payouts2

Prices3

Products3

Reports2

Subscriptions9

Transactions10

Transactions

Preview a transaction

Changed on Oct 19, 2026

Previews a transaction without creating a transaction entity. Typically used for creating more advanced, dynamic pricing pages where users can build their own plans.

Consider using the preview prices operation for simpler pricing pages.

You can provide location information when previewing a transaction. You must provide this if you want Paddle to calculate tax or automatically localize prices. You can provide one of:

customer_ip_address: Paddle fetches location using the IP address to calculate totals.
address: Paddle uses the country and ZIP code (where supplied) to calculate totals.
customer_id, address_id, business_id: Paddle uses existing customer data to calculate totals. Typically used for logged-in customers.

When supplying items, you can exclude items from the total calculation using the include_in_totals boolean.

By default, recurring items with trials are considered to have a zero charge when previewing. Set ignore_trials to true to ignore trial periods against prices for transaction preview calculations.

If successful, your response includes the data you sent with a details object that includes totals for the supplied prices.

Transaction previews don't create transactions, so no id is returned.

post/transactions/preview

Request

Base URL
https://sandbox-api.paddle.com
Auth
HTTP bearer

Request body

Example request

{
  "customer_id": "ctm_01grnn4zta5a1mf02jjze7y2ys",
  "discount_id": "dsc_01gv5kpg05xp104ek2fmgjwttf",
  "discount": {
    "custom_data": {
      "customer_reference_id": "abcd1234"
    }
  },
  "items": [
    {
      "proration": {
        "billing_period": {
          "starts_at": "2024-10-12T07:20:50.52Z",
          "ends_at": "2024-10-12T07:20:50.52Z"
        }
      },
      "price_id": "pri_01gsz8z1q1n00f12qt82y31smh"
    }
  ]
}

Response

The request has succeeded.

Changes

Oct 19, 2026v14f35a8c6ea4d Revision changes
- breaking
  removed from the ////// request property anyOf list
- breaking
  removed from the ////// request property anyOf list
- breaking
  removed from the /////// request property anyOf list
- breaking
  removed from the /////// request property anyOf list
- breaking
  removed from the ////// request property anyOf list
- breaking
  removed from the ////// request property anyOf list
- breaking
  removed from the ////// request property anyOf list
- breaking
  removed from the ////// request property anyOf list
- breaking
  added to the /////// response property oneOf list for the response status
- breaking
  added to the //////// response property oneOf list for the response status
- info
  added to the ////// request property anyOf list
- info
  added to the ////// request property anyOf list
- info
  added to the /////// request property anyOf list
- info
  added to the /////// request property anyOf list
- info
  added to the ////// request property anyOf list
- info
  added to the ////// request property anyOf list
- info
  added to the ////// request property anyOf list
- info
  added to the ////// request property anyOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the //////// request property oneOf list
- info
  added to the ////////// request property oneOf list
- info
  added to the ////////// request property oneOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the ///////// request property oneOf list
- info
  added to the ///// response property anyOf list for the response status
- info
  removed from the ///// response property anyOf list for the response status
Jul 9, 2026v1e1ac347eb3c5 Revision changes
- warning
  added the new CLP enum value to the // response property for the response status
- warning
  added the new CLP enum value to the ///////// response property for the response status
- warning
  added the new CLP enum value to the /////// response property for the response status
- warning
  added the new CLP enum value to the ///////// response property for the response status
- warning
  added the new PEN enum value to the // response property for the response status
- warning
  added the new PEN enum value to the ///////// response property for the response status
- warning
  added the new PEN enum value to the /////// response property for the response status
- warning
  added the new PEN enum value to the ///////// response property for the response status
- info
  added the new optional request property /
- info
  added the new optional request property //
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new CLP enum value to the request property //
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new CLP enum value to the request property ///
- info
  added the new CLP enum value to the request property /////////
- info
  added the new CLP enum value to the request property ///////////
- info
  added the new CLP enum value to the request property /////////
- info
  added the new CLP enum value to the request property ///////////
- info
  added the new CLP enum value to the request property //
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new CLP enum value to the request property //
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new CLP enum value to the request property ////////
- info
  added the new CLP enum value to the request property //////////
- info
  added the new PEN enum value to the request property //
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////
- info
  added the new PEN enum value to the request property ///
- info
  added the new PEN enum value to the request property /////////
- info
  added the new PEN enum value to the request property ///////////
- info
  added the new PEN enum value to the request property /////////
- info
  added the new PEN enum value to the request property ///////////
- info
  added the new PEN enum value to the request property //
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////
- info
  added the new PEN enum value to the request property //
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////
- info
  added the new PEN enum value to the request property ////////
- info
  added the new PEN enum value to the request property //////////

Operation history (13 revisions)