Sesi Checkout

Panduan Memulai Cepat

Dapatkan sesi checkout pertama Anda berjalan dalam waktu kurang dari 5 menit

Referensi API & Pengujian Langsung

Jelajahi dokumentasi API lengkap dan uji permintaan serta respons Sesi Checkout secara interaktif.

Prabaca Checkout

Hitung harga, pajak, dan total sebelum membuat sesi.

Validitas Sesi: Sesi checkout berlaku selama 24 jam secara default. Jika Anda mengirim confirm=true dalam permintaan Anda, sesi hanya akan berlaku selama 15 menit.

Prasyarat

Akun Dodo Payments

Anda memerlukan akun pedagang Dodo Payments yang aktif dengan akses API.

Kredensial API

Hasilkan kredensial API Anda dari dasbor Dodo Payments:

Pengaturan Produk

Buat produk Anda di dasbor Dodo Payments sebelum menerapkan sesi checkout.

Membuat Sesi Checkout Pertama Anda

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;
});

Respons API

Semua metode di atas mengembalikan struktur respons yang sama:

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

Dapatkan URL checkout

Ekstrak checkout_url dari respons API.

Arahkan pelanggan Anda

Arahkan pelanggan Anda ke URL checkout untuk menyelesaikan pembelian mereka.

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

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

Opsi Integrasi Alternatif: Alih-alih mengarahkan, Anda dapat menyematkan checkout langsung di halaman Anda menggunakan Overlay Checkout (overlay modal) atau Inline Checkout (sepenuhnya disematkan). Kedua opsi menggunakan URL sesi checkout yang sama.

Tangani pengembalian

Setelah pembayaran, pelanggan diarahkan ke return_url Anda dengan parameter kueri tambahan untuk status pembayaran.

Badan Permintaan

Bidang Wajib

Bidang penting yang dibutuhkan untuk setiap sesi checkout

Bidang Opsional

Konfigurasi tambahan untuk menyesuaikan pengalaman checkout Anda

Bidang Wajib

product_cart

array

wajib

Array produk yang termasuk dalam sesi checkout. Setiap produk harus memiliki product_id yang valid dari dasbor Dodo Payments Anda.

Checkout Campuran: Anda dapat menggabungkan produk pembayaran satu kali dan produk langganan dalam sesi checkout yang sama. Ini memungkinkan kasus penggunaan yang kuat seperti biaya pengaturan dengan langganan, bundel perangkat keras dengan SaaS, dan lainnya.

Tampilkan Properti Item Keranjang Produk

product_id

string

wajib

Pengidentifikasi unik produk dari dasbor Dodo Payments Anda.Contoh: "prod_123abc456def"

quantity

integer

wajib

Kuantitas produk.Contoh: 1 untuk item tunggal, 3 untuk kuantitas ganda

addons

array

Array addon yang dilampirkan pada produk. Hanya valid jika produk adalah langganan.

Tampilkan Properti item addon

addon_id

string

wajib

quantity

integer

wajib

amount

integer

Jumlah yang dibayar pelanggan jika pay_what_you_want diaktifkan. Jika dinonaktifkan, bidang ini akan diabaikan.Format: Diwakili dalam denominasi terendah dari mata uang (misalnya, sen untuk USD). Sebagai contoh, untuk mengenakan biaya $1,00, kirim 100.

Temukan ID Produk Anda: Anda dapat menemukan ID produk di dasbor Dodo Payments Anda di bawah Produk → Lihat Detail, atau dengan menggunakan List Products API.

Bidang Opsional

Konfigurasikan bidang ini untuk menyesuaikan pengalaman checkout dan menambahkan logika bisnis ke alur pembayaran Anda.

Informasi Pelanggan

customer

object

Informasi pelanggan. Anda dapat melampirkan pelanggan yang ada menggunakan ID mereka atau membuat catatan pelanggan baru selama checkout.

Lampirkan Pelanggan yang Ada
Pelanggan Baru

Lampirkan pelanggan yang ada ke sesi checkout menggunakan ID mereka.

Tampilkan Properti Pelanggan yang Ada

customer_id

string

wajib

Pengidentifikasi unik pelanggan yang ada. Gunakan ini untuk melampirkan sesi checkout ke pelanggan yang ada alih-alih membuat yang baru.

Buat catatan pelanggan baru selama checkout.

Tampilkan Properti Pelanggan Baru

string

wajib

Alamat email pelanggan. Diperlukan saat membuat pelanggan baru.

name

string

Nama lengkap pelanggan seperti yang harus muncul di kwitansi dan faktur.Contoh: "John Doe" atau "Jane Smith"

phone_number

string

Nomor telepon pelanggan dalam format internasional. Diperlukan untuk beberapa metode pembayaran dan pencegahan penipuan.Format: Sertakan kode negara, misalnya, "+1234567890" untuk nomor AS

billing_address

object

Informasi alamat penagihan untuk perhitungan pajak yang akurat, pencegahan penipuan, dan kepatuhan regulasi.

Ketika confirm diatur ke true, semua bidang alamat penagihan menjadi wajib untuk pembuatan sesi yang berhasil.

Tampilkan Properti objek alamat penagihan

street

string

Alamat jalan lengkap termasuk nomor rumah, nama jalan, dan nomor apartemen/unit jika berlaku.Contoh: "123 Main St, Apt 4B" atau "456 Oak Avenue"

city

string

Nama kota atau munisipalitas.Contoh: "San Francisco", "New York", "London"

state

string

Nama negara bagian, provinsi, atau wilayah. Gunakan nama lengkap atau singkatan standar.Contoh: "California" atau "CA", "Ontario" atau "ON"

country

string

wajib

Kode negara ISO dua huruf (ISO 3166-1 alpha-2). Bidang ini selalu diperlukan ketika alamat_penagihan disediakan.Contoh: "US" (Amerika Serikat), "CA" (Kanada), "GB" (Inggris Raya), "DE" (Jerman)

Referensi Kode Negara

Lihat daftar lengkap negara yang didukung dan kode ISO mereka

zipcode

string

Kode pos, kode ZIP, atau yang setara berdasarkan persyaratan negara.Contoh: "94102" (AS), "M5V 3A8" (Kanada), "SW1A 1AA" (Inggris)

Konfigurasi Pembayaran

allowed_payment_method_types

array

Mengontrol metode pembayaran mana yang tersedia untuk pelanggan selama checkout. Ini membantu mengoptimalkan untuk pasar atau persyaratan bisnis tertentu.Pilihan Tersedia: credit, debit, upi_collect, apple_pay, google_pay, amazon_pay, klarna, affirm, afterpay_clearpay, cashapp, multibanco, bancontact_card, eps, ideal, przelewy24, paypal

Kritis: Selalu sertakan credit dan debit sebagai opsi cadangan untuk mencegah kegagalan checkout ketika metode pembayaran yang diinginkan tidak tersedia.

Contoh:

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

billing_currency

string

Tindakan untuk mengesampingkan pemilihan mata uang default dengan mata uang penagihan tetap. Menggunakan kode mata uang ISO 4217.Mata Uang yang Didukung: USD, EUR, GBP, CAD, AUD, INR, dan lainnyaContoh: "USD" untuk Dolar AS, "EUR" untuk Euro

Bidang ini hanya efektif ketika penetapan harga adaptif diaktifkan. Jika penetapan harga adaptif dinonaktifkan, mata uang default produk akan digunakan.

show_saved_payment_methods

boolean

default:"false"

Tampilkan metode pembayaran yang disimpan sebelumnya untuk pelanggan yang kembali, meningkatkan kecepatan checkout dan pengalaman pengguna.

Manajemen Sesi

return_url

string

URL untuk mengarahkan pelanggan setelah pembayaran berhasil atau pembatalan.

confirm

boolean

default:"false"

Jika benar, menyelesaikan semua detail sesi segera. API akan mengeluarkan kesalahan jika data yang diperlukan hilang.

discount_code

string

Terapkan kode diskon ke sesi checkout.

metadata

object

Pasangan kunci-nilai kustom untuk menyimpan informasi tambahan tentang sesi.

force_3ds

boolean

Mengabaikan perilaku 3DS default pedagang untuk sesi ini.

minimal_address

boolean

default:"false"

Aktifkan mode pengumpulan alamat minimal. Ketika diaktifkan, checkout hanya mengumpulkan:

Negara: Selalu diperlukan untuk penentuan pajak
Kode ZIP/Pos: Hanya di wilayah di mana diperlukan untuk perhitungan pajak penjualan, PPN, atau GST

Ini secara signifikan mengurangi gesekan checkout dengan menghilangkan bidang formulir yang tidak perlu.

Aktifkan alamat minimal untuk penyelesaian checkout yang lebih cepat. Pengumpulan alamat lengkap tetap tersedia untuk bisnis yang memerlukan detail penagihan lengkap.

Kustomisasi UI & Fitur

customization

object

Sesuaikan penampilan dan perilaku antarmuka checkout.

Tampilkan Properti objek kustomisasi

theme

string

default:"system"

Tema untuk antarmuka checkout. Opsi: light, dark, atau system.

show_order_details

boolean

default:"true"

Tampilkan bagian detail pesanan di antarmuka checkout.

show_on_demand_tag

boolean

default:"true"

Tampilkan tag “on-demand” untuk produk yang berlaku.

force_language

string

Paksa antarmuka checkout untuk dirender dalam bahasa tertentu.Contoh: "en" untuk Bahasa Inggris, "es" untuk Bahasa Spanyol

feature_flags

object

Konfigurasikan fitur dan perilaku tertentu untuk sesi checkout.

Tampilkan Properti objek bendera fitur

allow_currency_selection

boolean

default:"true"

Izinkan pelanggan untuk memilih mata uang yang diinginkan selama checkout.

allow_discount_code

boolean

default:"true"

Tampilkan bidang input kode diskon di antarmuka checkout.

allow_phone_number_collection

boolean

default:"true"

Kumpulkan nomor telepon pelanggan selama checkout.

allow_tax_id

boolean

default:"true"

Izinkan pelanggan untuk memasukkan nomor identifikasi pajak.

always_create_new_customer

boolean

default:"false"

Paksa pembuatan catatan pelanggan baru alih-alih memperbarui yang sudah ada.

allow_customer_editing_email

boolean

Izinkan pelanggan untuk mengedit alamat email mereka selama checkout.

allow_customer_editing_name

boolean

Izinkan pelanggan untuk mengedit nama mereka selama checkout.

allow_customer_editing_street

boolean

Izinkan pelanggan untuk mengedit alamat jalan selama checkout.

allow_customer_editing_city

boolean

Izinkan pelanggan untuk mengedit kota selama checkout.

allow_customer_editing_state

boolean

Izinkan pelanggan untuk mengedit negara bagian selama checkout.

allow_customer_editing_country

boolean

Izinkan pelanggan untuk mengedit negara selama checkout.

allow_customer_editing_zipcode

boolean

Izinkan pelanggan untuk mengedit kode pos selama checkout.

minimal_address

boolean

default:"false"

Aktifkan mode pengumpulan alamat minimal. Ketika diaktifkan, checkout hanya mengumpulkan:

Negara: Selalu diperlukan untuk penentuan pajak
Kode ZIP/Pos: Hanya di wilayah di mana diperlukan untuk perhitungan pajak penjualan, PPN, atau GST

Ini secara signifikan mengurangi gesekan checkout dengan menghilangkan bidang formulir yang tidak perlu.

Aktifkan alamat minimal untuk penyelesaian checkout yang lebih cepat. Pengumpulan alamat lengkap tetap tersedia untuk bisnis yang memerlukan detail penagihan lengkap.

Konfigurasi Langganan

subscription_data

object

Konfigurasi tambahan untuk sesi checkout yang berisi produk langganan.

Tampilkan Properti objek data langganan

trial_period_days

integer

Jumlah hari untuk periode percobaan sebelum biaya pertama. Harus antara 0 dan 10000 hari.

on_demand

object

Konfigurasi langganan berdasarkan permintaan untuk penagihan berbasis penggunaan atau terukur.

Tampilkan Properti objek berdasarkan permintaan

mandate_only

boolean

wajib

Jika diatur ke true, tidak melakukan biaya apa pun dan hanya mengotorisasi detail metode pembayaran untuk penggunaan di masa mendatang.

product_price

integer

Harga produk untuk biaya awal kepada pelanggan. Jika tidak ditentukan, harga yang disimpan dari produk akan digunakan.Format: Diwakili dalam denominasi terendah dari mata uang (misalnya, sen untuk USD). Sebagai contoh, untuk mengenakan biaya $1,00, kirim 100.

product_currency

string

Mata uang opsional dari harga produk. Jika tidak ditentukan, default ke mata uang produk.

product_description

string

Override deskripsi produk opsional untuk penagihan dan item baris. Jika tidak ditentukan, deskripsi yang disimpan dari produk akan digunakan.

adaptive_currency_fees_inclusive

boolean

Apakah biaya mata uang adaptif harus termasuk dalam harga produk (true) atau ditambahkan di atas (false). Diabaikan jika penetapan harga adaptif tidak diaktifkan.

Contoh Penggunaan

Berikut adalah 10 contoh komprehensif yang menunjukkan berbagai konfigurasi sesi checkout untuk berbagai skenario bisnis:

1. Checkout Produk Tunggal Sederhana

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. Keranjang Multi-Produk

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. Langganan dengan Periode Percobaan

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. Checkout yang Sudah Dikonfirmasi

Ketika confirm diatur ke true, pelanggan akan langsung dibawa ke halaman checkout, melewati langkah konfirmasi apa pun.

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 dengan Override Mata Uang

Override billing_currency hanya berlaku ketika mata uang adaptif diaktifkan dalam pengaturan akun Anda. Jika mata uang adaptif dinonaktifkan, parameter ini tidak akan berpengaruh.

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. Metode Pembayaran yang Disimpan untuk Pelanggan yang Kembali

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. Checkout B2B dengan Pengumpulan ID Pajak

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 Tema Gelap dengan Kode Diskon

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_gaming_chair',
      quantity: 1
    }
  ],
  discount_code: '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. Metode Pembayaran Regional (UPI untuk India)

Untuk informasi lebih lanjut tentang konfigurasi dan pengujian UPI, lihat halaman Metode Pembayaran India.

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 (Beli Sekarang Bayar Nanti) Checkout

Untuk informasi lebih lanjut tentang konfigurasi dan pengujian BNPL, lihat halaman Beli Sekarang Bayar Nanti (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. Menggunakan Metode Pembayaran yang Ada untuk Checkout Segera

Gunakan metode pembayaran yang disimpan oleh pelanggan untuk membuat sesi checkout yang diproses segera, melewati pengumpulan metode pembayaran:

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'
});

Saat menggunakan payment_method_id, confirm harus diatur ke true dan sebuah customer_id yang ada harus disediakan. Metode pembayaran akan divalidasi untuk kelayakan dengan mata uang pembayaran.

Metode pembayaran harus milik pelanggan dan kompatibel dengan mata uang pembayaran. Ini memungkinkan pembelian sekali klik untuk pelanggan yang sudah kembali.

12. Tautan Pendek untuk URL Pembayaran yang Lebih Bersih

Hasilkan tautan pembayaran yang dipersingkat dan dapat dibagikan dengan slugs kustom:

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

Tautan pendek sempurna untuk berbagi melalui SMS, email, atau media sosial. Mereka lebih mudah diingat dan membangun lebih banyak kepercayaan pelanggan dibandingkan dengan URL yang panjang.

13. Lewati Halaman Sukses Pembayaran dengan Redirect Segera

Redirect pelanggan segera setelah penyelesaian pembayaran, melewati halaman sukses default:

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'
  }
});

Gunakan redirect_immediately: true saat Anda memiliki halaman sukses kustom yang memberikan pengalaman pengguna yang lebih baik dibandingkan dengan halaman sukses pembayaran default. Ini sangat berguna untuk aplikasi mobile dan alur checkout yang tertanam.

Saat redirect_immediately diaktifkan, pelanggan akan diarahkan ke return_url Anda segera setelah penyelesaian pembayaran, sepenuhnya melewati halaman sukses default.

Menyajikan Sesi Checkout

Sebelum membuat sesi checkout, Anda dapat melihat rincian harga termasuk pajak, diskon, dan total. Ini berguna untuk menampilkan harga yang akurat kepada pelanggan sebelum mereka melanjutkan ke checkout.

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_code: 'SAVE20'
});

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

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

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

Pranala API Preview

Lihat dokumentasi lengkap endpoint preview.

Pindah dari Tautan Dinamis ke Sesi Checkout

Perbedaan Utama

Sebelumnya, saat membuat tautan pembayaran dengan Tautan Dinamis, Anda diminta untuk memberikan alamat penagihan lengkap pelanggan. Dengan Sesi Checkout, ini tidak lagi diperlukan. Anda dapat dengan mudah melewatkan informasi yang Anda miliki, dan kami akan menangani sisanya. Contohnya:

Jika Anda hanya tahu negara penagihan pelanggan, cukup berikan itu.
Alur checkout akan secara otomatis mengumpulkan detail yang hilang sebelum memindahkan pelanggan ke halaman pembayaran.
Di sisi lain, jika Anda sudah memiliki semua informasi yang diperlukan dan ingin langsung ke halaman pembayaran, Anda dapat memberikan kumpulan data lengkap dan menyertakan confirm=true dalam body permintaan Anda.

Proses Migrasi

Migrasi dari Tautan Dinamis ke Sesi Checkout adalah proses yang sederhana:

Perbarui integrasi Anda

Perbarui integrasi Anda untuk menggunakan API atau metode SDK yang baru.

Sesuaikan payload permintaan

Sesuaikan payload permintaan sesuai format Sesi Checkout.

Itu saja!

Ya. Tidak ada penanganan tambahan atau langkah migrasi khusus yang diperlukan di pihak Anda.

Integration Guides

Cookbooks

Panduan Memulai Cepat

Referensi API & Pengujian Langsung

Prabaca Checkout

Prasyarat

Membuat Sesi Checkout Pertama Anda

Respons API

Badan Permintaan

Bidang Wajib

Bidang Opsional

Bidang Wajib

Bidang Opsional

Referensi Kode Negara

Contoh Penggunaan

1. Checkout Produk Tunggal Sederhana

2. Keranjang Multi-Produk

3. Langganan dengan Periode Percobaan

4. Checkout yang Sudah Dikonfirmasi

5. Checkout dengan Override Mata Uang

6. Metode Pembayaran yang Disimpan untuk Pelanggan yang Kembali

7. Checkout B2B dengan Pengumpulan ID Pajak

8. Checkout Tema Gelap dengan Kode Diskon

9. Metode Pembayaran Regional (UPI untuk India)

10. BNPL (Beli Sekarang Bayar Nanti) Checkout

11. Menggunakan Metode Pembayaran yang Ada untuk Checkout Segera

12. Tautan Pendek untuk URL Pembayaran yang Lebih Bersih

13. Lewati Halaman Sukses Pembayaran dengan Redirect Segera

Menyajikan Sesi Checkout

Pranala API Preview

Pindah dari Tautan Dinamis ke Sesi Checkout

Perbedaan Utama

Proses Migrasi

Integration Guides

Cookbooks

Panduan Memulai Cepat

Referensi API & Pengujian Langsung

Prabaca Checkout

​Prasyarat

​Membuat Sesi Checkout Pertama Anda

​Respons API

​Badan Permintaan

Bidang Wajib

Bidang Opsional

​Bidang Wajib

​Bidang Opsional

Referensi Kode Negara

​Contoh Penggunaan

​1. Checkout Produk Tunggal Sederhana

​2. Keranjang Multi-Produk

​3. Langganan dengan Periode Percobaan

​4. Checkout yang Sudah Dikonfirmasi

​5. Checkout dengan Override Mata Uang

​6. Metode Pembayaran yang Disimpan untuk Pelanggan yang Kembali

​7. Checkout B2B dengan Pengumpulan ID Pajak

​8. Checkout Tema Gelap dengan Kode Diskon

​9. Metode Pembayaran Regional (UPI untuk India)

​10. BNPL (Beli Sekarang Bayar Nanti) Checkout

​11. Menggunakan Metode Pembayaran yang Ada untuk Checkout Segera

​12. Tautan Pendek untuk URL Pembayaran yang Lebih Bersih

​13. Lewati Halaman Sukses Pembayaran dengan Redirect Segera

​Menyajikan Sesi Checkout

Pranala API Preview

​Pindah dari Tautan Dinamis ke Sesi Checkout

​Perbedaan Utama

​Proses Migrasi

Prasyarat

Membuat Sesi Checkout Pertama Anda

Respons API

Badan Permintaan

Bidang Wajib

Bidang Opsional

Contoh Penggunaan

1. Checkout Produk Tunggal Sederhana

2. Keranjang Multi-Produk

3. Langganan dengan Periode Percobaan

4. Checkout yang Sudah Dikonfirmasi

5. Checkout dengan Override Mata Uang

6. Metode Pembayaran yang Disimpan untuk Pelanggan yang Kembali

7. Checkout B2B dengan Pengumpulan ID Pajak

8. Checkout Tema Gelap dengan Kode Diskon

9. Metode Pembayaran Regional (UPI untuk India)

10. BNPL (Beli Sekarang Bayar Nanti) Checkout

11. Menggunakan Metode Pembayaran yang Ada untuk Checkout Segera

12. Tautan Pendek untuk URL Pembayaran yang Lebih Bersih

13. Lewati Halaman Sukses Pembayaran dengan Redirect Segera

Menyajikan Sesi Checkout

Pindah dari Tautan Dinamis ke Sesi Checkout

Perbedaan Utama

Proses Migrasi