Checkout Sessions

Quick Start Guide

Get your first checkout session running in under 5 minutes

API Reference & Live Testing

Explore the full API documentation and interactively test Checkout Session requests and responses.

Preview Checkout

Calculate pricing, taxes, and totals before creating a session.

Session Validity: Checkout sessions are valid for 24 hours by default. If you pass confirm=true in your request, the session will only be valid for 15 minutes.

Engångslänkar: checkout_url som returneras av API:et kan inte återanvändas och upphör att gälla inom 24 timmar (eller 15 minuter när confirm=true). Den är avsedd för att en enskild kund ska slutföra en betalning. Generera en ny checkout-session för varje kund och varje betalningsförsök i stället för att dela eller återanvända en länk.

Förutsättningar

Dodo Payments Account

Du behöver ett aktivt Merchant-konto hos Dodo Payments med API-åtkomst.

API Credentials

Generera dina API-autentiseringsuppgifter från Dodo Payments-dashboarden:

Products Setup

Skapa dina produkter i Dodo Payments-dashboarden innan du implementerar checkout-sessioner.

Skapa din första checkout-session

Node.js SDK
Python SDK
REST API

import DodoPayments from 'dodopayments';

// Initialize the Dodo Payments client
const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode', // defaults to 'live_mode'
});

async function createCheckoutSession() {
  try {
    const session = await client.checkoutSessions.create({
      // Products to sell - use IDs from your Dodo Payments dashboard
      product_cart: [
        {
          product_id: 'prod_123', // Replace with your actual product ID
          quantity: 1
        }
      ],
      
      // Pre-fill customer information to reduce friction
      customer: {
        email: 'customer@example.com',
        name: 'John Doe',
        phone_number: '+1234567890'
      },
      
      // Billing address for tax calculation and compliance
      billing_address: {
        street: '123 Main St',
        city: 'San Francisco',
        state: 'CA',
        country: 'US', // Required: ISO 3166-1 alpha-2 country code
        zipcode: '94102'
      },
      
      // Where to redirect after successful payment
      return_url: 'https://yoursite.com/checkout/success',
      
      // Custom data for your internal tracking
      metadata: {
        order_id: 'order_123',
        source: 'web_app'
      }
    });

    // Redirect your customer to this URL to complete payment
    console.log('Checkout URL:', session.checkout_url);
    console.log('Session ID:', session.session_id);
    
    return session;
    
  } catch (error) {
    console.error('Failed to create checkout session:', error);
    throw error;
  }
}

// Example usage in an Express.js route
app.post('/create-checkout', async (req, res) => {
  try {
    const session = await createCheckoutSession();
    res.json({ checkout_url: session.checkout_url });
  } catch (error) {
    res.status(500).json({ error: 'Failed to create checkout session' });
  }
});

import os
from dodopayments import DodoPayments

# Initialize the Dodo Payments client
client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
    environment="test_mode",  # defaults to "live_mode"
)

def create_checkout_session():
    """
    Create a checkout session for a single product with customer data pre-filled.
    Returns the session object containing checkout_url for customer redirection.
    """
    try:
        session = client.checkout_sessions.create(
            # Products to sell - use IDs from your Dodo Payments dashboard
            product_cart=[
                {
                    "product_id": "prod_123",  # Replace with your actual product ID
                    "quantity": 1
                }
            ],
            
            # Pre-fill customer information to reduce checkout friction
            customer={
                "email": "customer@example.com",
                "name": "John Doe",
                "phone_number": "+1234567890"
            },
            
            # Billing address for tax calculation and compliance
            billing_address={
                "street": "123 Main St",
                "city": "San Francisco", 
                "state": "CA",
                "country": "US",  # Required: ISO 3166-1 alpha-2 country code
                "zipcode": "94102"
            },
            
            # Where to redirect after successful payment
            return_url="https://yoursite.com/checkout/success",
            
            # Custom data for your internal tracking
            metadata={
                "order_id": "order_123",
                "source": "web_app"
            }
        )
        
        # Redirect your customer to this URL to complete payment
        print(f"Checkout URL: {session.checkout_url}")
        print(f"Session ID: {session.session_id}")
        
        return session
        
    except Exception as error:
        print(f"Failed to create checkout session: {error}")
        raise error

# Example usage in a Flask route
from flask import Flask, jsonify, request

app = Flask(__name__)

@app.route('/create-checkout', methods=['POST'])
def create_checkout():
    try:
        session = create_checkout_session()
        return jsonify({"checkout_url": session.checkout_url})
    except Exception as error:
        return jsonify({"error": "Failed to create checkout session"}), 500

// Direct API call using fetch - useful for any JavaScript environment
async function createCheckoutSession() {
  try {
    const response = await fetch('https://test.dodopayments.com/checkouts', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`
      },
      body: JSON.stringify({
        // Products to sell - use IDs from your Dodo Payments dashboard
        product_cart: [
          {
            product_id: 'prod_123', // Replace with your actual product ID
            quantity: 1
          }
        ],
        
        // Pre-fill customer information to reduce checkout friction
        customer: {
          email: 'customer@example.com',
          name: 'John Doe',
          phone_number: '+1234567890'
        },
        
        // Billing address for tax calculation and compliance
        billing_address: {
          street: '123 Main St',
          city: 'San Francisco',
          state: 'CA', 
          country: 'US', // Required: ISO 3166-1 alpha-2 country code
          zipcode: '94102'
        },
        
        // Where to redirect after successful payment
        return_url: 'https://yoursite.com/checkout/success',
        
        // Custom data for your internal tracking
        metadata: {
          order_id: 'order_123',
          source: 'web_app'
        }
      })
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const session = await response.json();
    
    // Redirect your customer to this URL to complete payment
    console.log('Checkout URL:', session.checkout_url);
    console.log('Session ID:', session.session_id);
    
    return session;
    
  } catch (error) {
    console.error('Failed to create checkout session:', error);
    throw error;
  }
}

// Example: Redirect user to checkout
createCheckoutSession().then(session => {
  window.location.href = session.checkout_url;
});

API-svar

Alla metoder ovan returnerar samma svarsstruktur:

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

Den genererade checkout_url kan endast användas en gång och upphör att gälla inom 24 timmar. Cachelagra eller återanvänd den inte mellan kunder eller betalningsförsök — skapa en ny checkout-session när du behöver en ny länk.

Get the checkout URL

Hämta checkout_url från API-svaret.

Redirect your customer

Skicka kunden till checkout-URL:en för att slutföra köpet.

// Redirect immediately
window.location.href = session.checkout_url;

// Or open in new window
window.open(session.checkout_url, '_blank');

Alternativa integrationsalternativ: I stället för att omdirigera kan du bädda in checkout direkt på din sida med Overlay Checkout (modal överlagring) eller Inline Checkout (fullständigt inbäddad). I en inbyggd mobilapp skickar du samma URL till Mobile Checkout SDKs för Android, iOS, React Native eller Flutter. Alla dessa använder samma checkout-session-URL.

Handle the return

Efter betalningen omdirigeras kunderna till din return_url med query-parametrar som bland annat innehåller betalnings-/prenumerations-ID, status, kundens e-postadress och eventuella licensnycklar. Se dokumentationen för parametrarna för return_url för den fullständiga listan.

Request Body

Required Fields

Obligatoriska fält som behövs för varje checkout-session

Optional Fields

Ytterligare konfiguration för att anpassa din checkout-upplevelse

Obligatoriska fält

array

obligatorisk

Array med produkter som ska ingå i checkout-sessionen. Varje produkt måste ha ett giltigt product_id från din Dodo Payments-dashboard.

Blandad checkout: Du kan kombinera engångsbetalningsprodukter och prenumerationsprodukter i samma checkout-session. Detta möjliggör användningsfall som startavgifter tillsammans med prenumerationer, hårdvarupaket med SaaS och mycket mer.

Visa Product Cart Item Properties

string

obligatorisk

Produktens unika identifierare från din Dodo Payments-dashboard.Exempel: "prod_123abc456def"

integer

obligatorisk

Produktens kvantitet.Exempel: 1 för en enskild artikel, 3 för flera enheter

array

Array med tillägg som ska kopplas till produkten. Giltigt endast om produkten är en prenumeration.

Visa Addon item properties

string

obligatorisk

integer

obligatorisk

integer

Beloppet kunden betalar om pay_what_you_want är aktiverat. Om det är inaktiverat ignoreras detta fält.Format: Anges i valutans minsta valör (t.ex. cent för USD). Om du vill ta ut 1,00 USD skickar du 100.

array

Åsidosättningar per checkout-session för krediter som redan är kopplade till produkten. Använd detta för att bevilja ett annat antal krediter för just den här sessionen — till exempel ett kampanjpaket som ger 1 000 API-krediter i stället för produktens standardvärde på 500 — utan att skapa en separat produkt.

Varje credit_entitlement_id måste redan vara kopplad till produkten. Det här fältet åsidosätter endast credits_amount som beviljas när den här sessionen slutförs; inställningar för kreditberättigande på produktnivå (förfallodatum, överföring och så vidare) gäller fortfarande.

Visa Credit entitlement override properties

string

obligatorisk

ID:t för det kreditberättigande som ska åsidosättas. Måste redan vara kopplat till produkten.

string

obligatorisk

Antalet krediter som ska beviljas för den här checkout-sessionen, vilket åsidosätter credits_amount på produktnivå. Måste vara större än noll.

Hitta dina produkt-ID:n: Du hittar produkt-ID:n i din Dodo Payments-dashboard under Products → View Details, eller genom att använda List Products API.

Valfria fält

Konfigurera dessa fält för att anpassa checkout-upplevelsen och lägga till affärslogik i ditt betalningsflöde.

Customer Information

object

Kundinformation. Du kan antingen koppla en befintlig kund med deras ID eller skapa en ny kundpost under checkout.

Attach Existing Customer
New Customer

Koppla en befintlig kund till checkout-sessionen med deras ID.

Visa Existing Customer Properties

string

obligatorisk

Den unika identifieraren för en befintlig kund. Använd detta för att koppla checkout-sessionen till en befintlig kund i stället för att skapa en ny.

Skapa en ny kundpost under checkout.

Visa New Customer Properties

string

obligatorisk

Kundens e-postadress. Krävs när en ny kund skapas.

string

Kundens fullständiga namn så som det ska visas på kvitton och fakturor.Exempel: "John Doe" eller "Jane Smith"

string

Kundens telefonnummer i internationellt format. Krävs för vissa betalningsmetoder och för att förebygga bedrägerier.Format: Inkludera landskod, t.ex. "+1234567890" för amerikanska nummer

object

Faktureringsadress för korrekt skatteberäkning, bedrägeribekämpning och efterlevnad av regelverk.

När confirm är inställd på true blir alla fält för faktureringsadress obligatoriska för att sessionen ska kunna skapas.

Visa Billing address object properties

string

Fullständig gatuadress inklusive husnummer, gatunamn och lägenhets-/enhetsnummer om tillämpligt.Exempel: "123 Main St, Apt 4B" eller "456 Oak Avenue"

string

Namn på stad eller kommun.Exempel: "San Francisco", "New York", "London"

string

Namn på delstat, provins eller region. Använd fullständiga namn eller standardförkortningar.Exempel: "California" eller "CA", "Ontario" eller "ON"

string

obligatorisk

Tvåbokstavs ISO-landskod (ISO 3166-1 alpha-2). Detta fält krävs alltid när billing_address anges.Exempel: "US" (USA), "CA" (Kanada), "GB" (Storbritannien), "DE" (Tyskland)

Country Code Reference

Visa en fullständig lista över länder som stöds och deras ISO-koder

string

Postnummer, ZIP-kod eller motsvarande enligt landets krav.Exempel: "94102" (USA), "M5V 3A8" (Kanada), "SW1A 1AA" (Storbritannien)

Payment Configuration

array

Styr vilka betalningsmetoder som är tillgängliga för kunder under checkout. Detta hjälper dig att optimera för specifika marknader eller affärskrav.Tillgängliga alternativ: credit, debit, upi_collect, apple_pay, google_pay, amazon_pay, klarna, affirm, afterpay_clearpay, cashapp, multibanco, bancontact_card, eps, ideal, przelewy24, paypal

Viktigt: Inkludera alltid credit och debit som reservalternativ för att förhindra checkout-fel när föredragna betalningsmetoder inte är tillgängliga.

Exempel:

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

string

Åsidosätt det förvalda valutaalternativet med en fast faktureringsvaluta. Använder ISO 4217-valutakoder.Valutor som stöds: USD, EUR, GBP, CAD, AUD, INR med fleraExempel: "USD" för amerikanska dollar, "EUR" för euro

Detta fält fungerar endast när adaptiv prissättning är aktiverad. Om adaptiv prissättning är inaktiverad används produktens standardvaluta.

boolean

standard:"false"

Visa tidigare sparade betalningsmetoder för återkommande kunder och förbättra checkout-hastigheten och användarupplevelsen.

Session Management

string

URL dit kunderna omdirigeras efter att betalningen har slutförts. Dodo Payments lägger till följande query-parametrar i din URL vid omdirigeringen:

Parameter	Typ	Villkor
`payment_id`	`string`	Alltid tillgänglig för engångsbetalningar
`subscription_id`	`string`	Alltid tillgänglig för prenumerationsbetalningar
`status`	`string`	Alltid tillgänglig
`license_key`	`string`	Tillgänglig om produkten har licensnycklar aktiverade. Kommaseparerad om flera nycklar finns
`email`	`string`	Tillgänglig om kunden har en registrerad e-postadress

Exempel på omdirigerings-URL:er:

# 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

Använd query-parametrarna license_key och email för att visa licensnycklar eller skicka en bekräftelse direkt på din retursida utan att behöva göra ett extra API-anrop.

string

URL dit kunderna omdirigeras när de klickar på bakåtknappen eller avbryter checkout-sessionen. Om den inte anges visas ingen bakåtknapp.

Ange en cancel_url för att ge kunderna ett tydligt sätt att återvända till din webbplats utan att slutföra köpet. Detta förbättrar checkout-upplevelsen och minskar friktionen.

boolean

standard:"false"

Om true anges slutförs alla sessionsdetaljer omedelbart. API:et returnerar ett fel om obligatoriska uppgifter saknas.

array

Tillämpa en eller flera staplade rabattkoder på checkout-sessionen. Koderna tillämpas i arrayordning (den första koden minskar grundpriset, den andra minskar det redan rabatterade priset och så vidare), upp till högst 20 koder per session.

discount_codes: ['WELCOME10', 'BLACKFRIDAY20']

Det enskilda fältet discount_code nedan är föråldrat men stöds fortfarande fullt ut — befintliga integrationer fortsätter att fungera utan ändringar. Det kan inte kombineras med discount_codes i samma request. Migrera till discount_codes när det passar för att dra nytta av stapling.

string

föråldrad

Föråldrat — använd helst discount_codes för nya integrationer. Detta fält fungerar fortfarande för bakåtkompatibilitet men kan inte kombineras med discount_codes i samma request.

object

Egna nyckel-värde-par för lagring av ytterligare information om sessionen.

boolean

Åsidosätt handlarens standardbeteende för 3DS för den här sessionen.

boolean

standard:"false"

Aktivera läget för minimal adressinsamling. När det är aktiverat samlar checkout endast in:

Land: Krävs alltid för skatteberäkning
ZIP-/postnummer: Endast i regioner där det behövs för beräkning av sales tax, VAT eller GST

Detta minskar checkout-friktionen avsevärt genom att onödiga formulärfält tas bort.

Aktivera minimal adress för snabbare slutförande av checkout. Fullständig adressinsamling är fortfarande tillgänglig för företag som behöver kompletta faktureringsuppgifter.

UI Customization & Features

object

Anpassa checkout-gränssnittets utseende och beteende.

Visa Customization object properties

string

standard:"system"

Tema för checkout-gränssnittet. Alternativ: light, dark eller system.

boolean

standard:"true"

Visa avsnittet med orderdetaljer i checkout-gränssnittet.

boolean

standard:"true"

Visa taggen “on-demand” för tillämpliga produkter.

string

Tvinga checkout-gränssnittet att visas på ett specifikt språk. Som standard identifierar checkout automatiskt kundens webbläsarspråk.Språkkoder som stöds: ar (arabiska), ca (katalanska), de (tyska), en (engelska), es (spanska), fr (franska), he (hebreiska), id (indonesiska), it (italienska), ja (japanska), ko (koreanska), ms (malajiska), nl (nederländska), pl (polska), pt (portugisiska), ro (rumänska), ru (ryska), sv (svenska), th (thailändska), tr (turkiska), zh (kinesiska)Exempel: "es" för spanska, "ja" för japanska

object

Konfigurera specifika funktioner och beteenden för checkout-sessionen.

Visa Feature flags object properties

boolean

standard:"true"

Låt kunder välja önskad valuta under checkout.

boolean

standard:"true"

Visa inmatningsfältet för rabattkoder i checkout-gränssnittet.

boolean

standard:"false"

Tillåt kunder att lägga till eller ta bort tillägg för en prenumerationsprodukt under checkout. Gäller endast prenumerationsprodukter.

boolean

standard:"true"

Samla in kundernas telefonnummer under checkout.

boolean

standard:"true"

Tillåt kunder att ange skatteidentifieringsnummer.

boolean

standard:"false"

Tvinga fram skapandet av en ny kundpost i stället för att uppdatera befintliga poster.

boolean

Tillåt kunder att redigera sin e-postadress under checkout.

boolean

Tillåt kunder att redigera sitt namn under checkout.

boolean

Tillåt kunder att redigera gatuadressen under checkout.

boolean

Tillåt kunder att redigera staden under checkout.

boolean

Tillåt kunder att redigera delstaten under checkout.

boolean

Tillåt kunder att redigera landet under checkout.

boolean

Tillåt kunder att redigera postnumret under checkout.

boolean

standard:"false"

Hoppa över den förvalda sidan för lyckad betalning och omdirigera kunderna direkt till din return_url när betalningen har slutförts.

Använd detta när du har en anpassad sida för lyckad betalning som ger en bättre användarupplevelse, eller för mobilappar och inbäddade checkout-flöden.

Custom Fields

array

Samla in ytterligare information från kunder under checkout med anpassade formulärfält. Du kan definiera upp till 5 anpassade fält per checkout-session. Kundernas svar inkluderas i webhook-payloads och är tillgängliga via API:et.

Visa Custom field object properties

string

obligatorisk

Unik identifierare för det här fältet. Används som nyckel i webhook-payloads och API-svar.Exempel: "company_name", "referral_source", "team_size"

string

obligatorisk

Visningsetikett som visas för kunden i checkout-formuläret.Exempel: "Company Name", "How did you hear about us?", "Team Size"

string

obligatorisk

Fälttyp som avgör reglerna för validering av indata.Tillgängliga typer:

text - Textinmatning på en rad
number - Numerisk inmatning
email - E-postadress med validering
url - URL med validering
date - Datumväljare
dropdown - Välj bland fördefinierade alternativ
boolean - Ja/Nej-växlare

boolean

standard:"false"

Anger om fältet måste fyllas i innan checkout kan slutföras.

string

Platshållartext som visas i inmatningsfältet.

array

Lista med alternativ för fälttypen dropdown. Krävs när field_type är dropdown och ignoreras för andra typer.Exempel: ["Google", "Twitter", "Friend referral", "Other"]

Kundsvar på anpassade fält inkluderas i:

Webhooks: payment.succeeded, subscription.active och andra relevanta event-payloads innehåller arrayen custom_field_responses
API-svar: Betalnings- och prenumerationsobjekt innehåller custom_field_responses

Subscription Configuration

object

Ytterligare konfiguration för checkout-sessioner som innehåller prenumerationsprodukter.

Visa Subscription data object properties

integer

Antal dagar i provperioden före den första debiteringen. Måste vara mellan 0 och 10 000 dagar.Ett betalt provbelopp kan inte anges per session — konfigurera trial_amount på produktens återkommande pris i stället. Se Paid Trials.

object

Konfiguration av on-demand-prenumerationer för användningsbaserad eller mätarbaserad fakturering.

Visa On-demand object properties

boolean

obligatorisk

Om true anges görs ingen debitering; endast betalningsmetodens uppgifter auktoriseras för framtida användning.

integer

Produktpriset för den första debiteringen av kunden. Om det inte anges används produktens lagrade pris.Format: Anges i valutans minsta valör (t.ex. cent för USD). Om du vill ta ut 1,00 USD skickar du 100.

string

Valfri valuta för produktpriset. Om den inte anges används produktens valuta som standard.

string

Valfri åsidosättning av produktbeskrivningen för fakturering och radposter. Om den inte anges används produktens lagrade beskrivning.

boolean

Anger om avgifter för adaptiv valuta ska inkluderas i produktpriset (true) eller läggas ovanpå (false). Ignoreras om adaptiv prissättning inte är aktiverad.

Användningsexempel

Här är 10 omfattande exempel som visar olika konfigurationer av checkout-sessioner för olika affärsscenarier:

1. Enkel checkout med en produkt

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

2. Varukorg med flera produkter

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_laptop',
      quantity: 1
    },
    {
      product_id: 'prod_mouse',
      quantity: 2
    },
    {
      product_id: 'prod_warranty',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe',
    phone_number: '+1234567890'
  },
  billing_address: {
    street: '123 Tech Street',
    city: 'San Francisco',
    state: 'CA',
    country: 'US',
    zipcode: '94102'
  },
  return_url: 'https://electronics-store.com/order-confirmation'
});

3. Prenumeration med provperiod

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_monthly_plan',
      quantity: 1
    }
  ],
  subscription_data: {
    trial_period_days: 14
  },
  customer: {
    email: 'user@startup.com',
    name: 'Jane Smith'
  },
  return_url: 'https://saas-app.com/onboarding',
  metadata: {
    plan_type: 'professional',
    referral_source: 'google_ads'
  }
});

4. Förbekräftad checkout

När confirm är inställd på true skickas kunden direkt till checkout-sidan utan bekräftelsesteg.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_premium_course',
      quantity: 1
    }
  ],
  customer: {
    email: 'student@university.edu',
    name: 'Alex Johnson',
    phone_number: '+1555123456'
  },
  billing_address: {
    street: '456 University Ave',
    city: 'Boston',
    state: 'MA',
    country: 'US',
    zipcode: '02134'
  },
  confirm: true,
  return_url: 'https://learning-platform.com/course-access',
  metadata: {
    course_category: 'programming',
    enrollment_date: '2024-01-15'
  }
});

5. Checkout med åsidosättning av valuta

Åsidosättningen billing_currency börjar endast gälla när adaptiv valuta är aktiverad i dina kontoinställningar. Om adaptiv valuta är inaktiverad har denna parameter ingen effekt.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_consulting_service',
      quantity: 1
    }
  ],
  customer: {
    email: 'client@company.co.uk',
    name: 'Oliver Williams'
  },
  billing_address: {
    street: '789 Business Park',
    city: 'London',
    state: 'England',
    country: 'GB',
    zipcode: 'SW1A 1AA'
  },
  billing_currency: 'GBP',
  feature_flags: {
    allow_currency_selection: true,
    allow_tax_id: true
  },
  return_url: 'https://consulting-firm.com/service-confirmation'
});

6. Sparade betalningsmetoder för återkommande kunder

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_monthly_subscription',
      quantity: 1
    }
  ],
  customer: {
    email: 'returning.customer@example.com',
    name: 'Robert Johnson',
    phone_number: '+1555987654'
  },
  show_saved_payment_methods: true,
  feature_flags: {
    allow_phone_number_collection: true,
    always_create_new_customer: false
  },
  return_url: 'https://subscription-service.com/welcome-back',
  metadata: {
    customer_tier: 'premium',
    account_age: 'returning'
  }
});

7. B2B-checkout med insamling av skatte-ID

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_enterprise_license',
      quantity: 5
    }
  ],
  customer: {
    email: 'procurement@enterprise.com',
    name: 'Sarah Davis',
    phone_number: '+1800555000'
  },
  billing_address: {
    street: '1000 Corporate Blvd',
    city: 'New York',
    state: 'NY',
    country: 'US',
    zipcode: '10001'
  },
  feature_flags: {
    allow_tax_id: true,
    allow_phone_number_collection: true,
    always_create_new_customer: false
  },
  return_url: 'https://enterprise-software.com/license-delivery',
  metadata: {
    customer_type: 'enterprise',
    contract_id: 'ENT-2024-001',
    sales_rep: 'john.sales@company.com'
  }
});

8. Checkout med mörkt tema och staplade rabattkoder

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_gaming_chair',
      quantity: 1
    }
  ],
  discount_codes: ['BLACKFRIDAY2024'],
  customization: {
    theme: 'dark',
    show_order_details: true,
    show_on_demand_tag: false
  },
  feature_flags: {
    allow_discount_code: true
  },
  customer: {
    email: 'gamer@example.com',
    name: 'Mike Chen'
  },
  return_url: 'https://gaming-store.com/order-complete'
});

9. Regionala betalningsmetoder (UPI för Indien)

Mer information om UPI-konfiguration och testning finns på sidan India Payment Methods.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_online_course_hindi',
      quantity: 1
    }
  ],
  allowed_payment_method_types: [
    'upi_collect',
    'credit',
    'debit'
  ],
  customer: {
    email: 'student@example.in',
    name: 'Priya Sharma',
    phone_number: '+919876543210'
  },
  billing_address: {
    street: 'MG Road',
    city: 'Bangalore',
    state: 'Karnataka',
    country: 'IN',
    zipcode: '560001'
  },
  billing_currency: 'INR',
  return_url: 'https://education-platform.in/course-access',
  metadata: {
    region: 'south_india',
    language: 'hindi'
  }
});

10. BNPL-checkout (Buy Now Pay Later)

Mer information om BNPL-konfiguration och testning finns på sidan Buy Now Pay Later (BNPL).

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_luxury_watch',
      quantity: 1
    }
  ],
  allowed_payment_method_types: [
    'klarna',
    'afterpay_clearpay',
    'credit',
    'debit'
  ],
  customer: {
    email: 'fashion.lover@example.com',
    name: 'Emma Thompson',
    phone_number: '+1234567890'
  },
  billing_address: {
    street: '555 Fashion Ave',
    city: 'Los Angeles',
    state: 'CA',
    country: 'US',
    zipcode: '90210'
  },
  feature_flags: {
    allow_phone_number_collection: true
  },
  return_url: 'https://luxury-store.com/purchase-confirmation',
  metadata: {
    product_category: 'luxury',
    price_range: 'high_value'
  }
});

11. Använda befintliga betalningsmetoder för direkt checkout

Använd en kunds sparade betalningsmetod för att skapa en checkout-session som behandlas omedelbart utan att samla in betalningsmetoden:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_premium_plan',
      quantity: 1
    }
  ],
  customer: {
    customer_id: 'cus_123'  // Required when using payment_method_id
  },
  payment_method_id: 'pm_abc123',  // Use customer's saved payment method
  confirm: true,  // Required when using payment_method_id
  return_url: 'https://yourapp.com/success'
});

När payment_method_id används måste confirm vara inställd på true och en befintlig customer_id måste anges. Betalningsmetoden valideras för kompatibilitet med betalningens valuta.

Betalningsmetoden måste tillhöra kunden och vara kompatibel med betalningsvalutan. Detta möjliggör köp med ett klick för återkommande kunder.

12. Korta länkar för renare betalnings-URL:er

Generera förkortade, delningsbara betalningslänkar med anpassade sluggar:

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

// The checkout_url will be a shortened, cleaner link
console.log(session.checkout_url);  // e.g., https://checkout.dodopayments.com/buy/abc123

Korta länkar passar perfekt för delning via SMS, e-post eller sociala medier. De är lättare att komma ihåg och skapar större kundförtroende än långa URL:er.

13. Hoppa över sidan för lyckad betalning med omedelbar omdirigering

Omdirigera kunderna omedelbart när betalningen har slutförts och hoppa över den förvalda sidan för lyckad betalning:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_digital_product',
      quantity: 1
    }
  ],
  feature_flags: {
    redirect_immediately: true  // Skip success page, redirect immediately
  },
  return_url: 'https://yourapp.com/success',
  customer: {
    email: 'customer@example.com',
    name: 'Jane Smith'
  }
});

Använd redirect_immediately: true när du har en anpassad sida för lyckad betalning som ger en bättre användarupplevelse än den förvalda sidan. Detta är särskilt användbart för mobilappar och inbäddade checkout-flöden.

När redirect_immediately är aktiverad omdirigeras kunderna till din return_url omedelbart efter att betalningen har slutförts, och den förvalda sidan för lyckad betalning hoppas över helt.

14. Tvinga ett språk

Tvinga checkout att visas på ett specifikt språk och åsidosätt kundens webbläsarspråk:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ],
  customization: {
    force_language: 'ja'  // Force Japanese language
  },
  customer: {
    email: 'customer@example.jp',
    name: 'Tanaka Yuki'
  },
  return_url: 'https://yourapp.com/success'
});

Använd force_language när du känner till kundens önskade språk, till exempel från kontoinställningarna, eller när du riktar dig mot specifika regionala marknader.

Språk som stöds: Arabiska (ar), katalanska (ca), kinesiska (zh), nederländska (nl), engelska (en), franska (fr), tyska (de), hebreiska (he), indonesiska (id), italienska (it), japanska (ja), koreanska (ko), malajiska (ms), polska (pl), portugisiska (pt), rumänska (ro), ryska (ru), spanska (es), svenska (sv), thailändska (th), turkiska (tr)

15. Samla in anpassade fält

Samla in ytterligare information från kunder under checkout med anpassade fält:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_saas_plan',
      quantity: 1
    }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true,
      placeholder: 'Acme Inc.'
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '201-500', '500+']
    },
    {
      key: 'referral_source',
      label: 'How did you hear about us?',
      field_type: 'dropdown',
      required: false,
      options: ['Google', 'Twitter', 'Friend referral', 'Blog post', 'Other']
    },
    {
      key: 'website',
      label: 'Company Website',
      field_type: 'url',
      required: false,
      placeholder: 'https://example.com'
    }
  ],
  customer: {
    email: 'buyer@company.com',
    name: 'Jane Doe'
  },
  return_url: 'https://yourapp.com/success'
});

Svar på anpassade fält inkluderas automatiskt i webhook-payloads (payment.succeeded, subscription.active med flera) och kan hämtas via API:et. Använd dem för att berika ditt CRM, utlösa onboarding-flöden eller anpassa kundupplevelsen.

Tillgängliga fälttyper: text, number, email, url, date, dropdown, boolean

Förhandsgranska checkout-sessioner

Innan du skapar en checkout-session kan du förhandsgranska prisuppdelningen inklusive skatter, rabatter och totalsummor. Detta är användbart för att visa korrekta priser för kunderna innan de går vidare till checkout.

När kundvagnen innehåller en prenumerationsprodukt returnerar förhandsgranskningssvaret även en next_billing_date — en förhandsgranskning av det kommande faktureringsdatumet, så att du kan visa det innan prenumerationen skapas. Det beräknas i förhållande till nu: now + trial period när en provperiod gäller, annars now + one payment frequency. Fältet utelämnas för kundvagnar som endast innehåller engångsprodukter. Detta är en uppskattning baserad på tidpunkten för förhandsgranskningen; det auktoritativa next_billing_date anges när prenumerationen aktiveras.

Förhandsgranskningen returnerar även trial_period_days (den effektiva provperiodens längd, kostnadsfri eller betald) och trial_amount (provperiodens avgift per enhet efter rabatter, i prisvalutans minsta enheter). trial_amount finns endast för en betald provperiod och är null för en kostnadsfri provperiod eller ingen provperiod. Använd current_breakup för den beskattade totalsumma som faktiskt ska betalas i dag.

Node.js SDK
Python SDK

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

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

// 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": "prod_123", "quantity": 1}
    ],
    billing_address={
        "country": "US",
        "state": "CA",
        "zipcode": "94102"
    },
    discount_codes=["SAVE20"]
)

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

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

Preview API Reference

Visa den fullständiga dokumentationen för förhandsgransknings-endpointen.

Flytta från dynamiska länkar till checkout-sessioner

Viktiga skillnader

Tidigare, när du skapade en betalningslänk med Dynamic Links, behövde du ange kundens fullständiga faktureringsadress. Med checkout-sessioner är detta inte längre nödvändigt. Du kan helt enkelt skicka den information du har, så hanterar vi resten. Till exempel:

Om du endast känner till kundens faktureringsland anger du bara det.
Checkout-flödet samlar automatiskt in de uppgifter som saknas innan kunden går vidare till betalningssidan.
Om du däremot redan har all obligatorisk information och vill gå direkt till betalningssidan kan du skicka hela datamängden och inkludera confirm=true i request body.

Migreringsprocess

Migreringen från Dynamic Links till checkout-sessioner är enkel:

Update your integration

Uppdatera din integration så att den använder den nya API- eller SDK-metoden.

Adjust request payload

Justera request-payloaden enligt formatet för checkout-sessioner.

That's it!

Ja. Du behöver inte göra någon ytterligare hantering eller vidta några särskilda migreringssteg.

Relaterad API-referens

Create Checkout Session

Fullständig API-referens för att skapa checkout-sessioner med alla tillgängliga parametrar och alternativ

Preview Checkout Session

API-referens för att förhandsgranska priser, skatter och totalsummor innan en session skapas

Integration Guides

Billing Deconstructions

Cookbooks

Quick Start Guide

API Reference & Live Testing

Preview Checkout

Förutsättningar

Skapa din första checkout-session

API-svar

Request Body

Required Fields

Optional Fields

Obligatoriska fält

Valfria fält

Country Code Reference

Användningsexempel

1. Enkel checkout med en produkt

2. Varukorg med flera produkter

3. Prenumeration med provperiod

4. Förbekräftad checkout

5. Checkout med åsidosättning av valuta

6. Sparade betalningsmetoder för återkommande kunder

7. B2B-checkout med insamling av skatte-ID

8. Checkout med mörkt tema och staplade rabattkoder

9. Regionala betalningsmetoder (UPI för Indien)

10. BNPL-checkout (Buy Now Pay Later)

11. Använda befintliga betalningsmetoder för direkt checkout

12. Korta länkar för renare betalnings-URL:er

13. Hoppa över sidan för lyckad betalning med omedelbar omdirigering

14. Tvinga ett språk

15. Samla in anpassade fält

Förhandsgranska checkout-sessioner

Preview API Reference

Flytta från dynamiska länkar till checkout-sessioner

Viktiga skillnader

Migreringsprocess

Relaterad API-referens

Create Checkout Session

Preview Checkout Session

Quick Start Guide

API Reference & Live Testing

Preview Checkout

​Förutsättningar

​Skapa din första checkout-session

​API-svar

​Request Body

Required Fields

Optional Fields

​Obligatoriska fält

​Valfria fält

Country Code Reference

​Användningsexempel

​1. Enkel checkout med en produkt

​2. Varukorg med flera produkter

​3. Prenumeration med provperiod

​4. Förbekräftad checkout

​5. Checkout med åsidosättning av valuta

​6. Sparade betalningsmetoder för återkommande kunder

​7. B2B-checkout med insamling av skatte-ID

​8. Checkout med mörkt tema och staplade rabattkoder

​9. Regionala betalningsmetoder (UPI för Indien)

​10. BNPL-checkout (Buy Now Pay Later)

​11. Använda befintliga betalningsmetoder för direkt checkout

​12. Korta länkar för renare betalnings-URL:er

​13. Hoppa över sidan för lyckad betalning med omedelbar omdirigering

​14. Tvinga ett språk

​15. Samla in anpassade fält

​Förhandsgranska checkout-sessioner

Preview API Reference

​Flytta från dynamiska länkar till checkout-sessioner

​Viktiga skillnader

​Migreringsprocess

​Relaterad API-referens

Create Checkout Session

Preview Checkout Session

Förutsättningar

Skapa din första checkout-session

API-svar

Request Body

Obligatoriska fält

Valfria fält

Användningsexempel

1. Enkel checkout med en produkt

2. Varukorg med flera produkter

3. Prenumeration med provperiod

4. Förbekräftad checkout

5. Checkout med åsidosättning av valuta

6. Sparade betalningsmetoder för återkommande kunder

7. B2B-checkout med insamling av skatte-ID

8. Checkout med mörkt tema och staplade rabattkoder

9. Regionala betalningsmetoder (UPI för Indien)

10. BNPL-checkout (Buy Now Pay Later)

11. Använda befintliga betalningsmetoder för direkt checkout

12. Korta länkar för renare betalnings-URL:er

13. Hoppa över sidan för lyckad betalning med omedelbar omdirigering

14. Tvinga ett språk

15. Samla in anpassade fält

Förhandsgranska checkout-sessioner

Flytta från dynamiska länkar till checkout-sessioner

Viktiga skillnader

Migreringsprocess

Relaterad API-referens