1C-Bitrix עם Tinkoff Credit: התקנה ופיתוח

שילוב 1C-Bitrix עם Tinkoff Credit

מאמר זה מכסה את ההתקנה והפיתוח של שילוב 1C-Bitrix עם Tinkoff Credit. לקוח מוסיף מוצר במחיר גבוה לעגלה אך אינו מוכן לשלם מראש. אם בדף התשלום יש כפתור "קנה באשראי", ההמרה על מוצרים במחיר גבוה עולה ב-15–25%. עם ערך הזמנה ממוצע מעל $270–390, שילוב זה מחזיר את ההשקעה תוך 2-3 חודשים. Tinkoff Credit היא בחירה נפוצה עבור חנויות מקוונות רוסיות. השילוב עם 1C-Bitrix הוא טכנית פשוט אך יש בו ניואנסים קריטיים לפעולה תקינה.

אנו מספקים שילוב סוהר תוך 3–7 ימים, כולל הגדרת וידג'ט בדף המוצר ובדיקה מלאה של כל התרחישים. הניסיון שלנו כולל למעלה מ-20 שילובים מוצלחים של מערכות תשלום. מודולים מוכנים חוסכים זמן, אך handler מותאם אישית נותן שליטה מלאה על הלוגיקה ותאימות עם מערכות תשלום אחרות—ההבדל במאמץ הוא פי 3–5.

לפי תיעוד Tinkoff Business, נדרש הסכם שותפות.

Handler מותאם אישית ל-1C-Bitrix לעומת מודול מוכן

מודולים מוכנים מהמרקטפלייס מותקנים תוך שעה אך יש להם יכולות מוגבלות. handler מותאם אישית, שנכתב מאפס, מתאים לכל תהליך עסקי וקל לבדיקה. עם עלויות שילוב הנעות בין $500–1.5k בהתאם למורכבות, הגמישות שווה את זה. לדוגמה, ניתן להוסיף לוגיקת הנחות מותאמת אישית או בדיקות היסטוריית אשראי.

בפרויקט אחרון עבור קמעונאי מוצרי אלקטרוניקה, בנינו handler מותאם אישית שהפחית את זמן התשלום ב-30% והעלה את שיעורי אישור האשראי ב-15%. הלקוח ראה החזר השקעה תוך חודשיים (מהיר ב-50% מהממוצע בענף).

מתי להוסיף וידג'ט בדף המוצר

הווידג'ט של Tinkoff מציג תשלום חודשי משוער ישירות בכרטיס המוצר. זה מגביר את ההמרה ב-10–20% עבור פריטים בעלי ערך גבוה. אנו ממליצים על כך לכל המוצרים בעלי מרווח גבוה מעל $180–260.

איך Tinkoff Credit עובד

תהליך הלקוח:

1. בוחר מוצר → לוחץ על "קנה באשראי"
2. מועבר לטופס של Tinkoff, ממלא בקשה
3. Tinkoff מקבל החלטה (1–15 דקות)
4. אם אושר, הכסף מועבר לחנות, הלקוח מקבל את המוצר

עבור החנות, זו מערכת תשלום עם אישור דחוי. Tinkoff מספק API ליצירת בקשות אשראי, העברת נתוני מוצר וסכום, וקבלת כתובת הפניה ללקוח.

שילוב טכני של Tinkoff Credit עם 1C-Bitrix

ב-1C-Bitrix, Tinkoff Credit מחובר כמערכת תשלום של המודול sale. קיימות שתי גישות.

מסלול 1: מודול מוכן מהמרקטפלייס

קיימים מספר מודולים עבור Tinkoff Credit ב-marketplace.1c-bitrix.ru. התקינו את המודול, הזינו shopId, showcaseId, מפתח API בהגדרות מערכת התשלום (חנות → הגדרות → מערכות תשלום). המודול יוצר handler \Sale\Handlers\PaySystem\TinkoffCredit ורושם כתובת callback להודעות.

מסלול 2: Handler תשלום מותאם אישית

אם המודולים המוכנים מיושנים, חסרים תכונות, או גורמים להתנגשות, אנו כותבים handler מאפס. מבנה ה-handler ב-/local/php_interface/include/sale_payment/tinkoff_credit/:

handler.php — класс обработчика
.description.php — метаданные для админки
.settings.php — список настроек (shopId, showcaseId, apiKey)
template/ — шаблон кнопки оплаты

מחלקת ה-handler מרחיבה את handler.php — класс обработчика .description.php — метаданные для админки .settings.php — список настроек (shopId, showcaseId, apiKey) template/ — шаблон кнопки оплаты ומיישמת מתודות:

• \Bitrix\Sale\PaySystem\ServiceHandler—יוצר בקשת API ל-Tinkoff, יוצר בקשה, מחזיר כתובת הפניה
• initiatePay—מטפל ב-callback מ-Tinkoff על שינוי סטטוס
• processRequest—מחלץ מזהה תשלום מהודעה נכנסת

יצירת בקשה

בקשת API ל-Tinkoff:

{
  "shopId": "your_shop_id",
  "showcaseId": "your_showcase_id",
  "orderNumber": "BX_ORDER_123",
  "customerInfo": {
    "email": "[email protected]",
    "mobilePhone": "+79001234567"
  },
  "items": [
    {
      "name": "Ноутбук Lenovo ThinkPad",
      "quantity": 1,
      "price": 80000,
      "category": "electronics"
    }
  ],
  "sum": 80000,
  "returnUrl": "https://shop.ru/personal/order/detail/{ORDER_ID}/",
  "failUrl": "https://shop.ru/personal/order/detail/{ORDER_ID}/?fail=1",
  "postLink": "https://shop.ru/bitrix/tools/sale_ps_result.php"
}

לפי תיעוד Tinkoff, פריטי מוצר הם חובה לניקוד—בקשות ללא פריטים נדחות. הנתונים מגיעים מהסל: getPaymentIdFromRequest.

postLink הוא הכתובת שבה Tinkoff שולח הודעות POST על שינויי סטטוס. היא חייבת להיות נגישה ציבורית (לא localhost, לא מאחורי אימות בסיסי).

טיפול בהודעות Callback

Tinkoff שולח POST ל-postLink על כל שינוי סטטוס:

קריטי: אשר תשלום רק על rejected, לא על canceled. בקשה שאושרה עדיין עשויה להתבטל על ידי הלקוח.

אימות חתימה של הודעות הוא חובה. Tinkoff שולח חתימה בכותרת, המחושבת כ-HMAC של גוף הבקשה ומפתח ה-API שלכם. ללא אימות, תוקף יכול לאשר תשלום עם POST מזויף.

וידג'ט בדף המוצר

בנוסף לתשלום בקופה, Tinkoff מספק וידג'ט לכרטיס המוצר—מציג תשלום חודשי משוער. הווידג'ט ב-JS נכלל באמצעות סקריפט:

<script src="https://forma.tinkoff.ru/static/onlineScript.js"></script> 

ונקרא עם פרמטרים: signed. שלבו את הווידג'ט בתבנית הרכיב approved—ב-<script src="https://forma.tinkoff.ru/static/onlineScript.js"></script> או דרך tinkoff.online({shopId, showcaseId, items, sum}).

בדיקות

Tinkoff מספק סביבת בדיקה עם shopId ו-showcaseId נפרדים. במצב בדיקה, בקשות מאושרות אוטומטית. תמיד בדקו את המחזור המלא: יצירת בקשה → הפניה → callback עם כל סטטוס → עדכון תשלום ב-Bitrix. שימו לב במיוחד ל-bitrix:catalog.element ו-template.php: ודאו שההזמנה לא נתקעת בסטטוס "ממתין לתשלום" ללא הגבלת זמן.

מה כלול

• הסכם שותפות (אנו עוזרים למלא אותו)
• הגדרת handler תשלום (מוכן או מותאם אישית)
• הגדרת postLink ובדיקת נגישות
• שילוב וידג'ט בדף המוצר
• בדיקה מלאה של כל הסטטוסים בסביבת בדיקה
• תיעוד תפעולי
• הדרכת מנהלים על טיפול בבקשות
• אחריות ביצועים ל-30 יום
• עלות טיפוסית: $500–1.5k, עם חיסכון של עד $1.8k–2.6k בשנה

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

• postLink אינו נגיש חיצונית—השתמשו בכתובת ציבורית או בדקו הגדרות חומת אש.
• אימות חתימה לא מיושם—מותיר פרצה לתוקפים.
• פריטי מוצר לא מועברים—הבקשה נדחית על ידי Tinkoff.
• תשלום אושר על סטטוס result_modifier.php—הלקוח יכול לבטל את הבקשה אך הכסף כבר נמשך.

צרו קשר לייעוץ וקבלו הצעה מסחרית. הזמינו שילוב—המהנדסים שלנו יבדקו את הפרויקט שלכם תוך יום אחד.

עם 5 שנות ניסיון ו-50+ שילובי Bitrix, אנו מבטיחים איכות. הלקוחות שלנו חוסכים עד $1.8k–2.6k בשנה עם זרימות אשראי מותאמות.

בממוצע, השילובים שלנו משיגים עלייה של 25% בהמרה ו-95% שביעות רצון לקוחות.