API, Webhooks, כפתור תשלום וחיבור לוורדפרס

FREEPAY מתחברת לכל אתר: וורדפרס, WooCommerce, אתר HTML או אתר שנבנה בכלי AI. המסך המרכזי הוא ניהול ← חיבור לאתר / וורדפרס.

שני סוגי מפתחות

שלב אחר שלב

1. מפתח ציבורי: בחיבור לאתר / וורדפרס לחצו יצירת מפתח ציבורי. החלפה (rotate) מבטלת את הקודם מיד.
2. מפתח סודי: בהגדרות ← API מלאו שם ובחרו הרשאה: קריאה בלבד, או קריאה וכתיבה (הפקת מסמכים). לחצו יצירת מפתח.
3. העתיקו את המפתח מיד. הוא לא יוצג שוב. ביטול מפתח נעשה באותו מסך.
4. כפתור תשלום: בכרטיס "כפתור תשלום לאתר (העתק-הדבק)" מעתיקים קוד מוכן ומדביקים באתר. הכפתור פותח את דף התשלום של המוצר.
5. וורדפרס / WooCommerce: לחצו הורדת התוסף (ZIP), התקינו בוורדפרס והזינו כתובת ומפתח סודי עם הרשאת כתיבה. - כפתור לדף: הקוד המקוצר [freepay_button product="..."]. - ב-WooCommerce מופק מסמך אוטומטית כשהזמנה שולמה.
6. פרומפט לסוכן קוד AI: בונים אתר עם AI? העתיקו את הפרומפט המוכן מהכרטיס, עם המפתח הציבורי ורשימת המוצרים.

Webhooks

1. בכרטיס "Webhooks - עדכונים לשרת שלכם" הזינו כתובת ובחרו אירועים: - document.issued - payment.succeeded - expense.created
2. לחצו הוספת webhook. כל webhook מקבל סוד חתימה.
3. שליחת בדיקה שולחת אירוע ping. ביומן שליחות רואים כל ניסיון.

טוב לדעת

• כתובת הבסיס של ה-API היא /api/v1, עם הכותרת Authorization: Bearer.
• שלחו Idempotency-Key בכל בקשת יצירה. כך בקשה חוזרת לא תפיק מסמך כפול.
• PDF שמורד דרך ה-API הוא תמיד "העתק נאמן למקור".
• כל קריאת API נרשמת בפעילות והתראות ← קריאות API. ראו יומן פעילות.
• שליחה שנכשלה ל-webhook מנוסה שוב 3 פעמים.

שאלות נפוצות

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

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

איך מונעים הפקה כפולה מהאתר?

שלחו את מספר ההזמנה בכותרת Idempotency-Key. בקשה חוזרת עם אותו מפתח מחזירה את התשובה המקורית ולא מפיקה מסמך נוסף.

פרטי האשראי עוברים דרך האתר שלי?

לא. הקונה מועבר לדף התשלום ומשם לדף המאובטח של UPAY. פרטי האשראי לא נוגעים באתר שלכם ולא נשמרים ב-FREEPAY.