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.

Error

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

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

Session yang Ditinggalkan

Jika aplikasi dihentikan di tengah checkout, pulihkan session 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

Error

Session 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

​Error

​Session yang Ditinggalkan

​Terkait

Mobile Integration Guide

React Native SDK

Instalasi

Penggunaan

Meneruskan Return URL

Arti Result

Verifikasi Pembayaran

Error

Session yang Ditinggalkan

Terkait