PayPlus ב-Lovable – מסלול מהיר (לינקים לתשלום)

מה המטרה?

לאפשר לך לקבל תשלום מהלקוחות בצורה המהירה ביותר באמצעות לינק תשלום מוכן, שמוביל לדף סליקה מאובטח - לתשלום בכרטיס אשראי , Apple Pay , Google Pay
הלקוח נכנס ללינק, משלם, ומסיים את התהליך במהירות — ללא צורך בפיתוח או חיבור API.

---

שלב 1: התחברות למערכת PayPlus

היכנסו למערכת הניהול:
https://myaccount.payplus.co.il

התחברו באמצעות:

• שם משתמש: כתובת האימייל שלכם

• סיסמה: הסיסמה שבחרתם לחשבון

---

שלב 2: יצירת לינק לתשלום

לאחר ההתחברות:

1. לחצו בתפריט הימני על "סליקה"

2. לחצו על "לינקים לתשלום"

3. בצד שמאל לחצו על "הוספת לינק"

---

שלב 3: מילוי פרטי הלינק

מלאו את הפרטים הבאים:

• שם הקישור – לשימוש פנימי בלבד (הלקוח אינו רואה שדה זה)

• סוג הלינק – חד פעמי או רב פעמי

• סיבת התשלום – שם המוצר או השירות

• סכום מוצר – הסכום לתשלום

לאחר מכן לחצו על "שמור"

---

שלב 4: קבלת הלינק ושימוש בו

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

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

---

סיכום

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

---

חשבוניות פלוס

הצטרפתם כבר לשירות החשבוניות של PayPlus ? 

• לאחר כל תשלום תופק חשבונית או קבלה באופן אוטומטי

• המסמך יישלח ללקוח לכתובת המייל

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

---

 

 

---

ארכיטקטורת זרימה – Production Ready

איך זה עובד בקצרה:

1. הלקוח מזין פרטי תשלום (שם, אימייל, סכום) ב‑Frontend.

2. השרת שלך מקבל את הפרטים ומבצע קריאה ל‑PayPlus API עם ה‑Secret Key.

3. PayPlus מחזיר לינק תשלום מאובטח.

4. השרת מחזיר את הלינק ל‑Frontend, שמפנה את הלקוח לדף התשלום.

 חשוב: ה‑Secret Key נשמר תמיד בצד השרת בלבד, לעולם לא בדפדפן של הלקוח.

---

Endpoint לסביבת Production

POST https://restapi.payplus.co.il/api/v1.0/PaymentPages/generateLink

 זהו ה‑endpoint הרשמי ליצירת הלינק (PayPlus Documentation)

---

שדות חובה

פרמטר	תיאור
API_KEY	מפתח ה‑API שלך
SECRET_KEY	המפתח הסודי שלך (Server‑Side בלבד)
payment_page_uid	מזהה ייחודי של דף התשלום במערכת PayPlus
charge_method	סוג חיוב (רגיל / מושהה / recurring)
amount	סכום לתשלום
currency_code	מטבע (ILS / USD / EUR וכו')

---

דוגמת בקשה (POST)

POST https://restapi.payplus.co.il/api/v1.0/PaymentPages/generateLink
Content-Type: application/json
Authorization: Bearer <API_KEY>

{
  "payment_page_uid": "uid-1234",
  "charge_method": 1,
  "amount": 99.90,
  "currency_code": "ILS",
  "sendEmailApproval": true,
  "sendEmailFailure": false,
  "refURL_callback": "https://yourserver.com/payplus/callback",
  "initial_invoice": true,
  "more_info": "order-456",
  "customer": {
    "customer_name": "John Doe",
    "email": "[email protected]"
  }
}

---

הסבר פרמטרים מרכזיים

חובה

שם פרמטר	משמעות
payment_page_uid	מזהה הדף במערכת PayPlus
charge_method	סוג החיוב (1 = חיוב רגיל)
amount	סכום לתשלום
currency_code	קוד המטבע

אופציונלי

פרמטר	מה זה עושה
sendEmailApproval	שולח מייל אישור ללקוח על הצלחה
sendEmailFailure	שולח מייל על כישלון
refURL_callback	כתובת Webhook להתראה על סטטוס העסקה
initial_invoice	הפקת חשבונית אוטומטית (יש להצטרף לשירות החשבוניות שלנו)
more_info	שדה חופשי, לדוגמה מזהה הזמנה

---

דוגמת תגובה (Response)

{
  "isSuccessful": true,
  "payment_page_link": "https://payplus.co.il/pay/xxxxxx",
  "transaction_uid": "trans-uid-123"
}

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

---

דוגמאות קוד – Node.js (Express)

app.post("/create-paylink", async (req, res) => {
  const payload = {
    payment_page_uid: "uid-1234",
    charge_method: 1,
    amount: req.body.amount,
    currency_code: "ILS",
    customer: {
      customer_name: req.body.name,
      email: req.body.email
    }
  };

  const response = await fetch(
    "https://restapi.payplus.co.il/api/v1.0/PaymentPages/generateLink",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${process.env.PAYPLUS_API_KEY}`
      },
      body: JSON.stringify(payload)
    }
  );

  const json = await response.json();
  return res.json(json);
});

---

כללי אבטחה חשובים

• שמור את ה‑Secret Key בלבד בצד השרת

• אל תחשוף אותו ל‑Frontend או בדפדפן

• השתמש ב‑HTTPS לכל קריאה

• בצע בדיקות תחילה בסביבת Staging/Test לפני Production

---

טיפים לשימוש יעיל

• הכנס refURL_callback כדי לטפל בתוצאה אחרי שהתשלום מסתיים (Webhook)

• שלח sendEmailApproval: true אם רוצים מייל אוטומטי ללקוח

• ודא שהשם והאימייל של הלקוח נכונים במיוחד אם מפיקים חשבונית

• בצע טסטים של עסקאות סליקה והפקת חשבוניות בעת קבלת האישור לסליקה

---