Mobilintegrationsguide

​

Förutsättningar

• Dodo Payments-konto: Ett aktivt merchant-konto med API-åtkomst
• API-uppgifter: API-nyckel och webhook secret key från din dashboard
• Mobilappsprojekt: En Android-, iOS-, React Native- eller Flutter-applikation
• Backend-server: För säker hantering av skapandet av checkout-sessioner

​

Integreringsflöde

func getCheckoutURL(productId: String, customerEmail: String, customerName: String) async throws -> String {
    let url = URL(string: "https://your-backend.com/api/create-checkout-session")!
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.setValue("Bearer \(userSessionToken)", forHTTPHeaderField: "Authorization")
    
    let requestData: [String: Any] = [
        "productId": productId,
        "customerEmail": customerEmail,
        "customerName": customerName
    ]
    request.httpBody = try JSONSerialization.data(withJSONObject: requestData)
    
    let (data, _) = try await URLSession.shared.data(for: request)
    let response = try JSONDecoder().decode(CheckoutResponse.self, from: data)
    return response.checkout_url
}

suspend fun getCheckoutURL(productId: String, customerEmail: String, customerName: String): String {
    val client = OkHttpClient()
    val requestBody = JSONObject().apply {
        put("productId", productId)
        put("customerEmail", customerEmail)
        put("customerName", customerName)
    }.toString().toRequestBody("application/json".toMediaType())
    
    val request = Request.Builder()
        .url("https://your-backend.com/api/create-checkout-session")
        .header("Authorization", "Bearer $userSessionToken")
        .post(requestBody)
        .build()
    
    val response = client.newCall(request).execute()
    val responseBody = response.body?.string()
    val jsonResponse = JSONObject(responseBody ?: "")
    return jsonResponse.getString("checkout_url")
}

const getCheckoutURL = async (productId, customerEmail, customerName) => {
  try {
    const response = await fetch('https://your-backend.com/api/create-checkout-session', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${userSessionToken}`,
      },
      body: JSON.stringify({
        productId,
        customerEmail,
        customerName
      })
    });
    
    const data = await response.json();
    return data.checkout_url;
  } catch (error) {
    console.error('Failed to get checkout URL:', error);
    throw error;
  }
};

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<String> getCheckoutUrl({
  required String productId,
  required String customerEmail,
  required String customerName,
}) async {
  final response = await http.post(
    Uri.parse('https://your-backend.com/api/create-checkout-session'),
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer $userSessionToken',
    },
    body: jsonEncode({
      'productId': productId,
      'customerEmail': customerEmail,
      'customerName': customerName,
    }),
  );

  if (response.statusCode != 200) {
    throw Exception('Failed to get checkout URL: ${response.statusCode}');
  }
  return jsonDecode(response.body)['checkout_url'] as String;
}

​

Välj ditt SDK

​

Registrera ett callback-URL-schema

android {
    defaultConfig {
        manifestPlaceholders["dodoCallbackScheme"] = "myapp"
    }
}

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>myapp</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>myapp</string>
    </array>
  </dict>
</array>

{
  "expo": {
    "scheme": "myapp",
    "plugins": [
      [
        "@dodopayments/react-native-checkout",
        { "scheme": "myappcheckout" }
      ]
    ]
  }
}

​

Anpassa utseendet

const result = await DodoCheckout.start({
  checkoutUrl,
  returnUrl: 'myapp://checkout/return',
  customization: {
    android: { toolbarColor: '#6366F1', closeButtonStyle: 'back' },
    ios: { presentationStyle: 'fullScreen', colorScheme: 'dark' },
  },
});

final result = await DodoCheckout.instance.start(
  CheckoutParams(
    checkoutUrl: Uri.parse(checkoutUrl),
    returnUrl: Uri.parse('myapp://checkout/return'),
    customization: BrowserCustomization(
      android: AndroidBrowserOptions(
        toolbarColor: Color(0xFF6366F1),
        closeButtonStyle: CloseButtonStyle.back,
      ),
      ios: IosBrowserOptions(
        presentationStyle: PresentationStyle.fullScreen,
        colorScheme: BrowserColorScheme.dark,
      ),
    ),
  ),
);

val result = DodoCheckout.start(
    activity,
    CheckoutParams(
        checkoutUrl = checkoutUrl,
        returnUrl = "myapp://checkout/return",
        customization = BrowserCustomization(
            toolbarColor = Color.parseColor("#6366F1"),
            closeButtonStyle = BrowserCustomization.CloseButtonStyle.BACK,
        )
    )
) { event -> }

let result = try await DodoCheckout.start(
    checkoutUrl: checkoutUrl,
    returnUrl: URL(string: "myapp://checkout/return")!,
    customization: BrowserCustomization(
        presentationStyle: .fullScreen,
        colorScheme: .dark
    )
)

​

Anpassa checkout-sidan

​

Mobiloptimerade recept

Minimal Mobile Checkout - fastest path to payment

Använd detta när du vill ha ett så kort formulär som möjligt: betalningsmetoderna högst upp, endast postnummer krävs för adressen, inget rabattfält och temat matchar enheten.

• Node.js SDK
• Python SDK

import DodoPayments from 'dodopayments';

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

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_your_product_id', quantity: 1 }],
  customer: { email: 'user@example.com', name: 'Jane Smith' },
  billing_address: { country: 'US' },
  return_url: 'myapp://checkout/success',
  cancel_url: 'myapp://checkout/cancelled',
  billing_currency: 'USD',
  minimal_address: true,
  customization: {
    show_order_details: false,
    theme: 'system',
  },
  feature_flags: {
    allow_discount_code: false,
    allow_currency_selection: false,
  },
});

console.log(session.checkout_url);

See all 26 lines

import os
import dodopayments

client = dodopayments.DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

session = client.checkout_sessions.create(
    product_cart=[{"product_id": "pdt_your_product_id", "quantity": 1}],
    customer={"email": "user@example.com", "name": "Jane Smith"},
    billing_address={"country": "US"},
    return_url="myapp://checkout/success",
    cancel_url="myapp://checkout/cancelled",
    billing_currency="USD",
    minimal_address=True,
    customization={
        "show_order_details": False,
        "theme": "system",
    },
    feature_flags={
        "allow_discount_code": False,
        "allow_currency_selection": False,
    },
)

print(session.checkout_url)

See all 27 lines

Se Checkout Sessions för alla tillgängliga parametrar och deras standardvärden.

Branded Mobile Checkout - custom colors, fonts, and button label

Använd detta när checkout-sidan ska kännas som en del av appen. Ange dina varumärkesfärger, ett anpassat typsnitt och en lokaliserad etikett på betalningsknappen.

• Node.js SDK
• Python SDK

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_your_product_id', quantity: 1 }],
  customer: { email: 'user@example.com', name: 'Jane Smith' },
  billing_address: { country: 'US' },
  billing_currency: 'USD',
  return_url: 'myapp://checkout/success',
  minimal_address: true,
  customization: {
    show_order_details: false,
    theme: 'dark',
    theme_config: {
      dark: {
        button_primary: '#7C3AED',
        button_primary_hover: '#6D28D9',
        button_text_primary: '#FFFFFF',
        bg_primary: '#1A1A2E',
        bg_secondary: '#16213E',
        text_primary: '#E2E8F0',
      },
      pay_button_text: 'Complete Purchase',
      radius: '8px',
    },
  },
});

See all 24 lines

session = client.checkout_sessions.create(
    product_cart=[{"product_id": "pdt_your_product_id", "quantity": 1}],
    customer={"email": "user@example.com", "name": "Jane Smith"},
    billing_address={"country": "US"},
    billing_currency="USD",
    return_url="myapp://checkout/success",
    minimal_address=True,
    customization={
        "show_order_details": False,
        "theme": "dark",
        "theme_config": {
            "dark": {
                "button_primary": "#7C3AED",
                "button_primary_hover": "#6D28D9",
                "button_text_primary": "#FFFFFF",
                "bg_primary": "#1A1A2E",
                "bg_secondary": "#16213E",
                "text_primary": "#E2E8F0",
            },
            "pay_button_text": "Complete Purchase",
            "radius": "8px",
        },
    },
)

See all 24 lines

theme_config accepterar separata dark- och light-objekt så att paletten anpassas efter enhetens aktuella utseende. Se Checkout Sessions för en fullständig referens över färgnycklar.

One-Click Returning Customer - saved card, instant confirmation

Använd detta för inloggade användare som har betalat tidigare. Kombinera ett kund-ID, kundens sparade betalningsmetod och confirm: true för att hoppa över checkout-formuläret helt.

• Node.js SDK
• Python SDK

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_your_product_id', quantity: 1 }],
  customer: { customer_id: 'cus_returning_customer_id' },
  billing_address: { country: 'US' },
  billing_currency: 'USD',
  return_url: 'myapp://checkout/success',
  payment_method_id: 'pm_saved_payment_method_id',
  confirm: true,
  show_saved_payment_methods: true,           // top-level parameter
  feature_flags: { redirect_immediately: true },
});

See all 11 lines

session = client.checkout_sessions.create(
    product_cart=[{"product_id": "pdt_your_product_id", "quantity": 1}],
    customer={"customer_id": "cus_returning_customer_id"},
    billing_address={"country": "US"},
    billing_currency="USD",
    return_url="myapp://checkout/success",
    payment_method_id="pm_saved_payment_method_id",
    confirm=True,
    show_saved_payment_methods=True,           # top-level parameter
    feature_flags={"redirect_immediately": True},
)

See all 11 lines

status i deep-link-returen är endast en UI-ledtråd. Bekräfta åtkomst genom att lyssna efter payment.succeeded-webhooken på din backend.

Subscription with Free Trial - trial before first charge

Använd detta för prenumerationsprodukter som erbjuder en kostnadsfri provperiod före den första faktureringscykeln.

• Node.js SDK
• Python SDK

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_your_subscription_product_id', quantity: 1 }],
  customer: { email: 'user@example.com', name: 'Jane Smith' },
  billing_address: { country: 'US' },
  billing_currency: 'USD',
  return_url: 'myapp://subscription/activated',
  cancel_url: 'myapp://subscription/cancelled',
  minimal_address: true,
  customization: {
    show_order_details: false,
    theme: 'system',
  },
  subscription_data: { trial_period_days: 14 },
});

See all 14 lines

session = client.checkout_sessions.create(
    product_cart=[{"product_id": "pdt_your_subscription_product_id", "quantity": 1}],
    customer={"email": "user@example.com", "name": "Jane Smith"},
    billing_address={"country": "US"},
    billing_currency="USD",
    return_url="myapp://subscription/activated",
    cancel_url="myapp://subscription/cancelled",
    minimal_address=True,
    customization={"show_order_details": False, "theme": "system"},
    subscription_data={"trial_period_days": 14},
)

See all 11 lines

Ge åtkomst till funktionen när din backend tar emot subscription.active-webhooken – inte när mobil-SDK:t returnerar. Se Subscription Integration Guide för det fullständiga webhook-flödet.

On-Demand Mandate - save a card for future variable charges

Använd detta för att tokenisera en kunds kort för senare debiteringar (påfyllning av wallet, pay-as-you-go och BNPL) utan att visa etiketten “subscription”. Kunden auktoriserar sin betalningsmetod en gång; därefter debiterar du varierande belopp vid behov.

Detta mönster används av appar som debiterar baserat på användning – till exempel en astrologiapp som debiterar per session från ett förauktoriserat kort i stället för enligt ett fast schema.

• Node.js SDK
• Python SDK

// Step 1: Authorize the mandate (no charge yet)
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_your_subscription_product_id', quantity: 1 }],
  customer: { email: 'user@example.com', name: 'Jane Smith' },
  billing_address: { country: 'US' },
  billing_currency: 'USD',
  return_url: 'myapp://mandate/authorized',
  cancel_url: 'myapp://mandate/cancelled',
  minimal_address: true,
  customization: {
    show_order_details: false,
    show_on_demand_tag: false, // hides the "on-demand" / "subscription" label
    theme: 'system',
  },
  subscription_data: {
    on_demand: { mandate_only: true },
  },
});

// Step 2: Later, charge any amount using the subscription ID
// (received via the subscription.active webhook after mandate authorization)
// await client.subscriptions.charge(subscriptionId, {
//   product_price: 2000,         // $20.00 in cents
//   product_currency: 'USD',
//   product_description: 'Session credits',
// });

See all 26 lines

# Step 1: Authorize the mandate (no charge yet)
session = client.checkout_sessions.create(
    product_cart=[{"product_id": "pdt_your_subscription_product_id", "quantity": 1}],
    customer={"email": "user@example.com", "name": "Jane Smith"},
    billing_address={"country": "US"},
    billing_currency="USD",
    return_url="myapp://mandate/authorized",
    cancel_url="myapp://mandate/cancelled",
    minimal_address=True,
    customization={
        "show_order_details": False,
        "show_on_demand_tag": False,  # hides the "on-demand" / "subscription" label
        "theme": "system",
    },
    subscription_data={"on_demand": {"mandate_only": True}},
)

# Step 2: Later, charge any amount using the subscription ID
# client.subscriptions.charge(subscription_id, {
#     "product_price": 2000,  # $20.00 in cents
#     "product_currency": "USD",
#     "product_description": "Session credits",
# })

See all 23 lines

On-demand-debiteringar kräver minst 1 USD (100 cent). Belopp under 1 USD avvisas med "value out of range". För en auktorisering med beloppet noll använder du mandate_only: true enligt exemplet ovan och debiterar sedan minst 1 USD i efterföljande anrop.

Se On-Demand Subscriptions för det fullständiga debiteringsflödet, webhook-händelser och retry-policyer.

​

Prenumerationsflöden från mobil

​

Vanliga återkommande prenumerationer

​

On-demand-prenumerationer

• Ange show_on_demand_tag: false så att checkout-sidan inte visar formuleringar om “subscription” eller “on-demand”. Vid användningsfall för korttokenisering förväntar sig kunderna inte prenumerationsterminologi.
• När mandatet har auktoriserats tar din backend emot subscription.active. Spara subscription_id – du kommer att använda det för alla framtida debiteringar.

​

Prenumeration med kostnadsfri provperiod

​

Uppgraderingar och nedgraderingar

​

Minska avhopp i checkout

​

Optimera formuläret

​

Förifyll kunduppgifter

• Nya kunder – ange customer.email och customer.name från din auth-session.
• Återkommande kunder – ange customer.customer_id för att automatiskt förifylla alla sparade uppgifter.
• Valuta – skicka alltid billing_currency och billing_address.country tillsammans.

​

Återställningsverktyg

​

Bästa praxis

• Säkerhet: Skicka aldrig en API-nyckel i appen. Skapa checkout-sessioner på din backend och skicka endast den resulterande checkout_url till klienten.
• Auktoritet: Behandla CheckoutResult.status som en UI-ledtråd. Ge åtkomst först när din backend har bekräftat betalningen.
• Användarupplevelse: Visa ett laddningstillstånd medan din backend skapar sessionen och hantera cancelled som ett normalt resultat, inte som ett fel.
• Testning: Använd test mode och testkort, och verifiera rundresan via return-URL på både en riktig enhet och en simulator.
• Konvertering: Ange show_order_details: false och minimal_address: true för bästa slutförandegrad i mobil checkout. Att flytta upp betalningsmetoderna och minska antalet formulärfält är de två förändringar som ger störst effekt.
• Valuta: Skicka alltid både billing_currency och billing_address.country uttryckligen – om någon saknas kan Adaptive Currency ändra faktureringsvalutan baserat på kundens IP-adress.
• On-demand-fakturering: Ange show_on_demand_tag: false när du använder on-demand-prenumerationer för korttokenisering. Kunder som använder ett flöde för påfyllning av wallet förväntar sig inte att se formuleringar om “subscription”.
• Återställning: Aktivera återställning av övergivna kundvagnar i din Dodo Payments-dashboard för att automatiskt återengagera kunder som inte slutför checkout.

​

Felsökning

​

Vanliga problem

• Callback kommer aldrig fram: Schemat i returnUrl måste matcha det du registrerade. På Android är det manifestets dodoCallbackScheme-platshållare; på iOS och React Native är det Info.plist URL type.
• Checkout återgår till webbläsaren i stället för appen (iOS): Du har inte vidarebefordrat den inkommande URL:en. Anropa DodoCheckout.handleOpenURL(url) från .onOpenURL, scene(_:openURLContexts:) eller en React Native Linking-lyssnare.
• PLATFORM_ERROR på Android: Oftast beror det på att schemat inte matchar. Det kan även inträffa om din MainActivity anger android:taskAffinity="" (standardvärdet flutter create), vilket gör att vissa OEM-versioner tappar den pågående checkouten.
• ALREADY_IN_PROGRESS: En checkout är fortfarande öppen. Vänta på eller stäng den föregående innan du startar en ny.
• Bygget misslyckas med en olöst platshållare: Du lade till Android SDK men ställde aldrig in manifestPlaceholders["dodoCallbackScheme"].
• Betalningen lyckades men åtkomst beviljades inte: Förväntat om du baserar dig på mobilresultatet. Ge i stället åtkomst från payment.succeeded / subscription.active-webhooken.
• Apple Pay / Google Pay visas inte på mobil: Checkout laddas i en inbäddad WebView (WKWebView / Android WebView), vilket döljer wallets och kan bryta 3-D Secure. Öppna den i stället med SDK:t eller i systemwebbläsaren (Custom Tabs / SFSafariViewController).

​

Ytterligare resurser

• Guide för betalningsintegrering
• Webhook-dokumentation
• Testprocess
• Tekniska vanliga frågor
• Anpassning av checkout-session
• On-Demand Subscriptions
• Uppgradering/nedgradering av prenumeration
• Återställning av övergiven kundvagn
• Customer Portal