चेकआउट सुविधाएँ

Dodo Payments checkout डिजिटल उत्पादों और SaaS के लिए बनाई गई एक hosted payment page है। यह currency conversion, tax calculation, discount codes, address collection और payment method selection संभालती है। आप API या dashboard के माध्यम से checkout session बनाते हैं और ग्राहक एक सुरक्षित, branded page पर payment पूरा करते हैं।

Checkout Sessions API

Checkout sessions को programmatically बनाएं।

Preview Checkout

सेशन बनाने से पहले मूल्य निर्धारण और करों की गणना करें।

Payment Methods

समर्थित payment methods और configuration।

Integration Guide

Checkout को integrate करने के लिए step-by-step guide।

Checkout Sessions API के माध्यम से बनाए गए Checkout links reusable नहीं होते। वे 24 घंटे बाद expire हो जाते हैं, या यदि confirm: true सेट है तो 15 मिनट बाद expire होते हैं। प्रत्येक ग्राहक और प्रत्येक payment attempt के लिए नया session बनाएं।

Adaptive Currency

Adaptive Currency ग्राहकों को अपनी पसंद की local currency में payment करने देती है, जिससे trust और conversion rates बेहतर होते हैं। सक्षम होने पर checkout में customers को currency selector दिखाई देता है। Price live FX rates पर उनकी चुनी हुई currency में convert हो जाती है। यदि product में Purchasing Power Parity सक्षम है, तो base price के बजाय PPP-adjusted price convert होती है। यदि Charm Pricing सक्षम है, तो converted amount को 49.99 जैसे साफ़ ending पर round किया जाता है।

Adaptive Currency सक्षम करने के लिए Settings → Business पर जाएं और इसे toggle on करें।

Adaptive Currency

समर्थित currencies, conversion fees और refund handling।

Multi-Language Checkout

Checkout 22 languages को support करता है। ग्राहक सीधे page पर languages बदल सकते हैं और UI text, labels तथा system messages localized होते हैं। Arabic और Hebrew में checkout दाईं से बाईं ओर render होता है और पूरा layout mirror हो जाता है। Email addresses, codes और phone numbers अपना स्वाभाविक reading order बनाए रखते हैं।

समर्थित भाषाएँ

भाषा	Code
Arabic	`ar`
Catalan	`ca`
Chinese	`zh`
Dutch	`nl`
English	`en`
French	`fr`
Georgian	`ka`
German	`de`
Hebrew	`he`
Indonesian	`id`
Italian	`it`
Japanese	`ja`
Korean	`ko`
Malay	`ms`
Polish	`pl`
Portuguese	`pt`
Romanian	`ro`
Russian	`ru`
Spanish	`es`
Swedish	`sv`
Thai	`th`
Turkish	`tr`

किसी विशिष्ट भाषा को अनिवार्य करने के लिए checkout session बनाते समय customization.force_language सेट करें। विवरण के लिए Checkout Sessions API देखें।

Automatic Tax Calculation

GST, VAT और sales tax की आवश्यकताओं के अनुपालन को सुनिश्चित करने के लिए, customer के billing location के आधार पर taxes की स्वचालित रूप से गणना की जाती है। जहाँ लागू हो, tax rules customer के country और region के आधार पर लागू होते हैं। Customer द्वारा अपना country बदलने या address अपडेट करने पर tax amount अपने-आप अपडेट हो जाता है। Payment से पहले अंतिम tax breakdown स्पष्ट रूप से दिखाया जाता है।

Tax calculation पूरी तरह automated है। Standard digital goods और SaaS products के लिए किसी manual configuration की आवश्यकता नहीं है।

Business Tax ID Support

B2B transactions के लिए checkout customers को अपना Business Tax ID (जैसे VAT या GST number) दर्ज करने की सुविधा देता है। दर्ज किए जाने पर tax ID को real-time में validate किया जाता है और लागू tax exemptions या reverse-charge rules अपने-आप लागू हो जाते हैं।

Discount Codes

Customers dashboard में आपके द्वारा बनाए गए discount या promo codes लागू कर सकते हैं। Discount तुरंत validate होता है और updated price दिखाया जाता है। जब किसी product पर Purchasing Power Parity enabled होता है, तो discount base price के बजाय PPP-adjusted price पर लागू होता है।

आप discount codes को पहले से लागू कर सकते हैं या API के माध्यम से discount input field enabled कर सकते हैं:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  discount_codes: ['WELCOME20'], // Pre-apply one or more codes (max 20)
  feature_flags: {
    allow_discount_code: true // Shown by default; set to false to hide the field
  },
  return_url: 'https://yoursite.com/return'
});

discount_codes अधिकतम 20 codes का array स्वीकार करता है, जो क्रम से stack होते हैं। Singular discount_code field deprecated है, लेकिन backward compatibility के लिए अभी भी काम करता है।

Discount Codes

Discount codes बनाएँ और manage करें।

Validate Discount by Code

Code names का उपयोग करके discounts को खोजें और validate करें।

Smart Address Collection

Checkout speed, accuracy और global coverage के बीच संतुलन बनाने के लिए flexible address entry का समर्थन करता है।

Options

Option	Description
Google Address Autofill	Autocomplete के साथ quick selection
Manual Entry	Complete addresses के लिए full control
Country Selection	Tax और compliance logic के लिए आवश्यक
Minimal Address Mode	जहाँ tax के लिए आवश्यक हो वहाँ केवल country और ZIP collect करें

Minimal Address Mode

अधिकतम conversion के लिए checkout friction कम करने हेतु minimal address collection enabled करें। जब minimal_address को true पर सेट किया जाता है, तो checkout केवल ये जानकारी collect करता है:

Country — tax determination के लिए हमेशा आवश्यक
ZIP/Postal code — केवल उन regions में जहाँ sales tax, VAT या GST calculation के लिए यह आवश्यक है

अन्य सभी address fields छोड़ दिए जाते हैं।

checkout पर केवल country और ZIP/postal code fields दिखाने वाला minimal address mode

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  minimal_address: true,
  return_url: 'https://yoursite.com/return'
});

Full address collection default है। ऐसे digital products और SaaS flows के लिए minimal_address enabled करें जहाँ complete billing details आवश्यक नहीं हैं।

Phone Number Collection

यह नियंत्रित करें कि checkout पर phone number field दिखाई दे और क्या वह required हो।

Flag	Default	Behavior
`allow_phone_number_collection`	`true`	Phone number field दिखाता है
`require_phone_number`	`false`	Phone number field को required बनाता है

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_abc', quantity: 1 }],
  feature_flags: {
    allow_phone_number_collection: true,
    require_phone_number: true
  },
  return_url: 'https://yoursite.com/return'
});

require_phone_number: true के लिए allow_phone_number_collection: true आवश्यक है। जब phone collection disabled हो और phone number required हो, तो API sessions को reject कर देता है।

Custom Fields

Custom form fields define करके checkout के दौरान customers से अतिरिक्त जानकारी collect करें। यह company name, team size, referral source या किसी अन्य business-specific data को collect करने के लिए उपयोगी है।

Available Field Types

Type	Description
`text`	Single-line text input
`number`	Numeric input
`email`	Validation वाला email address
`url`	Validation वाला URL
`date`	Date picker
`dropdown`	Predefined options में से select करें
`boolean`	Yes/No toggle

Example

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});

Customer responses webhook payloads (payment.succeeded, subscription.active) और API responses में custom_field_responses array के माध्यम से अपने-आप शामिल हो जाते हैं। आप प्रत्येक checkout session में अधिकतम 5 custom fields define कर सकते हैं।

Custom Fields Guide

Custom field configuration और responses access करना।

Privacy Policy & Terms Acceptance

कानूनी और compliance transparency सुनिश्चित करने के लिए:

Privacy Policy और Buyer Terms links checkout पर स्पष्ट रूप से प्रदर्शित किए जाते हैं
Payment पूरा करने से पहले customers इन्हें स्पष्ट रूप से acknowledge करते हैं

यह GDPR compliance सहित global consumer protection और data privacy requirements को पूरा करने में सहायता करता है।

Product Collections

Product Collections एक unified checkout experience सक्षम करते हैं, जहाँ customers एक ही checkout में कई संबंधित products (जैसे Starter, Pro, Enterprise plans) देख और select कर सकते हैं। Collection का उपयोग करने पर collection के सभी active products प्रदर्शित किए जाते हैं। पहला product pre-selected होता है और customers चुनने से पहले options की तुलना कर सकते हैं।

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

product_collection_id का उपयोग करते समय एक खाली product_cart array pass करें। Session creation के समय discount codes pre-apply नहीं किए जा सकते।

Product Collections

Product collections बनाएँ और manage करें।

Checkout Session Configuration

Checkout behavior को Checkout Sessions API का उपयोग करके नियंत्रित करें:

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR',
  discount_codes: ['PROMO10'],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  cancel_url: 'https://yoursite.com/pricing',
  metadata: {
    order_ref: 'ORD-12345'
  }
});

Payment के बाद customers को आपके return_url पर redirect किया जाता है और query parameters अपने-आप append होते हैं — इनमें payment_id या subscription_id, status, email और license_key (यदि लागू हो) शामिल हैं। पूरी list के लिए Checkout Sessions guide देखें।

Checkout Sessions API

Checkout sessions के लिए complete API reference।

Checkout Integration Guide

Checkout integrate करने के लिए step-by-step guide।

Theme Customization

customization.theme_config parameter का उपयोग करके checkout page का appearance अपने brand के अनुरूप customize करें। Light और dark modes के लिए colors, fonts, border radius और button text configure करें। यह section server-side API को cover करता है, जो bg_primary जैसे property names का उपयोग करता है। Session पर set की गई theme hosted, overlay और inline checkout पर लागू होती है। Checkout SDK का client-side themeConfig option, जो bgPrimary जैसे property names का उपयोग करता है, deprecated है। Overlay Checkout देखें।

Design & Theme Customization

Dashboard से pre-built themes, typography, colors और live preview का उपयोग करके themes को visually configure करें।

Theme Configuration Options

Property	Description
`light`	Light mode के लिए color configuration
`dark`	Dark mode के लिए color configuration
`font_primary_url`	Primary font के लिए URL
`font_secondary_url`	Secondary font के लिए URL
`font_size`	Font size: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`
`font_weight`	Font weight: `normal`, `medium`, `bold`, `extraBold`
`radius`	UI elements के लिए border radius (जैसे `4px`, `0.5rem`, `8px`)
`pay_button_text`	Pay button के लिए custom text (जैसे, “Complete Purchase”, “Subscribe Now”)

Color Configuration (Light/Dark Mode)

प्रत्येक mode इन color properties का समर्थन करता है:

Property	Description
`bg_primary`	Primary background color
`bg_secondary`	Secondary background color
`text_primary`	Primary text color
`text_secondary`	Secondary text color
`text_placeholder`	Text placeholder color
`text_error`	Text error color
`text_success`	Text success color
`border_primary`	Primary border color
`border_secondary`	Secondary border color
`button_primary`	Primary button background color
`button_primary_hover`	Primary button hover color
`button_secondary`	Secondary button background color
`button_secondary_hover`	Secondary button hover color
`button_text_primary`	Primary button text color
`button_text_secondary`	Secondary button text color
`input_focus_border`	Input focus border color

सभी color fields standard CSS color formats स्वीकार करते हैं:

Hex: #fff, #ffffff, #ffffffff
RGB/RGBA: rgb(255, 255, 255), rgba(255, 255, 255, 0.5)
HSL/HSLA: hsl(120, 100%, 50%), hsla(120, 100%, 50%, 0.5)
Named colors: red, blue, transparent

Example

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'pdt_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});

आपको सभी color properties specify करने की आवश्यकता नहीं है। Unspecified properties default theme values का उपयोग करती हैं।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Preview Checkout

Payment Methods

Integration Guide

Adaptive Currency

Adaptive Currency

Multi-Language Checkout

समर्थित भाषाएँ

Automatic Tax Calculation

Business Tax ID Support

Discount Codes

Discount Codes

Validate Discount by Code

Smart Address Collection

Options

Minimal Address Mode

Phone Number Collection

Custom Fields

Available Field Types

Example

Custom Fields Guide

Privacy Policy & Terms Acceptance

Product Collections

Product Collections

Checkout Session Configuration

Checkout Sessions API

Checkout Integration Guide

Theme Customization

Design & Theme Customization

Theme Configuration Options

Color Configuration (Light/Dark Mode)

Example

Checkout Sessions API

Preview Checkout

Payment Methods

Integration Guide

​Adaptive Currency

Adaptive Currency

​Multi-Language Checkout

​समर्थित भाषाएँ

​Automatic Tax Calculation

​Business Tax ID Support

​Discount Codes

Discount Codes

Validate Discount by Code

​Smart Address Collection

​Options

​Minimal Address Mode

​Phone Number Collection

​Custom Fields

​Available Field Types

​Example

Custom Fields Guide

​Privacy Policy & Terms Acceptance

​Product Collections

Product Collections

​Checkout Session Configuration

Checkout Sessions API

Checkout Integration Guide

​Theme Customization

Design & Theme Customization

​Theme Configuration Options

​Color Configuration (Light/Dark Mode)

​Example

Adaptive Currency

Multi-Language Checkout

समर्थित भाषाएँ

Automatic Tax Calculation

Business Tax ID Support

Discount Codes

Smart Address Collection

Options

Minimal Address Mode

Phone Number Collection

Custom Fields

Available Field Types

Example

Privacy Policy & Terms Acceptance

Product Collections

Checkout Session Configuration

Theme Customization

Theme Configuration Options

Color Configuration (Light/Dark Mode)

Example