Flutter

これはpub.dev上の公式Dodo Payments Flutterパッケージです（dodopayments_checkout）。別途、コミュニティが開発したパッケージもあります。詳しくは Community Projectsをご覧ください。

Checkout Sessions API

バックエンドから、このSDKが開くcheckout_urlを作成します。

Mobile Integration Guide

完全なモバイル決済フローにおける位置付けをご確認ください。

dodopayments_checkoutは、iOSでは SFSafariViewController、AndroidではChrome Custom TabでDodoのホスト型チェックアウトを開きます。これは、スタンドアロンのiOSおよび Android SDKで使用されるものと同じネイティブコアです。すべてのチェックアウトロジックはこれらのネイティブコアにあり、Dartレイヤーは型付きの Pigeonチャネルを介して呼び出しを転送します。APIキーは保持せず、Dodo Payments APIを呼び出すこともありません。 Flutter 3.44+ / Dart 3.12+、iOS 16+、およびAndroid minSdk 23が必要です。

インストール

Add the Dependency

pubspec.yaml

dependencies:
  dodopayments_checkout: ^1.0.0

iOS
Android

ios/Runner/Info.plistにスキーム用のURL型を追加します。

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>

次に、受信したURLを（例： app_links経由で）SDKに転送します。 SFSafariViewControllerは自身の戻りURLを捕捉できないためです。

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

DodoCheckout.instance.handleOpenURL(url);

ここではすべてのURLを安全に転送できます。handleOpenURLは、登録済みのreturnUrlに一致するURLに対してのみ動作し、それ以外の場合はfalseを解決します。

コールバックスキームをGradleのmanifest placeholderとして設定します。

android/app/build.gradle

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

MainActivityがandroid:taskAffinity=""（標準のflutter createのデフォルト）を設定している場合は、これを削除するか、SDKのactivityに同じaffinityを指定します。そうしないと、一部のOEM Androidビルドで実行中のチェックアウトが失われ、PLATFORM_ERRORが返されることがあります。

使用方法

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

結果の意味

result.statusはUI上のヒントであり、支払いの証明ではありません。すべての支払いを、payment.succeeded / subscription.active webhookを介してバックエンドから確認してください。

CheckoutStatus

必須

succeeded、failed、cancelled、pending、expiredのいずれかです。

String?

戻りURLに含まれている場合に設定されます。これをUIに表示しますが、アクセスの付与には使用しないでください。詳しくは以下の「支払いの検証」をご覧ください。

String?

サブスクリプションのチェックアウトで設定されます。

List<String>?

チェックアウトにlicense key商品が含まれている場合に設定されます。

String?

チェックアウトでメールアドレスを取得する場合に設定されます。

Map<String, String>

戻りURLに含まれるすべてのquery parameterを、そのまま保持します。

支払いの検証

Webhooks

支払いが成功したとき、またはサブスクリプションが有効化されたとき、Dodo Paymentsはバックエンドを呼び出します。

Get Payment Detail

paymentIdをsecret keyで検索し、ステータスを直接確認します。

これらのいずれかによって支払いが確認された後にアクセスを付与してください。result.statusだけを根拠にしてはいけません。

エラー

startがCheckoutExceptionをスローするのは、誤った使用またはプラットフォーム障害の場合のみです。キャンセルまたは拒否された支払いは、常に結果として返され、例外にはなりません。

invalidCheckoutUrl（INVALID_CHECKOUT_URL）：checkout.dodopayments.comのセッションURLではありません。
invalidReturnUrl（INVALID_RETURN_URL）：有効なabsolute URLではありません。
alreadyInProgress（ALREADY_IN_PROGRESS）：チェックアウトがすでに実行中です。
platformError（PLATFORM_ERROR）：予期しないプラットフォーム障害です。

放棄されたセッション

アプリがチェックアウトの途中で終了した場合は、次回起動時にセッションを復元し、バックエンドと照合してください。

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

Mobile Integration Guide

Android、iOS、React Nativeで共通する同じ仕様です。

Community Projects

コミュニティが開発した別のFlutterパッケージもあります。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Mobile Integration Guide

インストール

使用方法

結果の意味

支払いの検証

Webhooks

Get Payment Detail

エラー

放棄されたセッション

関連情報

Mobile Integration Guide

Community Projects

Checkout Sessions API

Mobile Integration Guide

​インストール

​使用方法

​結果の意味

​支払いの検証

Webhooks

Get Payment Detail

​エラー

​放棄されたセッション

​関連情報

Mobile Integration Guide

Community Projects

インストール

使用方法

結果の意味

支払いの検証

エラー

放棄されたセッション

関連情報