Platsbaserad prissättning med tillägg och betalningslänkar

Den här handledningen visar hur du implementerar platsbaserad prissättning med hjälp av Dodo Payments-tillägg. Du skapar en prenumerationsprodukt med tillägg för extra platser och genererar betalningslänkar med anpassade tilläggskvantiteter.

Den här handledningen använder Node.js och Express. Du kan anpassa koden för ditt ramverk (Next.js, React, Vue osv.) och anpassa användargränssnittet så att det passar din applikation.

I slutet av denna handledning kommer du att veta hur man:

Skapar prenumerationsprodukter med platsbaserad prissättning
Ställer in tillägg för ytterligare platser
Genererar betalningslänkar med anpassade tilläggsmängder
Hanterar kassa-sessioner med dynamiska platsantal

Vad vi bygger

Låt oss skapa en platsbaserad prissättningsmodell:

Basplan: $49/månad för upp till 5 teammedlemmar
Platstillägg: $2/månad per extra plats
Betalningslänkar: Dynamisk checkout med anpassade platskvantiteter

Innan vi börjar, se till att du har:

Ett Dodo Payments-konto
Grundläggande kunskaper om TypeScript/Node.js

Steg 1: Skapa ditt plats-tillägg

Skapa ett tillägg som representerar extra platser. Det här tillägget kopplas till din basprenumeration och gör det möjligt för kunder att köpa extra platser.

Det här bygger vi: Ett tillägg som kostar $2/månad per plats och kan läggas till i valfri basprenumeration.

Navigate to Add-Ons

I din Dodo Payments-instrumentpanel, håll dig kvar i avsnittet Products
Klicka på fliken Add-Ons
Klicka på Create Add-On

Detta öppnar formuläret för att skapa tillägg.

Enter add-on details

Fyll i de här värdena för vårt plats-tillägg:Add-On Name: Additional Team SeatDescription: Add extra team members to your workspace with full access to all featuresPrice: Enter → 2.00Valuta: Måste matcha din basprenumerationsvalutaSkattekategori: Välj lämplig kategori för din produkt.

Save your add-on

Granska alla dina inställningar:
- Namn: Ytterligare teamplats
- Pris: $2.00/månad
Klicka på Create Add-On

Tillägg skapat! Ditt plats-tillägg finns nu tillgängligt för att kopplas till prenumerationer.

Steg 2: Skapa din basprenumerationsprodukt

Skapa en basprenumerationsprodukt som inkluderar 5 teammedlemmar. Detta blir grunden för din platsbaserade prismodell.

Navigate to Products

Logga in på din Dodo Payments-instrumentpanel
Klicka på Products i vänstra sidomenyn
Klicka på knappen Create Product
Välj Subscription som produkttyp

Du bör nu se ett formulär där vi konfigurerar vår basprenumeration.

Fill in the subscription details

Nu anger vi de specifika detaljerna för vår basplan:Product Name: MotionDescription: Where your team's documentation lives.Recurring Price: Enter → 49.00Billing Cycle: Select → MonthlyCurrency: Select your preferred currency (e.g., USD)

Steg 3: Koppla tillägg till prenumeration

Koppla ditt platstillägg till basprenumerationen så att kunder kan köpa extra platser under checkout.

Attach the seat add-on

Koppla tillägg till prenumeration i instrumentpanelen

Scrolla ner till sektionen Tillägg
Klicka på Lägg till Tillägg
Välj ditt plats-tillägg från rullgardinsmenyn
Bekräfta att det visas i din prenumerationskonfiguration

Save subscription changes

Granska din fullständiga prenumerationskonfiguration:
- Basplan: $49/månad för 5 platser
- Tillägg: $2/månad per ytterligare plats
Klicka på Spara ändringar

Platsbaserad prissättning har konfigurerats! Kunder kan nu köpa din basplan och lägga till extra platser efter behov.

Steg 4: Generera betalningslänkar med anpassade tilläggskvantiteter

Skapa en Express.js-applikation som genererar betalningslänkar med anpassade tilläggskvantiteter. Detta gör att du dynamiskt kan skapa checkout-sessioner med valfritt antal extra platser.

Set up your project

Skapa ett nytt Node.js-projekt och installera de nödvändiga beroendena:

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

Skapa en tsconfig.json-fil:

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

Create your environment file

Skapa en .env-fil med din Dodo Payments API-nyckel:

DODO_PAYMENTS_API_KEY=your_actual_dodo_api_key_here

Checka aldrig in din API-nyckel i versionshanteringen. Lägg till .env i din .gitignore-fil.

Implement the checkout session creation

Skapa en src/server.ts-fil med följande kod:

// 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

Skapa en public/index.html-fil för enkel testning:

<!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>

Webbgränssnittet har skapats! Du har nu ett enkelt användargränssnitt för att testa olika platskvantiteter.

Serve static files

Lägg till detta i din src/server.ts för att visa HTML-filen:

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

Statiska filer har konfigurerats! Besök http://localhost:3000 för att se ditt demogränssnitt.

Steg 5: Testa din implementation

Låt oss testa vår platsbaserade prismodell för att säkerställa att allt fungerar korrekt.

Start your server

Se till att du har din .env-fil med rätt API-nyckel
Uppdatera produkt- och tilläggs-ID:na i koden med de faktiska värdena från din Dodo Payments-instrumentpanel
Starta servern:

npx ts-node src/server.ts

Servern bör starta utan problem och visa “Server is running on port 3000”

Test the web interface

Demogränssnitt för platsbaserad prissättning

Öppna webbläsaren och gå till http://localhost:3000
Du bör se demogränssnittet för platsbaserad prissättning
Testa olika platskvantiteter (0, 3, 10 osv.)
Klicka på “Generate Checkout Link” för varje kvantitet
Kontrollera att checkout-URL:erna genereras korrekt

Test a checkout session

Generera en checkout-länk med 3 extra platser
Klicka på checkout-URL:en för att öppna Dodo Payments checkout
Kontrollera att checkout visar:
- Basplan: $49/månad
- Extra platser: 3 × 2 dollar = $6/månad
Slutför testköpet

Checkout bör visa rätt prisuppdelning och låta dig slutföra köpet.

Listen for webhooks and update your database

Håll din databas synkroniserad med ändringar av prenumerationer och platser genom att lyssna efter webhook-händelser från Dodo Payments. Webhooks meddelar din backend när en kund slutför checkout, uppdaterar sin prenumeration eller ändrar antalet platser.Följ den officiella Dodo Payments-guiden för webhooks för stegvisa instruktioner om hur du konfigurerar webhook-endpoints och hanterar händelser:

Dodo Payments Webhooks Documentation

Lär dig hur du tar emot och bearbetar webhook-händelser för prenumerations- och platshantering på ett säkert sätt.

Felsökning

Vanliga problem och deras lösningar:

Checkout creation failing

Möjliga orsaker:

Ogiltigt produkt-ID eller tilläggs-ID
API-nyckeln har inte tillräckliga behörigheter
Tillägget är inte korrekt kopplat till prenumerationen
Problem med nätverksanslutningen

Lösningar:

Kontrollera att produkt- och tilläggs-ID:na finns i din Dodo Payments-instrumentpanel
Kontrollera att tillägget är korrekt kopplat till prenumerationen
Säkerställ att API-nyckeln har behörighet att skapa checkout-sessioner
Testa API-anslutningen med en enkel GET-begäran

Grattis! Du har implementerat platsbaserad prissättning

Du har skapat ett platsbaserat prissättningssystem med Dodo Payments. Här är vad du har åstadkommit:

Base Subscription

Skapat en prenumerationsprodukt med 5 inkluderade platser för $49/månad

Seat Add-ons

Konfigurerat tillägg för extra platser för $2/månad per plats

Checkout

Byggt ett API som genererar checkout-sessioner med anpassade platskvantiteter

Web Interface

Skapat ett enkelt webgränssnitt för att testa olika platskvantiteter

Det här exemplet visar en minimal implementation av platsbaserad prissättning. För produktionsanvändning bör du lägga till felhantering, autentisering, datavalidering och säkerhetsåtgärder samt anpassa logiken efter din applikations krav.

Integration Guides

Billing Deconstructions

Cookbooks

Platsbaserad prissättning med tillägg och betalningslänkar

Vad vi bygger

Steg 1: Skapa ditt plats-tillägg

Steg 2: Skapa din basprenumerationsprodukt

Steg 3: Koppla tillägg till prenumeration

Steg 4: Generera betalningslänkar med anpassade tilläggskvantiteter

Steg 5: Testa din implementation

Dodo Payments Webhooks Documentation

Felsökning

Grattis! Du har implementerat platsbaserad prissättning

Base Subscription

Seat Add-ons

Checkout

Web Interface

​Vad vi bygger

​Steg 1: Skapa ditt plats-tillägg

​Steg 2: Skapa din basprenumerationsprodukt

​Steg 3: Koppla tillägg till prenumeration

​Steg 4: Generera betalningslänkar med anpassade tilläggskvantiteter

​Steg 5: Testa din implementation

Dodo Payments Webhooks Documentation

​Felsökning

​Grattis! Du har implementerat platsbaserad prissättning

Base Subscription

Seat Add-ons

Checkout

Web Interface

Vad vi bygger

Steg 1: Skapa ditt plats-tillägg

Steg 2: Skapa din basprenumerationsprodukt

Steg 3: Koppla tillägg till prenumeration

Steg 4: Generera betalningslänkar med anpassade tilläggskvantiteter

Steg 5: Testa din implementation

Felsökning

Grattis! Du har implementerat platsbaserad prissättning