iOS

Ini adalah iOS checkout SDK resmi Dodo Payments untuk Swift. SDK ini membuka hosted checkout Dodo di tampilan browser native dan mengembalikan hasil bertipe.

Checkout Sessions API

Buat checkout_url yang akan dibuka SDK ini dari backend Anda.

Mobile Integration Guide

Lihat bagaimana proses ini terintegrasi dengan alur pembayaran mobile secara lengkap.

iOS SDK membuka hosted checkout Dodo di SFSafariViewController, tidak menyimpan API key, dan tidak pernah memanggil Dodo API secara langsung. Semua logika checkout berjalan di browser; SDK hanya mengelola siklus hidup tampilan dan menangkap return URL. Memerlukan iOS 16+, Swift 6.

Instalasi

Add the Package

Di Xcode, buka File → Add Package Dependencies lalu masukkan:

https://github.com/dodopayments/dodopayments-mobile-sdk-ios

Pilih versi 1.0.0 atau yang lebih baru.Atau, tambahkan ke Package.swift Anda:

Package.swift

.package(url: "https://github.com/dodopayments/dodopayments-mobile-sdk-ios", from: "1.0.0")

Aplikasi Anda harus mendaftarkan URL scheme untuk menerima return URL dari checkout. Tambahkan ini ke Info.plist Anda:

Info.plist

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

Anda juga dapat menambahkannya melalui UI Info → URL Types di Xcode.

Penggunaan

import DodoCheckout

let result = try await DodoCheckout.start(
    checkoutUrl: checkoutUrl,   // from your backend's checkout session
    returnUrl: URL(string: "myapp://checkout/return")!,
    onEvent: { event in print(event.name) }  // logging only
)

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

Meneruskan Return URL

SFSafariViewController tidak memiliki cara dalam proses untuk menangkap return URL-nya sendiri. Aplikasi Anda harus meneruskan URL yang masuk ke SDK.

SwiftUI
SceneDelegate

.onOpenURL { url in
    DodoCheckout.handleOpenURL(url)
}

SceneDelegate.swift

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    DodoCheckout.handleOpenURL(url)
}

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

Arti Result

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?

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

String?

Diatur untuk checkout subscription.

[String]?

Diatur ketika checkout menyertakan produk license key.

String?

Diatur ketika checkout menangkap email.

[String: String]

Setiap query parameter dari return URL, secara verbatim.

Verifikasi Pembayaran

Webhooks

Dodo Payments memanggil backend Anda ketika pembayaran berhasil atau subscription diaktifkan.

Get Payment Detail

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

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

Kustomisasi Tampilan

Sesuaikan tombol tutup sheet, gaya presentasi, dan skema warna melalui customization pada start(...). Semua bidang bersifat opsional; jika customization tidak disertakan, tampilan default iOS akan digunakan melalui SFSafariViewController.

DismissButtonStyle

Label atau ikon untuk tombol tutup: done, close, atau cancel.

PresentationStyle

pageSheet ditampilkan sebagai kartu dengan swipe-to-dismiss; fullScreen mencakup seluruh layar.

Bool

Memungkinkan toolbar diciutkan saat scroll. Hanya terlihat ketika presentationStyle adalah fullScreen — pageSheet membuat bar tetap tersemat terlepas dari pengaturan ini.

ColorScheme

Memaksa tampilan terang atau gelap terlepas dari pengaturan sistem perangkat: system, light, atau dark.

let result = try await DodoCheckout.start(
    checkoutUrl: checkoutUrl,
    returnUrl: URL(string: "myapp://checkout/return")!,
    customization: BrowserCustomization(
        dismissButtonStyle: .close,
        presentationStyle: .fullScreen,
        colorScheme: .dark
    )
)

Error

start melempar CheckoutError hanya jika terjadi kesalahan penggunaan atau kegagalan platform. Pembayaran yang dibatalkan atau ditolak selalu menjadi hasil, bukan exception.

invalidCheckoutUrl (INVALID_CHECKOUT_URL): bukan URL sesi checkout.dodopayments.com yang valid.
invalidReturnUrl (INVALID_RETURN_URL): bukan URL absolut yang valid.
alreadyInProgress (ALREADY_IN_PROGRESS): checkout sudah 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 DodoCheckout

if let abandoned = DodoCheckout.getAbandonedSession() {
    // reconcile abandoned.sessionId with your backend, then:
    DodoCheckout.clearAbandonedSession()
}

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Mobile Integration Guide

Instalasi

Penggunaan

Meneruskan Return URL

Arti Result

Verifikasi Pembayaran

Webhooks

Get Payment Detail

Kustomisasi Tampilan

Error

Sesi yang Ditinggalkan

Terkait

Mobile Integration Guide

React Native SDK

Checkout Sessions API

Mobile Integration Guide

​Instalasi

​Penggunaan

​Meneruskan Return URL

​Arti Result

​Verifikasi Pembayaran

Webhooks

Get Payment Detail

​Kustomisasi Tampilan

​Error

​Sesi yang Ditinggalkan

​Terkait

Mobile Integration Guide

React Native SDK

Instalasi

Penggunaan

Meneruskan Return URL

Arti Result

Verifikasi Pembayaran

Kustomisasi Tampilan

Error

Sesi yang Ditinggalkan

Terkait