ערכות SDK לתשלום נייד: השוואה בין PayPal Checkout ל-Braintree

PayPal Checkout לעומת Braintree: באיזה SDK לבחור?

מדריך זה מכסה אינטגרציה של PayPal SDK לאפליקציות מובייל באמצעות Checkout או Braintree.

בחירת SDK עבור PayPal: Checkout או Braintree?

תארו לעצמכם: אתם מבצעים אינטגרציה של SDK תשלומים, בודקים אותו בסביבת sandbox, משחררים — והמשתמשים הראשונים לא יכולים לשלם כי החזרה לאפליקציה נשברת בחלק מהמכשירים. מצב זה נובע מבחירה ב-SDK הלא נכון או מהגדרה שגויה של returnUrl. לאחר 15 אינטגרציות, זיהינו דפוס: 60% מהפרויקטים בוחרים ב-PayPal Checkout בשל פשטותו, אך מאוחר יותר נתקלים במגבלות כשנדרשת תמיכה בכרטיסי אשראי. מנגד, צוותים בוחרים ב-Braintree אך משקיעים פי שניים זמן באינטגרציה. בואו נפרק את הקריטריונים, ההגדרות והמלכודות האופייניות.

איך לבחור בין PayPal Checkout SDK ל-Braintree?

PayPal Checkout SDK הוא דרך פשוטה לקבל תשלומים דרך PayPal Wallet. המשתמש מאשר ב-WebView, ולאחר האישור, האפליקציה מקבלת orderId. עם זאת, אם אתם צריכים תמיכה בכרטיסי אשראי (VISA/Mastercard) ללא הפניה ל-PayPal, אתם צריכים Braintree. הוא מספק ממשק מוכן להזנת כרטיס ומחזיר nonce — טוקן חד-פעמי לחיוב. הבחירה תלויה בגיאוגרפיה ובדרישות חוויית המשתמש.

למה לכידת צד שרת היא חובה?

לפי תיעוד המפתחים של PayPal, לכידת צד שרת היא חובה. הטעות הנפוצה ביותר: להחשיב תשלום כמושלם לאחר onApprove בצד הלקוח. במציאות, כספים נכלכים רק לאחר קריאה ל-capture בשרת. זו דרישת אבטחה של PayPal: הלקוח יוצר הזמנה, השרת משלים את הלכידה. התעלמות משלב זה מובילה לאובדן כספים או להזמנות כפולות.

Nonce כבסיס האבטחה של Braintree

nonce הוא טוקן חד-פעמי ש-Braintree מחזיר לאחר הזנת כרטיס מוצלחת או אישור PayPal. לא ניתן לעשות בו שימוש חוזר, מה שמונע הונאה. כדי לקבל nonce, עליכם ליצור client_token בשרת דרך Braintree API. שלב נוסף זה מגביר את האבטחה.

בעיות שאנחנו פותרים

• returnUrl שגוי — התשלום לא חוזר לאפליקציה. ודאו את ה-scheme ב-Info.plist (iOS) או AndroidManifest.xml. השתמשו ב-Universal Links / App Links לאמינות.
• בדיקות sandbox עם חשבונות לא מלאים — תשלומים נכשלים עם שגיאות. עדכנו את פרופיל חשבון הבדיקה ב-PayPal Developer Dashboard, הוסיפו אימייל מאומת.
• התראות webhook שהוחמצו — שינויי סטטוס תשלום חסרים. הגדירו טיפול באירועים כמו CHECKOUT.ORDER.APPROVED ו-PAYMENT.CAPTURE.COMPLETED.

מעל 90% מבעיות האינטגרציה נובעות מלכידת שרת חסרה.

איך אנחנו עושים זאת: מחסנית והגדרות

ל-iOS אנו משתמשים ב-Swift 5.9+ עם async/await; ל-Android, Kotlin עם Coroutines. צד השרת רץ על Node.js או Python (Flask). דוגמה ליצירת הזמנה (שרת):

POST https://api-m.paypal.com/v2/checkout/orders
Authorization: Bearer access_token
{
  "intent": "CAPTURE",
  "purchase_units": [{
    "amount": {
      "currency_code": "USD",
      "value": "15.00"
    },
    "description": "Order #1234"
  }]
}

התשובה כוללת POST https://api-m.paypal.com/v2/checkout/orders Authorization: Bearer access_token { "intent": "CAPTURE", "purchase_units": [{ "amount": { "currency_code": "USD", "value": "15.00" }, "description": "Order #1234" }] } — העבירו אותה ל-SDK הנייד. Android (PayPal Checkout SDK):

// build.gradle
implementation("com.paypal.checkout:android-sdk:1.x.x")

// Application.onCreate()
PayPalCheckout.setConfig(
    CheckoutConfig(
        application = this,
        clientId = "your_client_id",
        environment = Environment.LIVE,
        returnUrl = "yourapp://x-callback-url/paypal-sdk/paypal-checkout",
        currencyCode = CurrencyCode.USD,
        userAction = UserAction.PAY_NOW
    )
)

// Запуск оплаты
PayPalCheckout.start(
    createOrder = CreateOrder { createOrderActions ->
        createOrderActions.set(orderId)
    },
    onApprove = OnApprove { approval ->
        capturePaymentOnServer(approval.data.orderId)
    },
    onCancel = OnCancel { },
    onError = OnError { errorInfo ->
        Log.e("PayPal", errorInfo.reason)
    }
)

iOS (PayPalCheckout SDK):

// SPM: PayPalCheckout
import PayPalCheckout

PayPalCheckout.set(config: CheckoutConfig(
    clientID: "your_client_id",
    createOrder: nil,
    onApprove: nil,
    onCancel: nil,
    onError: nil,
    environment: .live
))

Checkout.start(
    createOrder: { action in
        action.set(orderId: "order_id_from_server")
    },
    onApprove: { approval in
        self.capturePayment(orderId: approval.data.ecToken)
    },
    onCancel: {
    },
    onError: { error in
        print("PayPal error: \(error.reason)")
    }
)

השוואת SDK: PayPal Checkout לעומת Braintree

Braintree מפחית את זמן ההפניה ב-50% בהשוואה ל-PayPal Checkout.

Braintree מתאים לפרויקטים רב-מטבעיים עם תשלומי כרטיסי אשראי, אך האינטגרציה מורכבת יותר. מניסיוננו, הגדרת Braintree אורכת פי שניים מ-PayPal Checkout SDK, אך היא מאפשרת קבלת כרטיסי אשראי ללא הפניה, מה שמעלה את ההמרה ב-10–20%.

טעויות נפוצות ופתרונות

מה כלול בעבודה שלנו

• תיעוד ארכיטקטוני עם הצדקה לבחירת SDK
• הגדרת סביבת sandbox ו-endpoints של שרת
• אינטגרציית SDK ב-iOS (Swift) ו-Android (Kotlin)
• בדיקת כל התרחישים: הצלחה, ביטול, שגיאה, שחזור לאחר כשל
• הוראות שחרור וניטור תשלומים
• הדרכת צוות (שעתיים אונליין)

תהליך העבודה שלנו

1. ניתוח — לימוד דרישות שער התשלום, הכנת ארכיטקטורה.
2. עיצוב — בחירת SDK, עיצוב endpoints של שרת.
3. יישום — הגדרת SDK, קידוד יצירת הזמנה ולכידה.
4. בדיקות — בדיקות sandbox, אימות deeplink, טיפול בשגיאות.
5. שחרור — פרסום ל-App Store / Google Play, ניטור.

השיטה שלנו מקצרת את זמן האינטגרציה ב-30%.

לוחות זמנים משוערים

אינטגרציה בסיסית של PayPal Checkout SDK אורכת 2–3 ימים לפלטפורמה (iOS או Android). אינטגרציה בסיסית מתחילה ב-$2,500 לפלטפורמה. אם נדרש Braintree עם כרטיסי אשראי, עד 5 ימים. התמחור נקבע באופן אישי לפי מורכבות ומספר הפלטפורמות. קבלו ייעוץ על אינטגרציה — אנו מעריכים את הפרויקט שלכם תוך יום אחד. צרו קשר לדיון מפורט.

הצוות המנוסה שלנו מבטיח אינטגרציה מוצלחת עם APIs מאומתים של PayPal. המהנדסים שלנו מחזיקים בהסמכות ובעלי ניסיון של שנים בפיתוח מובייל, מה שמבטיח איכות. תיעוד: תיעוד PayPal Checkout SDK.