Flutter

Detta är det officiella Flutter-paketet för Dodo Payments (dodopayments_checkout på pub.dev). Det finns även ett separat, community-byggt paket, se Community Projects.

Checkout Sessions API

Skapa checkout_url som detta SDK öppnar, från din backend.

Mobile Integration Guide

Se hur detta passar in i det fullständiga mobila betalningsflödet.

dodopayments_checkout öppnar Dodos hostade checkout i SFSafariViewController på iOS och i en Chrome Custom Tab på Android — samma inbyggda kärnor som används av de fristående iOS- och Android-SDK:erna. All checkoutlogik finns i dessa inbyggda kärnor; Dart-lagret vidarebefordrar anropet via en typad Pigeon-kanal. Det innehåller ingen API-nyckel och anropar aldrig Dodo Payments API. Kräver Flutter 3.44+ / Dart 3.12+, iOS 16+ och Android minSdk 23.

Installation

Add the Dependency

pubspec.yaml

dependencies:
  dodopayments_checkout: ^1.0.0

iOS
Android

Lägg till en URL-typ för ditt schema i 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>

Vidarebefordra sedan inkommande URL:er (till exempel via app_links) till SDK:t, eftersom SFSafariViewController inte kan fånga sin egen retur-URL:

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

DodoCheckout.instance.handleOpenURL(url);

Det är säkert att vidarebefordra alla URL:er här. handleOpenURL agerar endast på URL:er som matchar ditt registrerade returnUrl och löser false för allt annat.

Ange ditt callback-schema som en manifest-placeholder i Gradle:

android/app/build.gradle

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

Om MainActivity anger android:taskAffinity="" (standardvärdet för flutter create), ta bort det eller ge SDK:ts activities samma affinitet. Annars kan vissa OEM Android-byggen förlora den pågående checkout-sessionen och returnera PLATFORM_ERROR.

Användning

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

Vad resultatet betyder

result.status är en UI-hint, inte ett bevis på betalning. Bekräfta varje betalning från din backend via payment.succeeded / subscription.active webhook.

CheckoutStatus

obligatorisk

En av succeeded, failed, cancelled, pending, expired.

String?

Anges när retur-URL:en innehöll en sådan. Visa den i UI:t, men använd den inte för att bevilja åtkomst. Se Verifiera betalningen nedan.

String?

Anges för prenumerations-checkouter.

List<String>?

Anges när checkouten innehåller produkter med licensnycklar.

String?

Anges när checkouten samlar in en e-postadress.

Map<String, String>

Varje frågeparameter från retur-URL:en, ordagrant.

Verifiera betalningen

Webhooks

Dodo Payments anropar din backend när en betalning lyckas eller en prenumeration aktiveras.

Get Payment Detail

Slå upp paymentId med din hemliga nyckel för att kontrollera dess status direkt.

Bevilja åtkomst efter att något av dessa har bekräftat betalningen, aldrig enbart från result.status.

Anpassning av utseende

Anpassa checkout-webbläsarens verktygsfält, knappar och färgschema via customization på CheckoutParams. Alternativen är grupperade efter plattform eftersom Androids Custom Tab och iOS:s SFSafariViewController visar olika inbyggda kontroller. Alla fält är valfria; om customization utelämnas används respektive plattformens standardutseende.

Android — Custom Tab

Bakgrundsfärg för verktygsfältet.

Färg på navigeringsfältet.

Avdelarfärg ovanför navigeringsfältet.

CloseButtonStyle

standard visar systemets “X”-ikon; back visar i stället en bakåtpil.

CloseButtonPosition

Vilken sida av verktygsfältet som stängningsknappen visas på.

Visar verktygsfältets delningsikon.

bool

Visar sidans titel under URL:en i verktygsfältet.

bool

Låter verktygsfältet döljas automatiskt när sidan rullas.

bool

Visar “Bokmärk den här sidan” i spillmenyn.

bool

Visar “Ladda ned sidan” i spillmenyn.

BrowserColorScheme

Tvingar fram ljust eller mörkt utseende oavsett enhetens systeminställning.

iOS — SFSafariViewController

DismissButtonStyle

Etikett eller ikon för avvisningsknappen.

PresentationStyle

pageSheet visas som ett kort som kan svepas bort; fullScreen täcker hela skärmen.

bool

Låter verktygsfältet fällas ihop vid rullning. Visas endast när presentationStyle är fullScreen — pageSheet håller fälten fixerade oavsett denna inställning.

BrowserColorScheme

Tvingar fram ljust eller mörkt utseende oavsett enhetens systeminställning.

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,
      ),
    ),
  ),
);

Fel

start kastar CheckoutException endast vid felaktig användning eller ett plattformsfel. En avbruten eller nekad betalning är alltid ett resultat, aldrig ett undantag.

invalidCheckoutUrl (INVALID_CHECKOUT_URL): ingen giltig checkout.dodopayments.com-session-URL.
invalidReturnUrl (INVALID_RETURN_URL): ingen giltig absolut URL.
alreadyInProgress (ALREADY_IN_PROGRESS): en checkout körs redan.
platformError (PLATFORM_ERROR): oväntat plattformsfel.

Övergivna sessioner

Om appen avslutas mitt under checkout återställer du sessionen vid nästa start och synkroniserar den med din 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

Användning

Vad resultatet betyder

Verifiera betalningen

Webhooks

Get Payment Detail

Anpassning av utseende

Fel

Övergivna sessioner

Relaterat

Mobile Integration Guide

Community Projects

Checkout Sessions API

Mobile Integration Guide

​Installation

​Användning

​Vad resultatet betyder

​Verifiera betalningen

Webhooks

Get Payment Detail

​Anpassning av utseende

​Fel

​Övergivna sessioner

​Relaterat

Mobile Integration Guide

Community Projects

Installation

Användning

Vad resultatet betyder

Verifiera betalningen

Anpassning av utseende

Fel

Övergivna sessioner

Relaterat