דלג לתוכן הראשי

מדריך תקבול

העברת פרטי לקוח ומוצרים לדף סליקה באמצעות פרמטרים

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

כתובת דף הסליקה

כל קישור מתחיל בכתובת הבסיס הבאה:

https://paypage.takbull.co.il/xxxx
מהו xxxx? זהו המזהה של דף הלקוח במערכת תקבול. יש להחליף את xxxx במזהה האמיתי של הדף.

איך בונים את הקישור?

מתחילים בסימן שאלה הפרמטר הראשון נוסף אחרי הסימן ?.
מפרידים בין פרמטרים בין כל שני פרמטרים משתמשים בסימן &.
מקודדים את הערכים עברית, רווחים ותווים מיוחדים צריכים לעבור URL encoding. 
https://paypage.takbull.co.il/xxxx?name=יוסי כהן&phone=0501234567
לנוחות הקריאה: הדוגמאות במדריך מוצגות בעברית. בעת יצירת הקישור בקוד מומלץ להשתמש ב־URLSearchParams או בפעולת קידוד מקבילה.

פרטי לקוח

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

פרמטר דוגמה תיאור
name name=יוסי כהן השם המלא של הלקוח.
email email=yossi@example.com כתובת הדואר האלקטרוני של הלקוח.
id_number id_number=123456789 מספר תעודת הזהות של הלקוח, באורך 9 ספרות.
phone phone=0501234567 מספר הטלפון הנייד של הלקוח.
c_id c_id=CUST123456 מזהה ייחודי של הלקוח במערכת שלכם.

דוגמה מלאה לפרטי לקוח

https://paypage.takbull.co.il/xxxx?name=יוסי כהן&email=yossi@example.com&phone=0501234567&id_number=123456789&c_id=CUST123456
שימו לב: מומלץ להעביר מספר טלפון ותעודת זהות כמחרוזת טקסט, כדי לשמור על אפסים בתחילת המספר.

פרטי כתובת

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

פרמטר דוגמה תיאור
city city=תל אביב עיר המגורים.
country country=ישראל מדינת המגורים.
address1 address1=רחוב הרצל 10 רחוב ומספר בית.
address2 address2=דירה 5 מידע נוסף, כגון קומה, כניסה או מספר דירה.

דוגמה לכתובת מלאה

?address1=רחוב הרצל 10&address2=דירה 5&city=תל אביב&country=ישראל

העברת מוצרים לדף הסליקה

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

מבנה הפרמטר דוגמה תיאור
product_name[מספר] product_name1=חולצה שם המוצר שיוצג בעגלת הקניות.
product_price[מספר] product_price1=99.90 מחיר המוצר, ללא סימן מטבע.
product_quantity[מספר] product_quantity1=2 כמות היחידות של המוצר.
חשוב: הסוגריים המרובעים מציגים את מבנה הפרמטר בלבד. בכתובת עצמה כותבים את המספר ישירות, לדוגמה product_name1.

דוגמה למוצר אחד

?product_name1=חולצה&product_price1=99.90&product_quantity1=2

דוגמה למספר מוצרים

?product_name1=חולצה&product_price1=99.90&product_quantity1=2
&product_name2=מכנסיים&product_price2=149.90&product_quantity2=1
&product_name3=נעליים&product_price3=299.90&product_quantity3=1

דוגמה מלאה: לקוח, כתובת ומוצרים

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

https://paypage.takbull.co.il/xxxx?name=יוסי כהן&email=yossi@example.com&phone=0501234567&id_number=123456789&c_id=CUST123456&address1=רחוב הרצל 10&address2=דירה 5&city=תל אביב&country=ישראל&product_name1=חולצה&product_price1=99.90&product_quantity1=2&product_name2=מכנסיים&product_price2=149.90&product_quantity2=1

יצירת קישור תקין ב־JavaScript

השימוש ב־URLSearchParams מקודד אוטומטית עברית, רווחים ותווים מיוחדים.

const baseUrl = 'https://paypage.takbull.co.il/xxxx';

const params = new URLSearchParams({
  name: 'יוסי כהן',
  email: 'yossi@example.com',
  phone: '0501234567',
  id_number: '123456789',
  c_id: 'CUST123456',
  city: 'תל אביב',
  country: 'ישראל',
  address1: 'רחוב הרצל 10',
  address2: 'דירה 5',
  product_name1: 'חולצה',
  product_price1: '99.90',
  product_quantity1: '2'
});

const paymentUrl = baseUrl + '?' + params.toString();
אבטחה: פרמטרים בכתובת גלויים וניתנים לשינוי. אין להעביר מידע סודי, ובתהליך מסחרי מומלץ לאמת את פרטי ההזמנה והסכום גם במערכת המקור.

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

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

שאלות נפוצות

האם חייבים להעביר את כל הפרמטרים?

לא. ניתן להעביר רק את הפרטים הדרושים לכם ולדלג על שדות שאינם נדרשים.

מה צריך לכתוב במקום xxxx?

יש להחליף את xxxx במזהה של דף הלקוח במערכת תקבול.

איך מעבירים יותר ממוצר אחד?

מוסיפים מספר לכל קבוצת פרמטרים: product_name1, product_price1 ו־product_quantity1 למוצר הראשון; לאחר מכן משתמשים במספר 2 למוצר השני וכן הלאה.

האם כותבים סוגריים מרובעים בשם פרמטר המוצר?

לא. הסימון [מספר] מסביר את המבנה בלבד. בכתובת עצמה כותבים לדוגמה product_name1 או product_name2.

למה צריך לקודד עברית ורווחים?

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

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

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

הקישור מוכן לשימוש

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