שילוב שער תשלומים CloudPayments באפליקציות מובייל
ראינו יותר מדי אפליקציות מובייל מוכנות לשחרור שקבלת התשלומים בהן הצטמצמה לבדיקה ראשונית. CloudPayments — שער תשלומים רוסי — פותר זאת תוך 1–2 ימים אם מבינים את הארכיטקטורה. הצוות שלנו שילב את ה-SDK של CloudPayments ביותר מ-30 פרויקטים בפלטפורמות iOS, Android ו-Flutter, תוך טיפול יציב במקרים לא טריוויאליים (3DS2, Apple Pay, החזרים). לדוגמה, בפרויקט אחד יישמנו גם Apple Pay וגם Google Pay ביום אחד באמצעות השיטות המובנות של ה-SDK.
למה קריפטוגרמת כרטיס?
CloudPayments לעולם לא מעביר נתוני כרטיס גולמיים דרך השרת שלך, מה שמפחית את היקף PCI DSS. התשלומים הופכים לבטוחים יותר מכיוון שהלקוח מייצר קריפטוגרמה באמצעות ה-PublicID של הסוחר. הקריפטוגרמה היא טוקן מוצפן שאינו מכיל פרטי כרטיס מלאים. היא נשלחת לשרת שלך, אשר מעביר אותה ל-API של CloudPayments לצורך חיוב הכספים. גישה זו בטוחה פי שלושה מאחסון PAN על השרת.
// Android: создание криптограммы
val cardCryptogram = Card.cardCryptogram(
cardNumber = "4111111111111111",
cardDate = "12/25",
cardCvv = "123",
merchantPublicId = "pk_your_public_id"
)// iOS: создание криптограммы
let cryptogram = CPCryptogramPacket.makePacket(
cardNumber: "4111111111111111",
expirationDateString: "12/25",
cvv: "123",
merchantPublicID: "pk_your_public_id"
)בצד השרת, קרא לנקודת הקצה // Android: создание криптограммы val cardCryptogram = Card.cardCryptogram( cardNumber = "4111111111111111", cardDate = "12/25", cardCvv = "123", merchantPublicId = "pk_your_public_id" ) עם הקריפטוגרמה, הסכום ומזהה ההזמנה. שים לב: הקריפטוגרמה היא חד-פעמית ומוגבלת בזמן — שכבת הגנה נוספת.
טיפול ב-3D Secure
אם הבנק המנפיק דורש אימות, ה-API של CloudPayments מחזיר סטטוס // iOS: создание криптограммы let cryptogram = CPCryptogramPacket.makePacket( cardNumber: "4111111111111111", expirationDateString: "12/25", cvv: "123", merchantPublicID: "pk_your_public_id" ) עם POST /payments/cards/charge, 3ds ו-AcsUrl. ה-SDK מספק רכיבים מוכנים להצגת WebView של 3DS. לאחר שהמשתמש מזין את קוד ה-SMS, ה-SDK מחזיר PaReq — השרת שלך שולח אותו ל-TransactionId כדי להשלים את התשלום.
// Android: запуск 3DS через SDK
ThreeDsDialogFragment.newInstance(
acsUrl = response.acsUrl,
transactionId = response.transactionId,
paReq = response.paReq
).show(supportFragmentManager, "3ds")ב-iOS, השתמש ב-PaRes מה-SDK עם אותם פרמטרים.
מתי להשתמש בממשק המשתמש המובנה של ה-SDK?
ה-SDK של CloudPayments כולל POST /payments/cards/post3ds — מסך הזנת כרטיס עם לוגואים של Visa, Mastercard, Mir ואימות אוטומטי. אם עיצוב מותאם אישית אינו קריטי, זה מזרז את הפיתוח באופן משמעותי.
val intent = PaymentActivity.getStartIntent(
context,
cpApiPublicId = "pk_your_public_id",
totalAmount = "1500",
currency = Currency.RUB,
invoiceId = "ORDER-1234",
description = "Оплата заказа"
)
startActivityForResult(intent, REQUEST_CODE_PAYMENT)שילוב Apple Pay ו-Google Pay
ה-SDK של CloudPayments מציע שיטות ייעודיות ל-Apple Pay (iOS) ול-Google Pay (Android). עבור Apple Pay, הגדר Apple Merchant ID בלוח הבקרה של CloudPayments ואפשר את היכולת ב-Xcode. Google Pay דורש הגדרה ב-Google Pay Console. לאחר מכן, ה-SDK מציג אוטומטית את כפתור Apple Pay או Google Pay במסך התשלום. במקרה של הצלחה, ה-SDK מחזיר קריפטוגרמה, אשר מעובדת כרגיל. שילוב תשלומים ללא מגע אורך כיום אחד ברגע שחשבונות הסוחר מוכנים.
למה קריפטוגרמה בטוחה יותר מאחסון PAN?
הקריפטוגרמה אינה מכילה מספר כרטיס מלא, תאריך תפוגה או CVV. היא נוצרת בצד הלקוח באמצעות המפתח הציבורי של CloudPayments ואינה ניתנת לפענוח ללא המפתח הפרטי בצד השער. גם אם היא מיורטת, לא ניתן לעשות בה שימוש חוזר. בנוסף, CloudPayments אינו דורש מהסוחרים להיות מוסמכי PCI DSS, מה שמפחית את עומס האבטחה.
השוואה: יישום מותאם אישית מול SDK של CloudPayments
| קריטריון | יישום מותאם אישית | SDK של CloudPayments |
|---|---|---|
| זמן אינטגרציה | 2–4 שבועות | 1–3 ימים |
| תמיכה ב-3DS2 | דורש הסמכה | מובנה |
| Apple Pay / Google Pay | הגדרה ארוכה | יום אחד |
| עדכונים לשינויי מערכת תשלומים | ידני | אוטומטי |
CloudPayments מקצר את זמן היציאה לשוק לתשלומים פי 10 בהשוואה לחיבור ישיר לסולק.
מלכודות נפוצות לפני שחרור
לפני הגשה לחנות האפליקציות, בדוק:
- אין לקודד את ה-PublicID בצורה קשיחה — השתמש ב-Build Config.
- הקריפטוגרמה נוצרת רק בצד הלקוח, לעולם אל תשמור אותה.
- WebView של 3DS צריך לטפל בזמן קצוב (בדרך כלל 10–15 דקות).
- עבור Apple Pay, ודא ש-Apple Merchant ID מוגדר והיכולת מופעלת ב-Xcode.
- בדוק עם כרטיסי בדיקה:
// Android: запуск 3DS через SDK ThreeDsDialogFragment.newInstance( acsUrl = response.acsUrl, transactionId = response.transactionId, paReq = response.paReq ).show(supportFragmentManager, "3ds")(הצלחה),D3DSViewController(יתרה לא מספקת).
שלבי אינטגרציה ולוחות זמנים
| שלב | משך |
|---|---|
| ניתוח פרויקט והכנת PublicID | 1–2 שעות |
| אינטגרציית SDK והגדרת קריפטוגרמה | 0.5 יום |
| טיפול ב-3DS ובדיקות | 0.5–1 יום |
| Apple Pay / Google Pay (אופציונלי) | +1 יום |
| בדיקות סופיות ושחרור | 0.5 יום |
מה כלול בעבודה שלנו
- אינטגרציית SDK של CloudPayments (iOS / Android / Flutter)
- יצירת קריפטוגרמה והעברה לשרת
- טיפול ב-3DS באמצעות רכיבי SDK
- אופציונלי: Apple Pay / Google Pay דרך CloudPayments
- בדיקות עם כרטיסי בדיקה ו-PublicID
- הדרכה על הגדרת התראות (Push, Email) והחזרים
לוחות זמנים
2–3 ימים לאינטגרציה בסיסית. העלות מחושבת באופן אישי לאחר ניתוח הפרויקט. קבל ייעוץ על שילוב CloudPayments באפליקציית המובייל שלך — המהנדסים שלנו יסייעו בהגדרת SDK, 3DS ותשלומים ללא מגע. הזמן יישום ואנו נציע את הפתרון האופטימלי למחסן הטכנולוגי וללוחות הזמנים שלך.