ארכיטקטורת זרימה – Production Ready
איך זה עובד בקצרה:
-
הלקוח מזין פרטי תשלום (שם, אימייל, סכום) ב‑Frontend.
-
השרת שלך מקבל את הפרטים ומבצע קריאה ל‑PayPlus API עם ה‑Secret Key.
-
PayPlus מחזיר לינק תשלום מאובטח.
-
השרת מחזיר את הלינק ל‑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 אם רוצים מייל אוטומטי ללקוח
-
ודא שהשם והאימייל של הלקוח נכונים במיוחד אם מפיקים חשבונית
-
בצע טסטים של עסקאות סליקה והפקת חשבוניות בעת קבלת האישור לסליקה
