נתוני העסקאות של Nayax לא יוצאים מה-API הניהולי אלא מערוץ דיווח נפרד: Amazon SQS בזמן אמת, או SFTP ומייל בתזמון. מה מגדירים ואילו שדות דרושים לניתוח.
עיקרי הדברים
- אל תחפשו נקודת קצה שמחזירה עסקאות. ב-Nayax העסקאות נדחפות אליכם, לא נמשכות על ידכם.
- שלוש שיטות אספקה מוגדרות: Amazon SQS, SFTP ומייל. הראשונה בזמן אמת, שתי האחרות בתזמון שעתי או יומי.
- ההגדרה יושבת ב-Nayax Core תחת Administration ואז Operator, בלשונית Transactions Report.
- הפורמט אינו זהה בין הערוצים: SQS ב-JSON, SFTP ומייל ב-XML או CSV עם מפריד שבוחרים.
- מי שלא סימן במפורש את סוגי העסקאות המיוחדים - חינם, מבוטלות, זיכויים ונדחות - יקבל דוח שמייצר מספרי מכירות שגויים.
נתוני המכירות של Nayax אינם יוצאים מה-API הניהולי. Nayax Core מגדיר ערוץ דיווח עסקאות נפרד: Amazon SQS בזמן אמת, או קובץ מתוזמן ב-SFTP או במייל. ה-API הניהולי, Lynx, עוסק במכונות, מכשירים, מלאי וכרטיסים - ולא בשורות העסקאות עצמן.
שלוש דלתות שונות לאותה מערכת
Nayax מפרסמת בפורטל המפתחים כמה משפחות ממשק, וכל אחת נוגעת בשאלה אחרת. הבלבול הנפוץ הוא לנסות להוציא נתוני מכירות מהדלת הלא נכונה:
- Lynx מתואר כ-Management API: ניהול מכונות, מכשירים, מלאי וכרטיסים מהסביבה שלכם. כתובות הבסיס המתועדות הן
https://qa-lynx.nayax.com/operationalלסביבת QA ו-https://lynx.nayax.com/operationalלייצור. זהו הממשק לתפעול, לא לדיווח. - דיווח עסקאות הוא ערוץ נפרד לגמרי, שמוגדר בממשק הניהול ולא בקוד: SQS, SFTP או מייל.
- Cortina הוא הצד של התשלום עצמו במכשיר - כרטיס אשראי, QR, כרטיס נטען - עם תיעוד לזרימות מכירה, ביטול, זיכוי וקודי דחייה.
מי שמתחיל מ-Lynx מפני ששם כתוב API יבזבז ימים לפני שיגלה שהעסקאות פשוט אינן שם.
איך באמת מוציאים שורות עסקאות מ-Nayax?
דרך ההגדרה בממשק, לא דרך קריאה. המסלול המתועד הוא Administration ואז Operator, בחירת האופרטור, ולשונית Transactions Report. שם בוחרים את שיטת האספקה ואת מה שנשלח.
| Amazon SQS | SFTP | מייל | |
|---|---|---|---|
| קצב | זמן אמת, לתור | מתוזמן | מתוזמן |
| פורמט | JSON | XML או CSV | XML או CSV |
| מה מגדירים | כתובת התור, Access Key, Secret Key | כתובת או שם מארח, פורט, שם משתמש, סיסמה | נמעני הדואר |
| מתאים ל | הזרמה למחסן נתונים או לתהליך אירועים | קליטה יומית ל-ETL | מעקב אנושי בלבד |
| מה שובר אותו | הרשאות בצד AWS | שינוי סיסמה שאיש לא עדכן | תיבה שהתמלאה |
השדות שנשלחים ב-SQS ניתנים לבחירה, בדומה לבחירת העמודות בדוח המתוזמן. בדוח המתוזמן בוחרים גם את סוג הקובץ, את המפריד - טאב, נקודה-פסיק, פסיק, רווח, קו אנכי או מפריד משלכם - והאם לכלול שורת כותרות. תדירות האספקה נבחרת כשעתית, עם בחירת הדקה, או יומית עם בחירת השעה.
שתי הרשאות משתמש נדרשות לפי התיעוד כדי להגדיר את זה בכלל: Transaction Dispatcher ו-Transactions Report Subscriber. אם אתם רואים את הלשונית ולא מצליחים לשמור, זו הנקודה הראשונה לבדוק.
זמן אמת או קובץ מתוזמן - מה באמת דרוש לכם?
התשובה נגזרת מהשאלה שאתם עונים עליה, לא מהיוקרה של הארכיטקטורה.
- אם השאלה היא "כמה מכרנו החודש לפי מכונה ולפי מוצר", קובץ יומי מספיק לחלוטין והוא הרבה יותר קל לתחזוקה.
- אם השאלה היא "האם מכונה הפסיקה למכור בשעתיים האחרונות", אתם צריכים זרימה בזמן אמת ולוגיקת התראה.
- אם השאלה היא "האם התשלום שנכשל אצל הלקוח הזה נכשל אצל עוד לקוחות", אתם צריכים גם את העסקאות הנדחות, וזו הגדרה נפרדת.
- אם אתם בונים גם התראות וגם דוחות, מותר לקחת את שניהם: SQS למה שדחוף, קובץ יומי לאמת ההיסטורית.
הכלל שחוסך הכי הרבה עבודה: הקובץ המתוזמן הוא מקור האמת, והזרימה בזמן אמת היא מנגנון התראה. הפוך מזה מייצר דוחות שמשתנים בכל פעם שמסתכלים עליהם.
מה מערך נתונים של מכונות אוטומטיות חייב להכיל
לפני שמישהו פותח גרף, ודאו שהשדות האלה קיימים בכל שורה. בלעדיהם אי אפשר לענות על שום שאלה עסקית:
- מזהה מכונה ומזהה המכשיר שעליה, מפני שמכשיר מוחלף והמכונה נשארת.
- מזהה הבחירה או המוצר, כפי שהוא מוגדר במכונה ולא כפי שהוא נקרא בשיווק.
- זמן העסקה עם אזור זמן מפורש. זו הטעות שהורסת השוואות בין ימים.
- הסכום, המטבע, ואמצעי התשלום.
- סטטוס העסקה, כולל האם מדובר בזיכוי, ביטול, עסקת חינם או ניסיון שנדחה.
- מזהה ייחודי של העסקה, שישמש למניעת כפילויות בקליטה חוזרת.
Nayax מאפשרת לסמן במפורש בדוח את הסוגים המיוחדים: Free Transactions, Cancelled Transactions, Refund Transactions ו-Declined Transactions. זו אינה שאלה טכנית אלא הגדרה עסקית: דוח שכולל עסקאות נדחות בלי לסמן אותן ינפח את המכירות, ודוח שמשמיט אותן לגמרי יסתיר תקלת תשלום שחוזרת.
מה אפשר לענות עליו כשהנתונים אצלכם
- אילו מכונות מייצרות את רוב ההכנסה, ואילו מכסות בקושי את עלות המיקום.
- אילו בחירות נמכרות בכל אתר ואילו תופסות מקום במגירה.
- באילו שעות באמת קונים, לפי מכונה ולא לפי ממוצע ארצי.
- מה שיעור הניסיונות שנדחו לכל מכונה, ואם הוא קופץ במכשיר מסוים.
- כמה זמן עובר בין מילוי למכירה, כשמצליבים עם דוחות המילוי.
- האם החלפת מחיר במוצר שינתה כמות או רק פדיון.
מה משתבש בקליטה, ואיך מגלים
- כפילויות. תור הודעות מבטיח מסירה, לא מסירה יחידה. קליטה שאינה אידמפוטנטית תספור מכירות פעמיים.
- אזור זמן. דוח שעתי בשעון אחד וניתוח בשעון אחר מייצרים "יום" שאינו יום.
- מכשיר שהוחלף. שיוך היסטורי לפי מזהה מכשיר במקום מזהה מכונה שובר את סדרת הזמן בדיוק ביום שבו קרה משהו.
- קובץ שלא הגיע. חוסר שקט הוא לא הצלחה. צריך התראה על היעדר קובץ, לא רק על קובץ פגום.
- שינוי עמודות. מי שבחר עמודות בממשק ושכח לעדכן את הסכימה יקבל קובץ תקין שנקלט לא נכון.
- ערבוב בין דוחות תשלום לדוחות ביקורת של המכונה. אלה שני מקורות שונים שסופרים דברים שונים.
זהו תיאור טכני של ערוצי הדיווח כפי שהם מתועדים בפורטל המפתחים של Nayax בספטמבר 2026. שמות מסכים ושדות משתנים בין גרסאות, ויש לאמת מול הממשק שלכם.
קשור: מהו צינור נתונים, אוטומציה של דוחות עסקיים, התאמת תנועות סליקה.
מקורות
שאלות נפוצות
יש ל-Nayax נקודת קצה שמחזירה רשימת עסקאות?
התיעוד הציבורי מתאר את דיווח העסקאות כערוץ אספקה - Amazon SQS בזמן אמת, או SFTP ומייל בתזמון - ואת Lynx כ-Management API לניהול מכונות, מכשירים, מלאי וכרטיסים. משיכת עסקאות בקריאה יזומה אינה מתועדת שם, ולכן יש לתכנן קליטה מהערוץ שנדחף אליכם.
באיזה פורמט מגיעים הנתונים?
תלוי בערוץ. ב-Amazon SQS ההודעות הן JSON, והשדות נבחרים בהגדרת העמודות. בדוח המתוזמן ל-SFTP או למייל בוחרים XML או CSV, ובוחרים גם מפריד - טאב, נקודה-פסיק, פסיק, רווח, קו אנכי או מפריד מותאם - והאם לצרף שורת כותרות.
למה מספרי המכירות שלי גבוהים ממה שהתקבל בפועל?
כמעט תמיד בגלל סוגי עסקאות שנכללו בלי סימון. בהגדרת הדוח אפשר לבחור במפורש Free Transactions, Cancelled Transactions, Refund Transactions ו-Declined Transactions. אם הם נכנסים לאותה עמודת סכום כמו מכירה רגילה, כל סיכום יהיה מנופח. הפרידו אותם לשדה סטטוס.
מה נדרש כדי להגדיר את זה בכלל?
לפי התיעוד, שתי הרשאות משתמש: Transaction Dispatcher ו-Transactions Report Subscriber. בנוסף, ל-SQS דרושים כתובת התור, Access Key ו-Secret Key מצד AWS, ול-SFTP דרושים כתובת או שם מארח, פורט, שם משתמש וסיסמה. בלי אלה אפשר לראות את המסך אך לא לסיים את ההגדרה.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.