सीट-आधारित मूल्य निर्धारण के साथ ऐड-ऑन और भुगतान लिंक

यह tutorial Dodo Payments add-ons का उपयोग करके seat-based pricing लागू करने का तरीका दिखाता है। आप add-ons के साथ एक subscription product बनाएँगे, जिसमें अतिरिक्त seats के लिए add-ons होंगे, और custom add-on quantities के साथ payment links जनरेट करेंगे।

यह tutorial Node.js और Express का उपयोग करता है। आप अपने framework (Next.js, React, Vue आदि) के लिए code को अनुकूलित कर सकते हैं और अपने application के अनुरूप UI को customize कर सकते हैं।

इस ट्यूटोरियल के अंत तक, आप जानेंगे कि:

सीट-आधारित मूल्य निर्धारण के साथ सदस्यता उत्पाद कैसे बनाएं
अतिरिक्त सीटों के लिए ऐड-ऑन कैसे सेट करें
कस्टम ऐड-ऑन मात्रा के साथ भुगतान लिंक कैसे उत्पन्न करें
गतिशील सीट गिनती के साथ चेकआउट सत्र कैसे संभालें

हम क्या बना रहे हैं

आइए एक सीट-आधारित मूल्य निर्धारण मॉडल बनाते हैं:

Base Plan: अधिकतम 5 team members के लिए $49/month
Seat Add-on: प्रत्येक अतिरिक्त seat के लिए $2/month
Payment Links: custom seat quantities के साथ dynamic checkout

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

एक Dodo Payments खाता
TypeScript/Node.js की बुनियादी जानकारी

चरण 1: अपना सीट ऐड-ऑन बनाएं

अतिरिक्त seats को दर्शाने वाला एक add-on बनाएँ। यह add-on आपके base subscription से जुड़ा होगा और customers को अतिरिक्त seats खरीदने की अनुमति देगा।

हम क्या बना रहे हैं: एक ऐसा add-on जिसकी कीमत प्रति seat $2/month है और जिसे किसी भी base subscription में जोड़ा जा सकता है।

Navigate to Add-Ons

अपने Dodo Payments डैशबोर्ड में, Products सेक्शन में बने रहें
Add-Ons टैब पर क्लिक करें
Create Add-On पर क्लिक करें

यह एड-ऑन निर्माण फ़ॉर्म खोलेगा।

Enter add-on details

हमारे सीट एड-ऑन के लिए इन मानों को भरें:Add-On Name: Additional Team SeatDescription: Add extra team members to your workspace with full access to all featuresPrice: Enter → 2.00मुद्रा: आपकी बेस सदस्यता मुद्रा से मेल खाना चाहिएकर श्रेणी: अपने उत्पाद के लिए उपयुक्त श्रेणी चुनें।

Save your add-on

अपनी सभी settings की समीक्षा करें:
- Name: Additional Team Seat
- Price: $2.00/month
Create Add-On पर click करें

एड-ऑन बन गया! आपका सीट एड-ऑन अब सब्सक्रिप्शन में जोड़ने के लिए उपलब्ध है।

चरण 2: अपना बेस सदस्यता उत्पाद बनाएं

ऐसा base subscription product बनाएँ जिसमें 5 team members शामिल हों। यह आपके seat-based pricing model का आधार होगा।

Navigate to Products

अपने Dodo Payments डैशबोर्ड में लॉग इन करें
बाएँ साइडबार में Products पर क्लिक करें
Create Product बटन पर क्लिक करें
प्रोडक्ट टाइप के रूप में Subscription चुनें

आपको एक फ़ॉर्म दिखाई देगा जहाँ हम अपनी बेस सब्सक्रिप्शन को कॉन्फ़िगर करेंगे।

Fill in the subscription details

अब हम अपने बेस प्लान के विशिष्ट विवरण भरेंगे:Product Name: MotionDescription: Where your team's documentation lives.Recurring Price: Enter → 49.00Billing Cycle: Select → MonthlyCurrency: अपनी पसंदीदा मुद्रा चुनें (उदा., USD)

चरण 3: सदस्यता से ऐड-ऑन को कनेक्ट करें

अपने seat add-on को base subscription से associate करें, ताकि customers checkout के दौरान अतिरिक्त seats खरीद सकें।

Attach the seat add-on

dashboard में subscription से add-on जोड़ना

ऐड-ऑन अनुभाग में स्क्रॉल करें
ऐड-ऑन जोड़ें पर क्लिक करें
ड्रॉपडाउन से अपने सीट ऐड-ऑन का चयन करें
पुष्टि करें कि यह आपकी सदस्यता कॉन्फ़िगरेशन में दिखाई दे रहा है

Save subscription changes

अपनी पूरी subscription setup की समीक्षा करें:
- Base plan: $49/माह 5 seats के लिए
- Add-on: $2/माह प्रत्येक अतिरिक्त seat के लिए
परिवर्तन सहेजें पर क्लिक करें

Seat-based pricing configure हो गई है! अब customers आपका base plan खरीद सकते हैं और आवश्यकतानुसार अतिरिक्त seats जोड़ सकते हैं।

Step 4: Custom Add-on Quantities के साथ Payment Links जनरेट करें

ऐसा Express.js application बनाएँ जो custom add-on quantities के साथ payment links जनरेट करे। इससे आप किसी भी संख्या में अतिरिक्त seats के साथ checkout sessions को dynamically create कर सकेंगे।

Set up your project

एक नया Node.js project बनाएँ और आवश्यक dependencies install करें:

mkdir seat-based-pricing
cd seat-based-pricing
npm init -y
npm install dodopayments express dotenv
npm install -D @types/node @types/express typescript ts-node

एक tsconfig.json file बनाएँ:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

Create your environment file

अपनी Dodo Payments API key के साथ एक .env file बनाएँ:

DODO_PAYMENTS_API_KEY=your_actual_dodo_api_key_here

अपनी API key को version control में कभी commit न करें। अपनी .gitignore file में .env जोड़ें।

Implement the checkout session creation

निम्नलिखित code के साथ एक src/server.ts file बनाएँ:

// Add this new endpoint for dynamic seat quantities
import 'dotenv/config';
import DodoPayments from 'dodopayments';
import express, { Request, Response } from 'express';

const app = express();

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

async function createCheckoutSession(seatCount: number) {
  try {
    const session = await client.checkoutSessions.create({
      // Products to sell - use IDs from your Dodo Payments dashboard
      product_cart: [
        {
          product_id: 'pdt_7Rl9OWT2Mz4wwUTKz74iZ', // Replace with your actual product ID
          quantity: 1,
          addons: [
            {
              addon_id: 'adn_eKQbNakKrivDpaxmI8wKI', // Replace with your actual addon ID
              quantity: seatCount
            }
          ]
        }
      ],
      
      // Pre-fill customer information to reduce friction
      customer: {
        email: 'steve@example.com',
        name: 'Steve Irwin',
      },
      // Where to redirect after successful payment
      return_url: 'https://example.com/checkout/success',
    });

    // 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/:seatCount', async (req: Request, res: Response) => {
  try {
    const seatCount = parseInt(req.params.seatCount);
    const session = await createCheckoutSession(seatCount);
    // Demo pricing from this tutorial: $49 base + $2 per additional seat
    res.json({ checkout_url: session.checkout_url, total_cost: 49 + seatCount * 2 });
  } catch (error) {
    res.status(500).json({ error: 'Failed to create checkout session' });
  }
});

// Add this line after your other middleware
app.use(express.static('public'));

// Add this route to serve the demo page
app.get('/', (req, res) => {
  res.sendFile(__dirname + '/../public/index.html');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

Add a simple web interface

आसान testing के लिए एक public/index.html file बनाएँ:

<!DOCTYPE html>
<html>
<head>
    <title>Seat-Based Pricing Demo</title>
    <style>
        body { font-family: Arial, sans-serif; max-width: 600px; margin: 50px auto; padding: 20px; }
        .form-group { margin: 20px 0; }
        label { display: block; margin-bottom: 5px; font-weight: bold; }
        input { width: 100%; padding: 10px; border: 1px solid #ddd; border-radius: 4px; }
        button { background: #007bff; color: white; padding: 10px 20px; border: none; border-radius: 4px; cursor: pointer; }
        button:hover { background: #0056b3; }
        .result { margin-top: 20px; padding: 15px; background: #f8f9fa; border-radius: 4px; }
    </style>
</head>
<body>
    <h1>Seat-Based Pricing Demo</h1>
    <p>Generate checkout links with custom seat quantities:</p>
    
    <div class="form-group">
        <label for="seatCount">Number of Additional Seats:</label>
        <input type="number" id="seatCount" value="3" min="0" max="50">
    </div>
    
    <button onclick="createCheckout()">Generate Checkout Link</button>
    
    <div id="result" class="result" style="display: none;">
        <h3>Checkout Link Generated!</h3>
        <p><strong>Seat Count:</strong> <span id="seatCountDisplay"></span></p>
        <p><strong>Total Cost:</strong> $<span id="totalCost"></span>/month</p>
        <p><strong>Checkout URL:</strong></p>
        <a id="checkoutUrl" href="#" target="_blank">Click here to checkout</a>
    </div>

    <script>
        async function createCheckout() {
            const seatCount = document.getElementById('seatCount').value;
            
            try {
                const response = await fetch(`/create-checkout/${seatCount}`, {
                    method: 'POST'
                });
                
                const data = await response.json();
                
                if (response.ok) {
                    document.getElementById('seatCountDisplay').textContent = seatCount;
                    document.getElementById('totalCost').textContent = data.total_cost;
                    document.getElementById('checkoutUrl').href = data.checkout_url;
                    document.getElementById('result').style.display = 'block';
                } else {
                    alert('Error: ' + data.error);
                }
            } catch (error) {
                alert('Error creating checkout session');
            }
        }
    </script>
</body>
</html>

Web interface बन गया है! अब आपके पास अलग-अलग seat quantities को test करने के लिए एक simple UI है।

Serve static files

HTML file serve करने के लिए इसे अपनी src/server.ts में जोड़ें:

// Add this line after your other middleware
app.use(express.static('public'));

// Add this route to serve the demo page
app.get('/', (req, res) => {
  res.sendFile(__dirname + '/../public/index.html');
});

Static files configure हो गई हैं! अपना demo interface देखने के लिए http://localhost:3000 पर जाएँ।

Step 5: अपने Implementation का परीक्षण करें

यह सुनिश्चित करने के लिए अपने seat-based pricing implementation का परीक्षण करें कि सब कुछ सही तरीके से काम कर रहा है।

Start your server

सुनिश्चित करें कि आपकी .env file में सही API key है
अपने code में product और add-on IDs को अपने Dodo Payments dashboard की वास्तविक values से update करें
अपना server शुरू करें:

npx ts-node src/server.ts

आपका server सफलतापूर्वक शुरू होना चाहिए और “Server is running on port 3000” दिखाना चाहिए।

Test the web interface

अपना browser खोलें और http://localhost:3000 पर जाएँ
आपको seat-based pricing demo interface दिखाई देना चाहिए
अलग-अलग seat quantities (0, 3, 10 आदि) आज़माएँ
प्रत्येक quantity के लिए “Generate Checkout Link” पर click करें
सत्यापित करें कि checkout URLs सही तरीके से जनरेट हुए हैं

Test a checkout session

3 अतिरिक्त seats के साथ एक checkout link जनरेट करें
Dodo Payments checkout खोलने के लिए checkout URL पर click करें
सत्यापित करें कि checkout में यह दिखाई देता है:
- Base plan: $49/month
- Additional seats: 3 × 2 dollars = $6/month
test purchase पूरा करें

checkout में pricing breakdown सही दिखाई देना चाहिए और आपको purchase पूरा करने की अनुमति मिलनी चाहिए।

Listen for webhooks and update your database

Dodo Payments से webhook events सुनकर अपने database को subscription और seat changes के साथ sync रखें। जब कोई customer checkout पूरा करता है, अपनी subscription update करता है या seat counts बदलता है, तब webhooks आपके backend को notify करते हैं।webhook endpoints configure करने और events handle करने के step-by-step instructions के लिए official Dodo Payments webhooks guide देखें:

Dodo Payments Webhooks Documentation

subscription और seat management के लिए webhook events को securely receive और process करना सीखें।

Troubleshooting

सामान्य समस्याएँ और उनके समाधान:

Checkout creation failing

संभावित कारण:

Invalid product ID या add-on ID
API key के पास पर्याप्त permissions नहीं हैं
Add-on subscription से सही तरीके से associate नहीं है
Network connectivity issues

समाधान:

सत्यापित करें कि product और add-on IDs आपके Dodo Payments dashboard में मौजूद हैं
जाँचें कि add-on subscription से सही तरीके से जुड़ा है
सुनिश्चित करें कि API key के पास checkout session creation permissions हैं
एक simple GET request के साथ API connectivity का परीक्षण करें

बधाई हो! आपने Seat-Based Pricing लागू कर दी है

आपने Dodo Payments के साथ seat-based pricing system सफलतापूर्वक बनाया है। आपने यह सब किया:

Base Subscription

5 included seats वाला subscription product बनाया, जिसकी कीमत $49/month है

Seat Add-ons

अतिरिक्त seats के लिए प्रति seat $2/month की दर से add-ons configure किए

Checkout

custom seat quantities के साथ checkout sessions जनरेट करने वाला API बनाया

Web Interface

अलग-अलग seat quantities को test करने के लिए एक simple web interface बनाया

यह example seat-based pricing के minimal implementation को दर्शाता है। Production use के लिए error handling, authentication, data validation और security measures जोड़ें, और logic को अपने application की आवश्यकताओं के अनुसार अनुकूलित करें।

Integration Guides

Billing Deconstructions

Cookbooks

सीट-आधारित मूल्य निर्धारण के साथ ऐड-ऑन और भुगतान लिंक

हम क्या बना रहे हैं

चरण 1: अपना सीट ऐड-ऑन बनाएं

चरण 2: अपना बेस सदस्यता उत्पाद बनाएं

चरण 3: सदस्यता से ऐड-ऑन को कनेक्ट करें

Step 4: Custom Add-on Quantities के साथ Payment Links जनरेट करें

Step 5: अपने Implementation का परीक्षण करें

Dodo Payments Webhooks Documentation

Troubleshooting

बधाई हो! आपने Seat-Based Pricing लागू कर दी है

Base Subscription

Seat Add-ons

Checkout

Web Interface

​हम क्या बना रहे हैं

​चरण 1: अपना सीट ऐड-ऑन बनाएं

​चरण 2: अपना बेस सदस्यता उत्पाद बनाएं

​चरण 3: सदस्यता से ऐड-ऑन को कनेक्ट करें

​Step 4: Custom Add-on Quantities के साथ Payment Links जनरेट करें

​Step 5: अपने Implementation का परीक्षण करें

Dodo Payments Webhooks Documentation

​Troubleshooting

​बधाई हो! आपने Seat-Based Pricing लागू कर दी है

Base Subscription

Seat Add-ons

Checkout

Web Interface

हम क्या बना रहे हैं

चरण 1: अपना सीट ऐड-ऑन बनाएं

चरण 2: अपना बेस सदस्यता उत्पाद बनाएं

चरण 3: सदस्यता से ऐड-ऑन को कनेक्ट करें

Step 4: Custom Add-on Quantities के साथ Payment Links जनरेट करें

Step 5: अपने Implementation का परीक्षण करें

Troubleshooting

बधाई हो! आपने Seat-Based Pricing लागू कर दी है