Flutter

이는 pub.dev의 공식 Dodo Payments Flutter 패키지입니다 (dodopayments_checkout ). 별도로 커뮤니티에서 제작한 패키지도 제공됩니다. 자세한 내용은 Community Projects를 참조하세요.

Checkout Sessions API

백엔드에서 이 SDK가 열 checkout_url을 생성합니다.

Mobile Integration Guide

전체 모바일 결제 흐름에서 이것이 어떻게 사용되는지 확인하세요.

dodopayments_checkout는 iOS에서 Dodo의 호스팅 체크아웃을 SFSafariViewController로, Android에서는 Chrome Custom Tab으로 엽니다 — 독립 실행형 iOS 및 Android SDK에서 사용하는 것과 동일한 네이티브 코어입니다. 모든 체크아웃 로직은 이러한 네이티브 코어에 있으며, Dart 레이어는 타입이 지정된 Pigeon 채널을 통해 호출을 전달합니다. API key를 보유하지 않으며 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 type을 추가합니다:

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는 자체 return 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?

return URL에 해당 값이 포함되어 있을 때 설정됩니다. UI에 표시하되 액세스 권한을 부여하는 데 사용하지 마세요. 아래의 Verify the Payment를 참조하세요.

String?

subscription 체크아웃에 대해 설정됩니다.

List<String>?

체크아웃에 license key 제품이 포함될 때 설정됩니다.

String?

체크아웃에서 이메일을 수집할 때 설정됩니다.

Map<String, String>

return URL의 모든 query parameter를 있는 그대로 포함합니다.

결제 확인

Webhooks

결제가 성공하거나 subscription이 활성화되면 Dodo Payments가 백엔드를 호출합니다.

Get Payment Detail

secret key로 paymentId를 조회하여 상태를 직접 확인하세요.

이 중 하나가 결제를 확인한 후에만 액세스 권한을 부여하세요. result.status만으로 권한을 부여해서는 안 됩니다.

오류

start는 잘못된 사용이나 플랫폼 장애가 발생한 경우에만 CheckoutException를 발생시킵니다. 취소되거나 거부된 결제는 항상 예외가 아닌 결과로 반환됩니다.

invalidCheckoutUrl (INVALID_CHECKOUT_URL): 유효한 checkout.dodopayments.com session URL이 아닙니다.
invalidReturnUrl (INVALID_RETURN_URL): 유효한 absolute URL이 아닙니다.
alreadyInProgress (ALREADY_IN_PROGRESS): 이미 checkout이 실행 중입니다.
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

설치

사용법

결과의 의미

결제 확인

오류

중단된 세션

관련 항목