Checkout Sessions

Quick Start

Create your first checkout session in under 5 minutes

API Reference

Full API documentation and interactive testing

Preview Endpoint

Calculate pricing and taxes before creating a session

Session Validity: Checkout sessions expire after 24 hours by default, or 15 minutes when confirm: true.

Single-Use Links: The checkout_url is not reusable. Generate a fresh session for each customer and payment attempt rather than sharing or reusing a link.

Prerequisites

You need:

An active Dodo Payments merchant account
API credentials from Developer → API Keys in the dashboard
At least one product created in Products

Creating Your First Checkout Session

Node.js SDK
Python SDK
REST API

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode',
});

async function createCheckoutSession() {
  const session = await client.checkoutSessions.create({
    product_cart: [
      {
        product_id: 'pdt_123',
        quantity: 1
      }
    ],
    customer: {
      email: 'customer@example.com',
      name: 'John Doe',
      phone_number: '+1234567890'
    },
    billing_address: {
      street: '123 Main St',
      city: 'San Francisco',
      state: 'CA',
      country: 'US',
      zipcode: '94102'
    },
    return_url: 'https://yoursite.com/checkout/success'
  });

  console.log('Checkout URL:', session.checkout_url);
  return session;
}

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

def create_checkout_session():
    session = client.checkout_sessions.create(
        product_cart=[
            {
                "product_id": "pdt_123",
                "quantity": 1
            }
        ],
        customer={
            "email": "customer@example.com",
            "name": "John Doe",
            "phone_number": "+1234567890"
        },
        billing_address={
            "street": "123 Main St",
            "city": "San Francisco",
            "state": "CA",
            "country": "US",
            "zipcode": "94102"
        },
        return_url="https://yoursite.com/checkout/success"
    )

    print(f"Checkout URL: {session.checkout_url}")
    return session

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1
      }
    ],
    "customer": {
      "email": "customer@example.com",
      "name": "John Doe",
      "phone_number": "+1234567890"
    },
    "billing_address": {
      "street": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "country": "US",
      "zipcode": "94102"
    },
    "return_url": "https://yoursite.com/checkout/success"
  }'

API Response

All methods return:

{
  "session_id": "cks_Gi6KGJ2zFJo9rq9Ukifwa",
  "checkout_url": "https://test.checkout.dodopayments.com/session/cks_Gi6KGJ2zFJo9rq9Ukifwa"
}

Only session_id is guaranteed to be present. When payment_method_id is provided, the charge processes immediately and checkout_url is null. Use the returned payment_id instead. When confirm: true, the payment is created at session-creation time, and the response also includes payment_id, client_secret, and publishable_key for use with the Dodo Payments checkout SDK.

Redirect Your Customer

Extract the checkout URL

Get checkout_url from the API response.

Redirect to checkout

Send your customer to the URL:

window.location.href = session.checkout_url;

Alternatively, open in a new window:

window.open(session.checkout_url, '_blank');

Handle the return

After payment, customers are redirected to your return_url with query parameters:

Parameter	Type	Condition
`payment_id`	string	Always present for one-time payments
`subscription_id`	string	Always present for subscriptions
`status`	string	Always present
`license_key`	string	Present if the product has license keys enabled. Comma-separated if multiple keys
`email`	string	Present if the customer has an email on record

Example redirect:

https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

Instead of redirecting, you can embed checkout directly in your page using Overlay Checkout (modal), Inline Checkout (embedded), or Mobile SDKs (native apps). All consume the same session URL.

Check Session Status

To check a session’s status, call Get Checkout Session (GET /checkouts/{id}). The response has the session id, created_at, customer_email, and customer_name, plus payment_id and payment_status. Both payment fields are null while the customer is still entering details. After the customer submits payment, payment_status holds the payment’s status, such as succeeded, failed, or processing. Use webhooks as the source of truth for fulfillment.

Request Body

Required Fields

array

requis

Array of products to include in the checkout session. Each product must have a valid product_id from your dashboard.You can combine one-time payment products and subscription products in the same session.

Afficher Product Cart Item Properties

string

requis

The unique identifier of the product from your dashboard.Example: "pdt_123abc456def"

integer

requis

Quantity of the product.Example: 1 for single item, 3 for multiple quantities

array

Array of addons to attach to the product. Only valid for subscription products.

Afficher Addon Item Properties

string

requis

The unique identifier of the addon.

integer

requis

Quantity of the addon.

integer

Amount the customer pays if pay-what-you-want is enabled on the product. Represented in the lowest denomination of the currency (e.g., cents for USD). For example, 100 = $1.00.Ignored if pay-what-you-want is disabled.

array

Per-session overrides for credit entitlements already attached to this product. Use this to grant a different number of credits for this single session without creating a separate product.Each credit_entitlement_id must already be attached to the product. This field overrides only the credits_amount granted when this session is fulfilled; product-level credit entitlement settings (expiration, rollover, etc.) still apply.

Afficher Credit Entitlement Override Properties

string

requis

ID of the credit entitlement to override. Must already be attached to the product.

string

requis

Number of credits to grant for this checkout session, overriding the product-level credits_amount. Must be greater than zero.

Find Your Product IDs: You can find product IDs in your Dodo Payments dashboard under Products → View Details, or by using the List Products API.

Optional Fields

Customer Information

object

Customer information. You can either attach an existing customer using their ID or create a new customer record during checkout.

Attach Existing Customer
Create New Customer

Afficher Existing Customer Properties

string

requis

The unique identifier of an existing customer.

Afficher New Customer Properties

string

requis

Customer’s email address.

string

Customer’s full name as it should appear on receipts and invoices.Example: "John Doe"

string

Customer’s phone number in international format. Required for some payment methods and fraud prevention.Format: Include country code, e.g., "+1234567890"

object

Billing address information for accurate tax calculation, fraud prevention, and regulatory compliance.When confirm: true, all billing address fields become required.

Afficher Billing Address Properties

string

Complete street address including house number, street name, and apartment/unit number if applicable.Example: "123 Main St, Apt 4B"

string

City or municipality name.Example: "San Francisco"

string

State, province, or region name. Use full names or standard abbreviations.Example: "California" or "CA"

string

requis

Two-letter ISO country code (ISO 3166-1 alpha-2). Always required when billing_address is provided.Examples: "US", "CA", "GB", "DE"

Country Code Reference

View complete list of supported countries and their ISO codes

string

Postal code, ZIP code, or equivalent based on country requirements.Examples: "94102" (US), "M5V 3A8" (Canada), "SW1A 1AA" (UK)

Payment Configuration

array

Control which payment methods are available to customers during checkout. This helps optimize for specific markets or business requirements.Common options: credit, debit, upi_collect, apple_pay, google_pay, amazon_pay, klarna, affirm, afterpay_clearpay, cashapp, ach, multibanco, bancontact_card, eps, ideal, blik, gcash, ali_pay_hk, fps, touch_n_go, paypalSee the Create Checkout Session API reference for the complete list.

Always include credit and debit as fallback options to prevent checkout failures when preferred payment methods are unavailable.

Example:

["apple_pay", "google_pay", "credit", "debit"]

string

Override the default currency selection with a fixed billing currency. Uses ISO 4217 currency codes.Supported Currencies: USD, EUR, GBP, CAD, AUD, INR, and moreExample: "USD" for US Dollars, "EUR" for EurosThis field is only effective when adaptive pricing is enabled. If adaptive pricing is disabled, the product’s default currency is used.

boolean

défaut:"false"

Display previously saved payment methods for returning customers, improving checkout speed and user experience.

Session Management

string

URL to redirect customers after payment completion. Dodo Payments appends query parameters to your URL on redirect (see the redirect table above).Example redirect URLs:

# One-time payment with license key
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

# Subscription payment with multiple license keys
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001,LK-002&email=customer%40example.com

# Payment without license keys
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&email=customer%40example.com

Use the license_key and email query parameters to display license keys or send a confirmation immediately on your return page, without needing an extra API call.

string

URL to redirect customers when they click the back button or cancel the checkout session. If not provided, the back button will not be displayed.Set a cancel_url to give customers a clear way to return to your site without completing the purchase.

boolean

défaut:"false"

If true, finalizes all session details immediately. The API throws an error if required data is missing.When confirm: true:

All billing address fields become required
payment_method_id can be provided to process the charge immediately
Session expires after 15 minutes instead of 24 hours
An existing customer_id is required if payment_method_id is provided

array

Apply one or more stacked discount codes to the checkout session. Codes are applied in array order (the first code reduces the starting price, the second reduces the already-discounted price, and so on), up to a maximum of 20 codes per session.When Purchasing Power Parity is enabled, the starting price is the PPP-adjusted amount, not the base price.

discount_codes: ['WELCOME10', 'BLACKFRIDAY20']

The singular discount_code field below is deprecated but still fully supported. It cannot be combined with discount_codes in the same request.

string

obsolète

Deprecated — prefer discount_codes for new integrations. This field still works for backward compatibility, but cannot be combined with discount_codes in the same request.

object

Custom key-value pairs to store additional information about the session.

boolean

Override merchant default 3DS behaviour for this session.

boolean

défaut:"false"

Enable minimal address collection mode. When enabled, the checkout only collects:

Country: Always required for tax determination
ZIP/Postal code: Only in regions where it’s necessary for sales tax, VAT, or GST calculation

This significantly reduces checkout friction by eliminating unnecessary form fields.

string

A saved payment method belonging to the attached customer. Requires confirm: true and an existing customer.customer_id. The payment method is validated for eligibility with the payment’s currency. When set, the charge is processed immediately and checkout_url is returned as null. Use the returned payment_id instead.

boolean

défaut:"false"

If true, returns a shortened checkout URL instead of the full session URL.

string

Product collection ID for the collection-based checkout flow. When you set it, pass an empty product_cart array. Discount codes can’t be pre-applied at session creation. See Product Collections.

string

Tax ID for the customer (for example, a VAT number). Requires billing_address with a country.

string

Optional business or legal name associated with the tax ID, up to 250 characters. When provided together with a valid tax_id, it is rendered on the invoice instead of the customer’s personal name.

integer

Override the merchant-level mandate floor (in INR paise) for INR e-mandates on Indian cards.The mandate amount sent to the processor is max(this_floor, actual_billing_amount), so this is effectively the customer-facing authorization ceiling whenever billing is lower. When unset, the merchant setting applies; when that’s also unset, the system default of ₹15,000 applies.

UI Customization

object

Customize the appearance and behavior of the checkout interface.

Afficher Customization Properties

string

Theme for the checkout interface. Options: light, dark, or system. If not provided, the checkout uses the theme configured for your business in the dashboard.

boolean

défaut:"true"

Display order details section in the checkout interface.

boolean

défaut:"true"

Show the “on-demand” tag for applicable products.

string

Force the checkout interface to render in a specific language. By default, the checkout auto-detects the customer’s browser language.Supported language codes: ar, ca, de, en, es, fr, he, id, it, ja, ka, ko, ms, nl, pl, pt, ro, ru, sv, th, tr, zhExample: "es" for Spanish, "ja" for Japanese

object

Custom theme configuration with colors for light and dark modes, fonts, and button styling. This is the server-side replacement for the deprecated client-side themeConfig option.

Afficher Theme Config Properties

object

Light mode color configuration.

object

Dark mode color configuration.

string

URL for the primary font. Must be a valid https:// URL.

string

URL for the secondary font. Must be a valid https:// URL.

string

Font size for the checkout UI. Options: xs, sm, md, lg, xl, 2xl.

string

Font weight for the checkout UI. Options: normal, medium, bold, extraBold.

string

Custom text for the pay button (for example, "Complete Purchase" or "Subscribe Now"). Max 100 characters.

string

Border radius for UI elements. A number followed by px, rem, or em (for example, "4px", "0.5rem", "1em").

Feature Flags

object

Configure specific features and behaviors for the checkout session.

Afficher Feature Flags Properties

boolean

défaut:"true"

Allow customers to select their preferred currency during checkout.

boolean

défaut:"true"

Show discount code input field in the checkout interface.

boolean

défaut:"false"

Allow customers to add or remove addons on a subscription product during checkout. Only applies to subscription products.

boolean

défaut:"true"

Collect customer phone numbers during checkout.

boolean

défaut:"false"

Require the customer to provide a phone number to complete checkout. Requires allow_phone_number_collection to also be true.

boolean

défaut:"true"

Allow customers to enter tax identification numbers.

boolean

défaut:"false"

Require the customer to provide a Tax ID (GST number in India, VAT number in the EU) before they can complete checkout.When enabled, Purchasing as a business is pre-selected and locked on the checkout page, and both Business Name and Tax ID Number become mandatory. See B2B Payments for the full checkout behavior.allow_tax_id must also be true. Otherwise, the request is rejected with a 400 and the message feature_flags.require_tax_id: cannot be true when allow_tax_id is false. With confirm: true, the request must include a non-blank tax_id, or it is rejected with a 422.

boolean

défaut:"false"

Force creation of a new customer record instead of updating existing ones.

boolean

Allow customers to edit their email address during checkout.

boolean

Allow customers to edit their name during checkout.

boolean

Allow customers to edit the street address during checkout.

boolean

Allow customers to edit the city during checkout.

boolean

Allow customers to edit the state during checkout.

boolean

Allow customers to edit the country during checkout.

boolean

Allow customers to edit the zipcode during checkout.

boolean

Allow customers to enter or edit their tax ID during checkout.

boolean

défaut:"false"

Allow the customer to supply or edit the business name associated with the tax ID. Works independently of allow_customer_editing_tax_id: either flag (or allow_tax_id) is sufficient to let the customer override the session’s business name. Typically set together with allow_customer_editing_tax_id.

boolean

défaut:"false"

Skip the default payment success page and redirect customers immediately to your return_url after payment completion.Use this when you have a custom success page that provides a better user experience, or for mobile apps and embedded checkout flows.

boolean

défaut:"false"

If true, the session uses the single-page checkout flow: the page initializes the payment at load time and confirms it in place, with no separate payment page.

Custom Fields

array

Collect additional information from customers during checkout with custom form fields. You can define up to 5 custom fields per checkout session. Customer responses are included in webhook payloads and available via the API.

Afficher Custom Field Properties

string

requis

Unique identifier for this field. Used as the key in webhook payloads and API responses.Example: "company_name", "referral_source", "team_size"

string

requis

Display label shown to the customer on the checkout form.Example: "Company Name", "How did you hear about us?", "Team Size"

string

requis

Type of field determining input validation rules.Available types: text, number, email, url, date, dropdown, boolean

boolean

défaut:"false"

Whether this field must be filled before checkout can complete.

string

Placeholder text displayed in the input field.

array

List of options for dropdown field type. Required when field_type is dropdown, ignored for other types.Example: ["Google", "Twitter", "Friend referral", "Other"]

Customer responses to custom fields are included in:

Webhooks: payment.succeeded, subscription.active, and other relevant event payloads contain the custom_field_responses array
API responses: Payment and subscription objects include custom_field_responses

Subscription Configuration

object

Additional configuration for checkout sessions containing subscription products.

Afficher Subscription Data Properties

integer

Number of days for the trial period before the first charge. Must be between 0 and 10000 days.A paid trial amount cannot be set per session. Configure trial_amount on the product’s recurring price instead. See Paid Trials.

object

On-demand subscription configuration for usage-based or metered billing.

Afficher On-Demand Properties

boolean

requis

If set to true, does not perform any charge and only authorizes payment method details for future use.

integer

Product price for the initial charge to customer. If not specified, the stored price of the product is used.Format: Represented in the lowest denomination of the currency (e.g., cents for USD). For example, 100 = $1.00.

string

Optional currency of the product price. If not specified, defaults to the currency of the product.

string

Optional product description override for billing and line items. If not specified, the stored description of the product is used.

boolean

Whether adaptive currency fees should be included in the product price (true) or added on top (false). Ignored if adaptive pricing is not enabled.

Usage Examples

Simple Single Product Checkout

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_ebook_guide',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  return_url: 'https://yoursite.com/success'
});

Multi-Product Cart

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_course_advanced',
      quantity: 1
    },
    {
      product_id: 'pdt_certificate',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Smith'
  },
  return_url: 'https://yoursite.com/success'
});

Subscription with Trial Period

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_saas_pro',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  subscription_data: {
    trial_period_days: 14
  },
  return_url: 'https://yoursite.com/success'
});

Pre-Confirmed Checkout

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    customer_id: 'cus_existing_customer_id'
  },
  billing_address: {
    street: '123 Main St',
    city: 'San Francisco',
    state: 'CA',
    country: 'US',
    zipcode: '94102'
  },
  confirm: true,
  return_url: 'https://yoursite.com/success'
});

Checkout with Currency Override

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  billing_currency: 'EUR',
  return_url: 'https://yoursite.com/success'
});

Saved Payment Methods for Returning Customers

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    customer_id: 'cus_existing_customer_id'
  },
  show_saved_payment_methods: true,
  return_url: 'https://yoursite.com/success'
});

B2B Checkout with Tax ID Collection

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_enterprise_plan',
      quantity: 1
    }
  ],
  customer: {
    email: 'procurement@company.com',
    name: 'Jane Smith'
  },
  billing_address: {
    street: '456 Business Ave',
    city: 'London',
    country: 'GB',
    zipcode: 'SW1A 1AA'
  },
  feature_flags: {
    require_tax_id: true
  },
  return_url: 'https://yoursite.com/success'
});

Dark Theme Checkout with Stacked Discount Codes

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  customization: {
    theme: 'dark'
  },
  discount_codes: ['WELCOME10', 'BLACKFRIDAY20'],
  return_url: 'https://yoursite.com/success'
});

Regional Payment Methods (UPI for India)

For detailed information about UPI configuration and testing, see the India Payment Methods page.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  billing_address: {
    street: '123 Main St',
    city: 'Bangalore',
    state: 'KA',
    country: 'IN',
    zipcode: '560001'
  },
  billing_currency: 'INR',
  allowed_payment_method_types: ['upi_intent', 'credit', 'debit'],
  return_url: 'https://yoursite.com/success'
});

BNPL (Buy Now Pay Later) Checkout

For detailed information about BNPL configuration and testing, see the Buy Now Pay Later (BNPL) page.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  allowed_payment_method_types: ['klarna', 'affirm', 'afterpay_clearpay', 'credit', 'debit'],
  return_url: 'https://yoursite.com/success'
});

Instant Checkout with Existing Payment Method

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    customer_id: 'cus_existing_customer_id'
  },
  payment_method_id: 'pm_existing_payment_method_id',
  confirm: true,
  return_url: 'https://yoursite.com/success'
});

Short Links for Cleaner Payment URLs

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  short_link: true,
  return_url: 'https://yoursite.com/success'
});

Skip Payment Success Page with Immediate Redirect

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  feature_flags: {
    redirect_immediately: true
  },
  return_url: 'https://yoursite.com/success'
});

Forcing a Language

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  customization: {
    force_language: 'es'
  },
  return_url: 'https://yoursite.com/success'
});

Collecting Custom Fields

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'referral_source',
      label: 'How did you hear about us?',
      field_type: 'dropdown',
      options: ['Google', 'Twitter', 'Friend referral', 'Other'],
      required: true
    }
  ],
  return_url: 'https://yoursite.com/success'
});

Previewing Checkout Sessions

Use the Preview Checkout Session endpoint to calculate pricing, taxes, and totals before creating a session. This is useful for displaying accurate pricing information on your site.

The previewed current_breakup.subtotal already reflects Purchasing Power Parity and Charm Pricing where they apply to the product.

When the cart contains a subscription product, the preview response also returns a next_billing_date — a preview of the upcoming billing date, so you can show it before the subscription is created. It is computed relative to now: now + trial period when a trial applies, otherwise now + one payment frequency. The field is omitted for one-time-only carts. This is an estimate anchored on the preview time; the authoritative next_billing_date is set when the subscription activates.

The preview also returns trial_period_days (the effective trial length, free or paid) and trial_amount (the per-unit trial charge after discounts, in the price currency’s minor units). trial_amount is only present for a paid trial and is null for a free trial or no trial. Use current_breakup for the taxed total actually due today.

Node.js SDK
Python SDK
REST API

const preview = await client.checkoutSessions.preview({
  product_cart: [
    { product_id: 'pdt_123', quantity: 1 }
  ],
  billing_address: {
    country: 'US',
    state: 'CA',
    zipcode: '94102'
  },
  discount_codes: ['SAVE20']
});

console.log('Subtotal:', preview.current_breakup.subtotal);
console.log('Tax:', preview.current_breakup.tax);
console.log('Discount:', preview.current_breakup.discount);
console.log('Total:', preview.current_breakup.total_amount);

// Present only when the cart contains a subscription product
console.log('Next billing date:', preview.next_billing_date);

preview = client.checkout_sessions.preview(
    product_cart=[
        {"product_id": "pdt_123", "quantity": 1}
    ],
    billing_address={
        "country": "US",
        "state": "CA",
        "zipcode": "94102"
    },
    discount_codes=["SAVE20"]
)

print(f"Subtotal: {preview.current_breakup.subtotal}")
print(f"Tax: {preview.current_breakup.tax}")
print(f"Discount: {preview.current_breakup.discount}")
print(f"Total: {preview.current_breakup.total_amount}")

# Present only when the cart contains a subscription product
print(f"Next billing date: {preview.next_billing_date}")

curl -X POST https://test.dodopayments.com/checkouts/preview \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1
      }
    ],
    "billing_address": {
      "country": "US",
      "state": "CA",
      "zipcode": "94102"
    },
    "discount_codes": ["SAVE20"]
  }'

Migrating from Dynamic Links

If you’re using Dynamic Links, Checkout Sessions offer more flexibility. With Dynamic Links, you had to provide the customer’s complete billing address. With Checkout Sessions, you can pass whatever information you have, and the checkout flow collects the rest. For example:

Provide only the customer’s billing country, and checkout collects the remaining details.
Or provide all information and set confirm: true to skip directly to the payment page.

Migrating is straightforward: update your integration to use the Checkout Sessions API or SDK method, adjust the request payload to match the Checkout Sessions format, and you’re done. No additional handling is needed.

Overlay Checkout

Open checkout as a modal overlay on your page

Inline Checkout

Embed checkout directly in your page

Mobile Integration

Integrate checkout in native mobile apps

Webhooks

Listen for payment and subscription events

Payment Methods

Supported payment methods by region

Subscriptions

Recurring billing and subscription management

Integration Guides

Billing Deconstructions

Cookbooks

Quick Start

API Reference

Preview Endpoint

Prerequisites

Creating Your First Checkout Session

API Response

Redirect Your Customer

Check Session Status

Request Body

Required Fields

Optional Fields

Country Code Reference

Usage Examples

Simple Single Product Checkout

Multi-Product Cart

Subscription with Trial Period

Pre-Confirmed Checkout

Checkout with Currency Override

Saved Payment Methods for Returning Customers

B2B Checkout with Tax ID Collection

Dark Theme Checkout with Stacked Discount Codes

Regional Payment Methods (UPI for India)

BNPL (Buy Now Pay Later) Checkout

Instant Checkout with Existing Payment Method

Short Links for Cleaner Payment URLs

Skip Payment Success Page with Immediate Redirect

Forcing a Language

Collecting Custom Fields

Previewing Checkout Sessions

Migrating from Dynamic Links

Overlay Checkout

Inline Checkout

Mobile Integration

Webhooks

Payment Methods

Subscriptions

Quick Start

API Reference

Preview Endpoint

​Prerequisites

​Creating Your First Checkout Session

​API Response

​Redirect Your Customer

​Check Session Status

​Request Body

​Required Fields

​Optional Fields

Country Code Reference

​Usage Examples

​Simple Single Product Checkout

​Multi-Product Cart

​Subscription with Trial Period

​Pre-Confirmed Checkout

​Checkout with Currency Override

​Saved Payment Methods for Returning Customers

​B2B Checkout with Tax ID Collection

​Dark Theme Checkout with Stacked Discount Codes

​Regional Payment Methods (UPI for India)

​BNPL (Buy Now Pay Later) Checkout

​Instant Checkout with Existing Payment Method

​Short Links for Cleaner Payment URLs

​Skip Payment Success Page with Immediate Redirect

​Forcing a Language

​Collecting Custom Fields

​Previewing Checkout Sessions

​Migrating from Dynamic Links

​Related Resources

Overlay Checkout

Inline Checkout

Mobile Integration

Webhooks

Payment Methods

Subscriptions

Prerequisites

Creating Your First Checkout Session

API Response

Redirect Your Customer

Check Session Status

Request Body

Required Fields

Optional Fields

Usage Examples

Simple Single Product Checkout

Multi-Product Cart

Subscription with Trial Period

Pre-Confirmed Checkout

Checkout with Currency Override

Saved Payment Methods for Returning Customers

B2B Checkout with Tax ID Collection

Dark Theme Checkout with Stacked Discount Codes

Regional Payment Methods (UPI for India)

BNPL (Buy Now Pay Later) Checkout

Instant Checkout with Existing Payment Method

Short Links for Cleaner Payment URLs

Skip Payment Success Page with Immediate Redirect

Forcing a Language

Collecting Custom Fields

Previewing Checkout Sessions

Migrating from Dynamic Links

Related Resources