iOS

هذا هو iOS checkout SDK الرسمي من Dodo Payments والمخصص لـ Swift. يفتح صفحة الدفع المستضافة من Dodo داخل متصفح أصلي ويعيد نتيجة typed.

Checkout Sessions API

أنشئ checkout_url الذي سيفتحه هذا SDK من backend الخاص بك.

Mobile Integration Guide

تعرّف على كيفية توافق ذلك مع تدفق الدفع الكامل على الأجهزة المحمولة.

يفتح iOS SDK صفحة الدفع المستضافة من Dodo داخل SFSafariViewController، ولا يحتفظ بأي API key، ولا يستدعي Dodo API مباشرةً. تعمل جميع منطق الدفع في المتصفح؛ بينما يدير SDK ببساطة دورة حياة العرض ويلتقط return URL. يتطلب iOS 16+ وSwift 6.

التثبيت

Add the Package

في Xcode، انتقل إلى File → Add Package Dependencies وأدخل:

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

حدد الإصدار 1.0.0 أو إصدارًا أحدث.بدلًا من ذلك، أضفه إلى Package.swift:

Package.swift

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

يجب أن يسجل تطبيقك URL scheme لاستقبال return URL من صفحة الدفع. أضف ما يلي إلى Info.plist:

Info.plist

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

يمكنك أيضًا إضافة ذلك عبر واجهة Info → URL Types في Xcode.

الاستخدام

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

إعادة توجيه Return URL

لا يملك SFSafariViewController طريقة داخل العملية لالتقاط return URL الخاص به. يجب أن يعيد تطبيقك توجيه عناوين URL الواردة إلى 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)
}

من الآمن إعادة توجيه كل URL إلى هنا. لا يعمل handleOpenURL إلا على عناوين URL المطابقة لـ returnUrl المسجل لديك، ويعيد false لأي شيء آخر.

معنى النتيجة

result.status هو تلميح لواجهة المستخدم، وليس دليلًا على الدفع. أكّد كل عملية دفع من backend الخاص بك، عبر webhook‏ payment.succeeded / subscription.active.

CheckoutStatus

مطلوب

واحد من succeeded أو failed أو cancelled أو pending أو expired.

String?

يُعيَّن عند احتواء return URL على واحد منها. اعرضه في واجهة المستخدم، ولا تستخدمه لمنح الوصول. راجع قسم Verify the Payment أدناه.

String?

يُعيَّن لعمليات الدفع الخاصة بالاشتراكات.

[String]?

يُعيَّن عند احتواء عملية الدفع على منتجات تتضمن license key.

String?

يُعيَّن عند التقاط البريد الإلكتروني أثناء عملية الدفع.

[String: String]

كل query parameter من return URL، حرفيًا.

التحقق من الدفع

Webhooks

يستدعي Dodo Payments backend الخاص بك عند نجاح عملية دفع أو تفعيل اشتراك.

Get Payment Detail

ابحث عن paymentId باستخدام secret key الخاص بك للتحقق من حالته مباشرةً.

امنح الوصول بعد أن يؤكد أحد هذه الخيارات الدفع، وليس اعتمادًا على result.status وحده.

تخصيص المظهر

خصّص زر الإغلاق في اللوحة، ونمط العرض، ونظام الألوان عبر customization على start(...). جميع الحقول اختيارية؛ ويؤدي حذف customization إلى استخدام مظهر SFSafariViewController الافتراضي في iOS.

DismissButtonStyle

تسمية زر الإغلاق أو أيقونته: done أو close أو cancel.

PresentationStyle

يظهر pageSheet كبطاقة يمكن إغلاقها بالسحب؛ بينما يغطي fullScreen الشاشة بأكملها.

Bool

يتيح طي شريط الأدوات عند التمرير. يظهر فقط عندما تكون presentationStyle هي fullScreen — ويحافظ pageSheet على تثبيت الأشرطة بصرف النظر عن هذا الإعداد.

ColorScheme

يفرض المظهر الفاتح أو الداكن بغض النظر عن إعداد النظام في الجهاز: system أو light أو dark.

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

الأخطاء

يُصدر start استثناءً من CheckoutError فقط عند إساءة الاستخدام أو حدوث عطل في المنصة. أما عملية الدفع الملغاة أو المرفوضة فهي نتيجة دائمًا وليست استثناءً.

invalidCheckoutUrl (INVALID_CHECKOUT_URL): ليس عنوان URL لجلسة checkout.dodopayments.com.
invalidReturnUrl (INVALID_RETURN_URL): ليس عنوان URL مطلقًا صالحًا.
alreadyInProgress (ALREADY_IN_PROGRESS): عملية دفع قيد التشغيل بالفعل.
platformError (PLATFORM_ERROR): عطل غير متوقع في المنصة.

الجلسات المتروكة

إذا أُغلِق التطبيق قسرًا أثناء إتمام عملية الدفع، فاستعد الجلسة عند التشغيل التالي وطابقها مع الواجهة الخلفية لديك.

import DodoCheckout

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

Mobile Integration Guide

العقد نفسه لنظام Android وReact Native وFlutter.

React Native SDK

يغلّف نواة Swift نفسها على iOS.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Sessions API

Mobile Integration Guide

التثبيت

الاستخدام

إعادة توجيه Return URL

معنى النتيجة

التحقق من الدفع

Webhooks

Get Payment Detail

تخصيص المظهر

الأخطاء

الجلسات المتروكة

ذات صلة

Mobile Integration Guide

React Native SDK

Checkout Sessions API

Mobile Integration Guide

​التثبيت

​الاستخدام

​إعادة توجيه Return URL

​معنى النتيجة

​التحقق من الدفع

Webhooks

Get Payment Detail

​تخصيص المظهر

​الأخطاء

​الجلسات المتروكة

​ذات صلة

Mobile Integration Guide

React Native SDK

التثبيت

الاستخدام

إعادة توجيه Return URL

معنى النتيجة

التحقق من الدفع

تخصيص المظهر

الأخطاء

الجلسات المتروكة

ذات صلة