Flutter

Ini adalah paket Flutter resmi Dodo Payments (dodopayments_checkout di pub.dev). Paket terpisah yang dibuat oleh komunitas juga tersedia, lihat Proyek Komunitas.

Checkout Sessions API

Buat checkout_url yang akan dibuka SDK ini dari backend Anda.

Mobile Integration Guide

Lihat bagaimana ini terintegrasi ke dalam alur pembayaran seluler lengkap.

dodopayments_checkout membuka checkout hosted Dodo di SFSafariViewController di iOS dan Chrome Custom Tab di Android — core native yang sama seperti yang digunakan oleh SDK mandiri iOS dan Android. Semua logika checkout berada di core native tersebut; layer Dart meneruskan pemanggilan melalui channel bertipe Pigeon. Layer ini tidak menyimpan API key dan tidak pernah memanggil Dodo Payments API. Memerlukan Flutter 3.44+ / Dart 3.12+, iOS 16+, dan Android minSdk 23.

Instalasi

Add the Dependency

pubspec.yaml

dependencies:
  dodopayments_checkout: ^1.0.0

iOS
Android

Tambahkan tipe URL untuk skema Anda di 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>

Kemudian teruskan URL yang masuk (misalnya melalui app_links) ke SDK, karena SFSafariViewController tidak dapat menangkap URL pengembaliannya sendiri:

import 'package:dodopayments_checkout/dodopayments_checkout.dart';

DodoCheckout.instance.handleOpenURL(url);

Aman untuk meneruskan setiap URL di sini. handleOpenURL hanya bertindak pada URL yang cocok dengan returnUrl terdaftar Anda dan menyelesaikan false untuk URL lainnya.

Tetapkan skema callback Anda sebagai placeholder manifest Gradle:

android/app/build.gradle

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

Jika MainActivity menetapkan android:taskAffinity="" (default flutter create bawaan), hapus atau berikan affinity yang sama kepada activity SDK. Jika tidak, beberapa build Android OEM dapat kehilangan checkout yang sedang berlangsung dan mengembalikan PLATFORM_ERROR.

Penggunaan

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

Arti Hasil

result.status adalah petunjuk UI, bukan bukti pembayaran. Konfirmasikan setiap pembayaran dari backend Anda melalui webhook payment.succeeded / subscription.active.

CheckoutStatus

wajib

Salah satu dari succeeded, failed, cancelled, pending, expired.

String?

Ditetapkan ketika URL pengembalian menyertakan salah satunya. Tampilkan di UI, jangan gunakan untuk memberikan akses. Lihat Verifikasi Pembayaran di bawah.

String?

Ditetapkan untuk checkout langganan.

List<String>?

Ditetapkan ketika checkout menyertakan produk dengan license key.

String?

Ditetapkan ketika checkout menangkap email.

Map<String, String>

Setiap parameter query dari URL pengembalian, apa adanya.

Verifikasi Pembayaran

Webhooks

Dodo Payments memanggil backend Anda ketika pembayaran berhasil atau langganan aktif.

Get Payment Detail

Cari paymentId menggunakan secret key Anda untuk memeriksa statusnya secara langsung.

Berikan akses setelah salah satu hal ini mengonfirmasi pembayaran, jangan pernah hanya berdasarkan result.status.

Error

start hanya melempar CheckoutException untuk penggunaan yang salah atau kegagalan platform. Pembayaran yang dibatalkan atau ditolak selalu menjadi hasil, bukan exception.

invalidCheckoutUrl (INVALID_CHECKOUT_URL): bukan URL sesi checkout.dodopayments.com.
invalidReturnUrl (INVALID_RETURN_URL): bukan URL absolut yang valid.
alreadyInProgress (ALREADY_IN_PROGRESS): checkout sedang berjalan.
platformError (PLATFORM_ERROR): kegagalan platform yang tidak terduga.

Sesi yang Ditinggalkan

Jika aplikasi dihentikan di tengah checkout, pulihkan sesi saat peluncuran berikutnya dan rekonsiliasikan dengan backend Anda.

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

Instalasi

Penggunaan

Arti Hasil

Verifikasi Pembayaran

Webhooks

Get Payment Detail

Error

Sesi yang Ditinggalkan

Terkait

Mobile Integration Guide

Community Projects

Checkout Sessions API

Mobile Integration Guide

​Instalasi

​Penggunaan

​Arti Hasil

​Verifikasi Pembayaran

Webhooks

Get Payment Detail

​Error

​Sesi yang Ditinggalkan

​Terkait

Mobile Integration Guide

Community Projects

Instalasi

Penggunaan

Arti Hasil

Verifikasi Pembayaran

Error

Sesi yang Ditinggalkan

Terkait