Flutter

Il s’agit du package Flutter officiel de Dodo Payments (dodopayments_checkout sur pub.dev). Un package distinct développé par la communauté existe également, consultez Projets communautaires.

Checkout Sessions API

Créez la checkout_url que ce SDK ouvre depuis votre backend.

Mobile Integration Guide

Découvrez comment cela s’intègre au flux de paiement mobile complet.

dodopayments_checkout ouvre le checkout hébergé de Dodo dans SFSafariViewController sur iOS et dans un Chrome Custom Tab sur Android — les mêmes cœurs natifs que ceux utilisés par les SDK autonomes iOS et Android. Toute la logique du checkout réside dans ces cœurs natifs ; la couche Dart transmet l’appel via un canal typé Pigeon. Elle ne contient aucune clé API et n’appelle jamais l’API Dodo Payments. Nécessite Flutter 3.44+ / Dart 3.12+, iOS 16+ et Android minSdk 23.

Installation

Add the Dependency

pubspec.yaml

dependencies:
  dodopayments_checkout: ^1.0.0

iOS
Android

Ajoutez un type d’URL pour votre schéma dans ios/Runner/Info.plist :

ios/Runner/Info.plist

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

Transmettez ensuite les URL entrantes (par exemple via app_links) au SDK, car SFSafariViewController ne peut pas intercepter sa propre URL de retour :

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

DodoCheckout.instance.handleOpenURL(url);

Vous pouvez transmettre toutes les URL ici sans risque. handleOpenURL agit uniquement sur les URL correspondant à votre returnUrl enregistré et résout false pour toute autre URL.

Définissez votre schéma de callback comme placeholder de manifeste Gradle :

android/app/build.gradle

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

Si MainActivity définit android:taskAffinity="" (la valeur par défaut de flutter create), supprimez-le ou attribuez la même affinité aux activités du SDK. Sinon, certaines versions Android de fabricants peuvent perdre le checkout en cours et renvoyer PLATFORM_ERROR.

Utilisation

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

final result = await DodoCheckout.instance.start(
  CheckoutParams(
    checkoutUrl: Uri.parse(checkoutUrl), // from your backend's checkout session
    returnUrl: Uri.parse('myapp://checkout/return'), // scheme must be registered (see Setup)
    onEvent: (event) => print(event.type), // logging only
  ),
);

switch (result.status) {
  case CheckoutStatus.succeeded: showSuccess(result.paymentId);
  case CheckoutStatus.failed:    showFailure();
  case CheckoutStatus.cancelled: dismiss();
  case CheckoutStatus.pending:   showPending();
  case CheckoutStatus.expired:   showExpired();
}

Signification du résultat

result.status est un indice d’interface, pas une preuve de paiement. Confirmez chaque paiement depuis votre backend, via le webhook payment.succeeded / subscription.active.

CheckoutStatus

requis

L’un des éléments suivants : succeeded, failed, cancelled, pending, expired.

String?

Défini lorsque l’URL de retour en contient un. Affichez-le dans l’interface, mais ne l’utilisez pas pour accorder l’accès. Consultez la section Vérifier le paiement ci-dessous.

String?

Défini pour les checkouts d’abonnement.

List<String>?

Défini lorsque le checkout inclut des produits avec clé de licence.

String?

Défini lorsque le checkout collecte une adresse e-mail.

Map<String, String>

Chaque paramètre de requête de l’URL de retour, mot pour mot.

Vérifier le paiement

Webhooks

Dodo Payments appelle votre backend lorsqu’un paiement est réussi ou qu’un abonnement est activé.

Get Payment Detail

Recherchez paymentId avec votre clé secrète pour vérifier directement son statut.

Accordez l’accès après confirmation du paiement par l’un de ces moyens, jamais à partir de result.status seul.

Erreurs

start lève CheckoutException uniquement en cas de mauvaise utilisation ou de défaillance de la plateforme. Un paiement annulé ou refusé est toujours un résultat, jamais une exception.

invalidCheckoutUrl (INVALID_CHECKOUT_URL) : URL de session checkout.dodopayments.com non valide.
invalidReturnUrl (INVALID_RETURN_URL) : URL absolue non valide.
alreadyInProgress (ALREADY_IN_PROGRESS) : un checkout est déjà en cours.
platformError (PLATFORM_ERROR) : défaillance inattendue de la plateforme.

Sessions abandonnées

Si l’application est arrêtée en plein checkout, récupérez la session au prochain lancement et réconciliez-la avec votre backend.

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

final abandoned = await DodoCheckout.instance.getAbandonedSession();
if (abandoned != null) {
  // reconcile abandoned.sessionId with your backend, then:
  await DodoCheckout.instance.clearAbandonedSession();
}

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Mobile Integration Guide

Installation

Utilisation

Signification du résultat

Vérifier le paiement

Webhooks

Get Payment Detail

Erreurs

Sessions abandonnées

Articles associés

Mobile Integration Guide

Community Projects

Checkout Sessions API

Mobile Integration Guide

​Installation

​Utilisation

​Signification du résultat

​Vérifier le paiement

Webhooks

Get Payment Detail

​Erreurs

​Sessions abandonnées

​Articles associés

Mobile Integration Guide

Community Projects

Installation

Utilisation

Signification du résultat

Vérifier le paiement

Erreurs

Sessions abandonnées

Articles associés