Guide d'intégration mobile

​

Prérequis

• Compte Dodo Payments : compte marchand actif avec accès à l’API
• Identifiants API : clé API et clé secrète de webhook depuis votre tableau de bord
• Projet d’application mobile : application Android, iOS, React Native ou Flutter
• Serveur backend : pour gérer de manière sécurisée la création des sessions de checkout

​

Workflow d’intégration

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

​

Choisissez votre SDK

​

Enregistrement d’un schéma d’URL de callback

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>

npx expo install expo-build-properties

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        { "android": { "manifestPlaceholders": { "dodoCallbackScheme": "myapp" } } }
      ]
    ],
    "ios": {
      "infoPlist": {
        "CFBundleURLTypes": [{ "CFBundleURLSchemes": ["myapp"] }]
      }
    }
  }
}

​

Bonnes pratiques

• Sécurité : ne déployez jamais de clé API dans votre application. Créez les sessions de checkout sur votre backend et transmettez uniquement le checkout_url obtenu au client.
• Autorité : considérez CheckoutResult.status comme un indice d’interface. N’accordez l’accès qu’après confirmation du paiement par votre backend.
• Expérience utilisateur : affichez un état de chargement pendant que votre backend crée la session et traitez cancelled comme un résultat normal plutôt que comme une erreur.
• Tests : utilisez le mode test et des cartes de test, puis vérifiez l’aller-retour de l’URL de retour sur un appareil réel ainsi que sur un simulateur.

​

Dépannage

​

Problèmes courants

• Le callback n’arrive jamais : le schéma dans returnUrl doit correspondre à celui que vous avez enregistré. Sur Android, il s’agit du placeholder de manifest dodoCallbackScheme ; sur iOS et React Native, il s’agit du type d’URL Info.plist.
• Le checkout revient au navigateur au lieu de revenir à votre application (iOS) : vous n’avez pas transmis l’URL entrante. Appelez DodoCheckout.handleOpenURL(url) depuis .onOpenURL, scene(_:openURLContexts:) ou un listener Linking React Native.
• PLATFORM_ERROR sur Android : il s’agit le plus souvent d’une incompatibilité de schéma. Cela peut également se produire si votre MainActivity définit android:taskAffinity="" (la valeur par défaut standard flutter create), ce qui peut faire perdre le checkout en cours à certains builds OEM.
• ALREADY_IN_PROGRESS : un checkout est toujours ouvert. Attendez la fin du précédent ou fermez-le avant d’en démarrer un autre.
• Le build échoue avec un placeholder non résolu : vous avez ajouté le SDK Android, mais vous n’avez jamais défini manifestPlaceholders["dodoCallbackScheme"].
• Le paiement a réussi, mais l’accès n’a pas été accordé : c’est attendu si vous vous basez sur le résultat mobile. Accordez l’accès depuis le webhook payment.succeeded / subscription.active à la place.

​

Ressources supplémentaires

• Guide d’intégration des paiements
• Documentation des webhooks
• Processus de test
• FAQ techniques