מרקטפלייס בAPI – חיבור לסליקה והפקת מסמכים באמצעות תקבול

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

תקבול מציעה מודל שבו כל ספק מקבל חשבון ומסוף סליקה נפרדים, בעוד המרקטפלייס מנהל את הפעילות באמצעות API או באמצעות תוסף WCFM.

פתיחת חשבון דברו איתנו

איך עובד המודל של תקבול?

כל ספק במרקטפלייס פועל כבית עסק עצמאי.

תהליך העסקה:

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

המרקטפלייס אינו מקבל את כספי העסקה ואינו מעביר אותם לספק.

פתיחת ספק חדש באמצעות API

תקבול מאפשרת לפתוח חשבון ספק ישירות מתוך מערכת המרקטפלייס.

פתיחת החשבון מתבצעת באמצעות:

POST /api/Account/CreateAccount

הבקשה יכולה לכלול:

שם העסק והבעלים
מספר עוסק או חברה
סוג ההתאגדות
כתובת ופרטי קשר
פרטי חשבון הבנק
תחום הפעילות
חבילת השירות
זהות הגורם המשלם על החבילה

המערכת תומכת בין היתר ב:

עוסק מורשה
חברה בע״מ
עוסק פטור
עמותה
שותפות
חברה ציבורית

החשבון החדש מקושר לחשבון הדילר של המרקטפלייס.

מי משלם עבור חבילת הספק?

ה‑API מאפשר לבחור מי משלם לתקבול:

המרקטפלייס משלם עבור הספק.
הספק משלם עבור החשבון שלו.

כאשר המרקטפלייס משלם, החשבון יכול להיפתח ולהיות משויך לחבילה שנבחרה בתהליך אחד.

כאשר הספק משלם, הוא מועבר לדף תשלום מאובטח של תקבול. לאחר התשלום החשבון מופעל, החבילה משויכת ונפתחת הרשאה לחיוב החודשי.

תהליך האימות מול חברת האשראי

לאחר העברת פרטי הספק באמצעות API:

נציג חברת האשראי יוצר קשר עם הספק.
מתבצעת שיחת אימות קצרה.
לאחר האימות ניתן להתחיל לסלוק.
הספק מקבל במייל הוראות להשלמת מסמכים.
המסמכים נשלחים ישירות לחברת האשראי.

חשוב להשלים את המסמכים בהקדם.

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

קבלת עדכון על פתיחת החשבון

תקבול מאפשרת לקבל עדכון אוטומטי לאחר הפעלת חשבון הספק.

המערכת יכולה לשלוח IPN לכתובת שהמרקטפלייס מגדיר.

העדכון כולל בין היתר:

סטטוס פתיחת החשבון
מזהה הספק
מזהה הקישור לדילר
מזהה המסוף
חבילת השירות
מפתח API
סוד API
תיאור שגיאה במקרה הצורך

מומלץ לעדכן את רשומת הספק במרקטפלייס לפי הודעת ה‑IPN ולא רק לפי ההפניה בדפדפן.

יש לשמור את מפתחות ה‑API בצורה מאובטחת בצד השרת.

ניתוב עסקה למסוף הספק

לאחר פתיחת החשבון מתקבלים פרטי החיבור של מסוף הספק.

בעת ביצוע הזמנה, המרקטפלייס מזהה את הספק ומשתמש בפרטי המסוף שלו לצורך יצירת העסקה.

באמצעות ה‑API ניתן ליצור כתובת לדף תשלום:

POST /api/ExtranalAPI/GetTakbullPaymentPageRedirectUrl

ניתן לעבוד באמצעות:

הפניה לדף תשלום
טופס המוטמע באתר
חיבור מתוך WooCommerce
חיבור באמצעות WCFM
פיתוח מותאם באמצעות API

המערכת תומכת בעסקאות רגילות, תשלומים, טוקנים, הוראות קבע ועסקאות מושהות בהתאם להגדרות המסוף.

אמצעי תשלום

בהתאם למסוף ולהסכם עם חברת האשראי, ניתן להציע:

כרטיסי אשראי ישראליים
כרטיסי אשראי זרים
עסקאות בתשלומים
Bit לעסקים
Apple Pay
Google Pay

אימות העסקה ועדכון המרקטפלייס

לאחר התשלום, המרקטפלייס מקבל עדכון על העסקה.

באמצעות ה‑API ניתן:

לאמת את הודעת התשלום
לקבל את פרטי העסקה
לבדוק אם העסקה אושרה
לקבל את מספר העסקה
לבדוק אם הופק מסמך
לקבל את מספר המסמך
לקבל את הטוקן, אם נשמר
לשלוף את פרטי ההזמנה

פעולות מרכזיות:

ValidateNotification – אימות הודעת תשלום
GetTransaction – קבלת פרטי עסקה
GetOrder – קבלת פרטי הזמנה מלאה
IPN – קבלת עדכון אוטומטי מהמערכת

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

הפקת חשבוניות וקבלות

תקבול יכולה להפיק מסמך אוטומטי יחד עם העסקה.

המסמך מופק מחשבון הספק ונשלח ללקוח.

סוג המסמך נקבע לפי סוג העסק:

עוסק פטור מפיק קבלה.
עוסק מורשה מפיק מסמך מתאים.
חברה בע״מ מפיקה מסמך מתאים.
עמותה יכולה להפיק קבלה או קבלת תרומה.

ניתן גם להפיק מסמך בנפרד באמצעות:

POST /api/DocumentApi/Create

ה‑API תומך בין היתר ב:

חשבונית מס
חשבונית מס־קבלה
חשבונית עסקה
קבלה
קבלת תרומה
מסמכי זיכוי

ניהול הגדרות המסמכים

המרקטפלייס יכול לנהל את הגדרות המסמכים של הספקים באמצעות API.

ניתן להגדיר:

סוג מסמך ברירת מחדל
חבות במע״מ
שפת המסמך
עיצוב המסמך
מספור מסמכים
תוכן הודעת המייל
שם השולח
שליחת העתק לספק
תוכן הודעת SMS
הוספת קישור לתשלום

פעולות מרכזיות:

GetDocumentSettings
UpdateDocumentSettings

כך ניתן להגדיר את חשבון הספק כחלק מתהליך ההצטרפות, ללא צורך בהגדרה ידנית מלאה.

זיכויים וביטולים

ניתן לבצע זיכוי מלא או חלקי באמצעות API:

POST /api/ExtranalAPI/Refund

אפשרויות הזיכוי כוללות:

ביטול עסקה
ביטול עסקה והפקת מסמך
זיכוי חלקי
זיכוי חלקי והפקת מסמך

אם הכסף כבר הועבר לספק, ההתחשבנות מתבצעת בינו לבין חברת האשראי בהתאם להסכם הסליקה שלו.

חיוב באמצעות טוקן

תקבול מאפשרת לשמור כרטיס בצורה מאובטחת ולקבל טוקן.

באמצעות הטוקן ניתן לבצע חיובים נוספים ללא הצגה חוזרת של טופס התשלום:

POST /api/ExtranalAPI/ChargeToken

החיוב מתבצע בהתאם להרשאת הלקוח ולהגדרות המסוף.

תפיסת מסגרת J5

ניתן לבצע תפיסת מסגרת לצורך פיקדון או הבטחת הזמנה.

האפשרות מתאימה בין היתר ל:

הזמנת אירוח
השכרת ציוד
שמירת מקום
שירות עתידי
פיקדון זמני

הפעלת J5 מותנית בסוג המסוף ובהגדרות חברת האשראי.

חיבור WooCommerce ו‑WCFM

לתקבול קיימים תוספים ל‑WooCommerce ול‑WCFM.

החיבור מאפשר:

לשייך חשבון תקבול לכל ספק
לשייך מסוף נפרד
לנתב עסקאות לספק המתאים
להפיק מסמכים בשם הספק
לנהל את הסליקה מתוך המרקטפלייס

כאשר נדרשת לוגיקה מיוחדת, ניתן לשלב בין התוסף לבין API.

גביית עמלת המרקטפלייס

העמלה אינה מנוכה מתוך עסקת הלקוח.

המרקטפלייס מחשב את העמלה וגובה אותה מהספק בנפרד.

אפשר לקבוע:

אחוז מכל עסקה
סכום קבוע להזמנה
דמי שימוש חודשיים
חבילת שירות קבועה
שילוב בין מנוי לעמלה

המרקטפלייס מפיק לספק חשבונית נפרדת בגין העמלה.

תוכנית הדילרים של תקבול

תקבול מציעה תוכנית דילרים לבתי תוכנה ולפלטפורמות.

במסגרת התוכנית:

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

מה הפתרון אינו כולל?

המודל של תקבול אינו כולל:

חשבון נאמנות
ארנק פנימי לספק
החזקת כספים עד תאריך עתידי
הקפאת כספים בעקבות מחלוקת
שחרור כספים לפי הוראת API
Split אוטומטי של עסקה אחת

כל ספק סולק במסוף שלו ומקבל את הכסף ישירות מחברת האשראי.

סביבת בדיקות למפתחים

תקבול מעמידה לרשות המפתחים תיעוד API וסביבת בדיקות.

באמצעות סביבת הבדיקות ניתן לבדוק:

פתיחת חשבון ספק
תהליך הפעלת החשבון
יצירת דף תשלום
ביצוע עסקה
אימות תוצאה
קבלת IPN
שליפת עסקה והזמנה
הפקת מסמכים
חיוב טוקן
זיכוי מלא או חלקי
הגדרות מסמכים

🧑‍💻 תיעוד API וסביבת הבדיקות:

https://api.takbull.co.il/ApiDocs

מתחילים לחבר את המרקטפלייס

תקבול מרכזת במקום אחד את תהליך פתיחת הספקים, מסופי הסליקה, ה‑API, התוספים והפקת המסמכים.

הפתרון מתאים למרקטפלייסים המעוניינים לעבוד עם מסוף נפרד לכל ספק, להעביר את הכסף ישירות לבית העסק ולנהל את כל תהליך החיבור מתוך הפלטפורמה.

פתיחת חשבון דברו איתנו