API ו־Webhooks
חיבור מלא למערכת אישורי ההגעה שלכם: אירועים, מתנות, סטטוסים ועדכונים בזמן אמת.
יצירת אירועים ואורחים
סנכרון אירוע מהמערכת שלכם להולורה, כולל מזהה חיצוני, תאריך ומטבע.
Webhooks בזמן אמת
עדכון מיידי כשמתנה שולמה, נכשלה או זוכתה. בלי polling ובלי השהייה.
סטטוסים וסיכומים
שליפת רשימת מתנות, סכומים וסטטוסים לאירוע, לסנכרון או לדוחות פנימיים.
זיכויים ודיווחים
פתיחת זיכוי, מעקב אחרי סטטוס, ודיווחים לפי אירוע או טווח תאריכים.
איך החיבור עובד
המערכת שלכם נשארת המקור לאורחים ולאירועים. דרך ה־API אתם שולחים להולורה את פרטי האירוע והאורח, ומקבלים בחזרה סטטוסי תשלום, סכומים ועדכונים. האורח משלם מעמוד אישור ההגעה שלכם, תחת המותג שלכם.
יצירת אירוע
לכל אירוע במערכת שלכם נוצר אירוע מקביל בהולורה. כך כל מתנה משויכת לאירוע הנכון ומופיעה בדשבורד של בעלי האירוע.
POST /api/v1/events
{
"externalId": "event_123",
"eventName": "החתונה של נועה ודניאל",
"eventDate": "2027-05-18",
"currency": "ILS"
}Webhooks
Webhook הוא קריאה שהולורה שולחת לכתובת שלכם ברגע שקורה משהו חשוב. במקום לבדוק סטטוס כל כמה שניות, המערכת שלכם מקבלת עדכון מיידי ויכולה לעדכן דשבורד, לשלוח הודעה לבעלי האירוע, או לרשום את המתנה אצלכם.
אירועים נפוצים:
- gift.paid: מתנה שולמה בהצלחה
- gift.failed: ניסיון תשלום נכשל
- gift.refunded: בוצע זיכוי
- event.summary.updated: עודכן סיכום מתנות לאירוע
דוגמה לגוף הבקשה שנשלחת אליכם:
POST https://your-system.co/webhooks/hallora
{
"id": "evt_9f2a",
"type": "gift.paid",
"createdAt": "2027-05-10T18:42:11Z",
"data": {
"eventId": "event_123",
"gift": {
"id": "gift_8841",
"amount": 500,
"currency": "ILS",
"guestName": "יעל כהן",
"status": "paid"
}
}
}אבטחה וגישה
הגישה ל־API מתבצעת עם מפתחות ייעודיים לכל לקוח. Webhooks נחתמים כך שתוכלו לאמת שכל עדכון באמת הגיע מהולורה. אפשר להגדיר כתובת Webhook נפרדת לסביבת בדיקות וסביבת פרודקשן.
לא רוצים לפתח עכשיו?
אפשר להתחיל בלי אינטגרציה: פותחים אירוע בהולורה ומקבלים לינק מתנה לשליחה ב־WhatsApp, בהזמנה או בהודעת SMS. כשתהיו מוכנים, מחברים API ו־White Label מלא.