Skip to main content
זמן משוער: 15 דקות התקנה.
דרישות התהליך:
  • חשבון פייפאל עסקי מאושר
  • דף מוכן לבחירת חבילות / תשלום באפליקציה שלכם
  • חשבון ספליטז מוגדר ומאושר לתשלום
  • לינק לתשלום שמקושר למוצר מנוי
המזהה לינק לתשלום ניתן להשיג מהדאשבורד בעמוד: לינקים לתשלום -> לחיצה על הלינק לתשלום ועל כפתור העתק uid בצד שמאל במסך קבלת מפתח api במסך ההגדרות -> api key תהליך האינטגרציה מורכב מ3 שלבים מאוד פשוט שמבוססים על הגיון פשוט: זיהוי לקוח ותשלום -> ולידציה לאחר תשלום -> יצירת לינק ניהול ללקוחות בהתחלה, ברגע שלקוח מבקש ממכם להירשם לחבילה מסויימת, אתם תהיו חייבים לשייך לינק לתשלום עם המייל שלו אצלנו במערכת
מה זה לינק לתשלום?לינק לתשלום הוא דף תשלום שהמערכת שלנו משייכת ללקוח שלכם, הדרך שלנו לזהות מי ביצע את התשלום אצלכם הוא על ידי המייל של הלקוח, ולכן ברגע שלקוח מעוניין להירשם לחבילה אצלכם אתם חייבים להגיד לנו מי רוצה לשלם כדי שאחרי זה תוכלו לוודא שאותו לקוח שילם אחרי הרכישה, ולתת לו גישה למערכת שלכם.
שימו לב שחובה להגדיר כתובת לחזרה לאחר תשלום מוצלחה (success url) על מנת שהמערכת תדע לאן להפנות את הלקוח שלכם לאחר תשלום מוצלח - תוכלו לבצע זאת בהגדרות לינק לתשלום. אחרי שהבנתם את הרקע הטכני, בואו נתחיל בהגדרה של לינק התשלום אצלכם במערכת.
חשוב מאוד שכל הקריאות שאתם מבצעים למערכת שלנו לא יהיו חשופות לצד הלקוח על מנת לשמור עלתהליך התשלום שלכם מאובטח. בLovable ניתן לעשות זאת באמצעות פיצר שנקרא Backend Function.
1

זיהוי לקוח ותשלום

הפרומט בשלב הזה אומר לAI שלכם להגדיר פונקציונליות לכפתור רכישה לחבילה מסויימתהפונקציונליות פה היא פנייה למערכת שלנו על מנת לקבל לינק לתשלום, ולאחר מכן להעביר את הלקוח ללינק שהחזרנו למערכת שלכם.מזהה לינק לתשלום ניתן להשיג במערכת מהמסך לינקים לתשלום -> בחירת הלינק שלהם
const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'your-api-key-here'
});

const paymentLink = await splitz.paymentLinks.generate({
  payment_link_uid: 'PAYMENT_LINK_UID',
  customer_email: 'האימייל של הלקוח שכרגע מחובר למערכת'
});

const url = paymentLink.url;
// return the url to the frontend using res.json({...
2

אימות תשלום וגישה למערכת

השלב השני נועד לבדוק האם הלקוח שלכם אכן שילם אחרי שיצא מלינק התשלום ששלחנו אותו עכשיו, במידה והוא שילם אנחנו מגדירים אותו במערכת כלקוח משלם ונותנים לו גישה למערכת.הפרמטר שייחזור בURL ששמו: subscription_uid יעזור לכם לזהות את המנוי ולאמת את התשלום.לדוגמא: https://example.com/subscriptionCallback?order_uid=xxxTHIS CODE WILL ONLY BE USED ON THE BACKEND.
const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE' // החלף בAPI Key שלך
});

// קבלת פרטי המנוי
const result = await splitz.subscriptions.get({
  subscription_uid: 'subscription_uid שהגיע מה-URL'
});

const subscription = result.subscription;

// בדיקת סטטוס
if (subscription.status === 'active' || subscription.status === 'cancelled') {
  // המנוי תקף - תן למשתמש גישה
  // שמור את subscription_uid בדאטאבייס
  
  console.log('המשתמש שילם! ✅');
  console.log('Product UID:', subscription.product_uid);
  console.log('Status:', subscription.status);
  
} else if (subscription.status === 'expired') {
  // המנוי פג תוקף - חסום גישה
  console.log('המנוי פג תוקף ❌');
}

​
הוספת כפתור ניהול מנוי

הפורטל מאפשר ללקוחות שלכם לצפות בפרטי המנוי שלהם, ולבטל או לשנות את המנוי שלהם בהתאם למה שהם רוצים / צריכים. 
const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE'
});

// יצירת לינק ניהול
const portal = await splitz.subscriptions.createManagementLink(
  'subscription_uid של המשתמש שמחובר (מהדאטאבייס)'
);

const managementUrl = portal.data.management_url;
const expiresIn = portal.data.expires_in_hours;

console.log('לינק ניהול:', managementUrl);
console.log('פג תוקף בעוד:', expiresIn, 'שעות');

// return the url to the frontend using res.json({...

​
שינוי בין חבילות למנוי

​
מה זה שינוי תוכנית?

שינוי תוכנית מאפשר ללקוחות שלך לעבור בין תוכניות שונות (למשל, מ-Basic ל-Premium) במהלך תקופת המנוי.
Prorated Billing - מה זה?נניח שלקוח שילם ₪99 לחודש (Basic), ובאמצע החודש הוא רוצה לעבור ל-Premium (₪199).הוא כבר שילם עבור Basic, אז הוא צריך לשלם רק את ההפרש עבור הזמן שנותר:
  • שילם: ₪99 לחודש שלם
  • השתמש: 15 ימים ב-Basic (₪49.50)
  • נשאר: 15 ימים → צריך Premium (₪99.50)
  • חיוב נוסף: ₪50 (ההפרש)
זה נקרא Prorated Billing - אתה משלם רק עבור מה שאתה משתמש.

​
מתי להשתמש בזה?

Upgrade

לקוח רוצה לשדרג לתוכנית יותר יקרהדוגמה: Basic → Premium

Downgrade

לקוח רוצה להוריד לתוכנית זולה יותרדוגמה: Premium → Basic
הערה חשובה:בשינוי תוכנית - הלקוח לא מבטל את המנוי הישן.
הוא פשוט משנה אותו לתוכנית אחרת, והתאריך חידוש נשאר אותו דבר.

​
איך זה עובד?

1

לקוח מבקש לשנות תוכנית

הלקוח לוחץ “שדרג ל-Premium” באפליקציה שלך
2

אתה שולח בקשה ל-Splitz

המערכת שלך שולחת ל-Splitz את המנוי + התוכנית החדשה
3

Splitz מחשב Prorated

המערכת מחשבת כמה הלקוח צריך לשלם (או מקבל זיכוי)
4

לקוח מאשר

אם יש תשלום נוסף - הלקוח מועבר לדף אישור ומשלם
5

התוכנית משתנה

המנוי עודכן לתוכנית החדשה! 🎉

​
הקוד

​
שליחת בקשה לשינוי תוכנית

const SplitzClient = require('splitz-payments');

const splitz = new SplitzClient({
  apiKey: 'YOUR_API_KEY_HERE'
});

// בקשה לשינוי תוכנית
const changeRequest = await splitz.subscriptions.requestProductChange({
  subscription_uid: 'XXXX',           // ה-subscription_uid של הלקוח
  target_product_uid: 'XXXX',        // התוכנית החדשה שהוא רוצה
  return_url: 'https://myapp.com/success' // לאן להפנות אחרי אישור
});

// הנתונים שחוזרים:
console.log('URL לאישור:', changeRequest.data.approval_url);
console.log('סכום Prorated:', changeRequest.data.prorated_amount);
console.log('דורש תשלום?', changeRequest.data.requires_payment);
subscription_uid
מזהה המנוי הנוכחי של הלקוח (זה שרצים עכשיו)target_product_uid
מזהה התוכנית שהלקוח רוצה לעבור אליהאפשר למצוא ב-Dashboard → מוצרים → לחץ על המוצר → product_uidreturn_url
הכתובת שהלקוח יחזור אליה אחרי שישלים את התשלום (או יאשר ללא תשלום)

​
טיפול בתגובה

המערכת מחזירה לך 3 דברים חשובים:
​
approval_url
string
הקישור שאליו צריך להעביר את הלקוח לאישור השינוי
​
prorated_amount
number
הסכום שצריך לשלם (חיובי) או זיכוי (שלילי)דוגמאות:
  • 50 → לקוח צריך לשלם ₪50
  • -30 → לקוח מקבל זיכוי של ₪30
  • 0 → אין תשלום נוסף
​
requires_payment
boolean
האם הלקוח צריך לשלם כסף נוסף?
  • true → צריך לשלם (Upgrade)
  • false → אין תשלום (Downgrade או Prorated = 0)
בכל המקרים המשתמש חייב לעבור לapprove_url לבצע את האישור עצמאית!

​
טיפול בחזרה מדף האישור

אחרי שהלקוח משלם (או מאשר), הוא חוזר ל-return_url שהגדרת.

​
הפרמטרים שחוזרים ב-URL:

פרמטרסוגתיאור
statusstringsuccess או failed
subscription_uidstringמזהה המנוי (לאימות)
new_planstringשם התוכנית החדשה (מקודד ב-URL)
prorated_chargenumberהסכום ששולם (או זוכה)