קורן בן עזרא
skills-ilמה זה Grow Payment Gateway (Meshulam)?
grow-payment-gateway הוא סקיל טכני שמלמד את Claude לבנות אינטגרציה עם שער הסליקה הישראלי Grow, לשעבר משולם, דרך ה Light API שלו. הוא מכסה דף תשלום מתארח, שמירת טוקן לחיוב חוזר, קישורי תשלום לחשבוניות, טיפול בהחזרים ואימות webhook, ומצביע במפורש על מלכודות נפוצות כמו שליחת JSON במקום FormData ובדיקת HTTP status במקום שדה status בגוף התשובה. אינו ייעוץ מס.
Grow, החברה שהייתה מוכרת בעבר בשם משולם, מציעה API אחד שמכסה דף תשלום, חיוב טוקן, קישורי תשלום וניהול הוראות קבע. grow-payment-gateway ממפה את כל אלה, אבל הערך האמיתי שלו הוא ברשימת המלכודות שהוא מזהיר מהן מראש. הכלל הראשון והחשוב ביותר, כל בקשה ל API חייבת להישלח כ multipart form data ולא כ JSON, ואם שולחים JSON, הבקשה לא נכשלת עם שגיאת תבנית ברורה, היא פשוט מתפרשת כשדות ריקים ומחזירה שגיאת סכום שגוי שמטעה מפתחים לחפש באג במקום הלא נכון.
מלכודת שנייה חשובה לא פחות, כל תשובה מה API מגיעה בקוד HTTP 200, גם כשהעסקה נכשלה. ההצלחה או הכישלון מסומנים בשדה status בתוך גוף התשובה, אחד להצלחה ואפס לכישלון, ולא בקוד ה HTTP עצמו. הסקיל גם מדגיש שאחרי קבלת webhook על תשלום, חובה לקרוא ל approveTransaction כדי לסגור את הלולאה מול Grow, שלב שמפתחים רבים מדלגים עליו ומשאירים עסקאות תקועות במערכת.
לדוגמה, עסק שרוצה לגבות 99 שקל בחודש למנוי מקבל הדרכה לשמירת טוקן כרטיס מהתשלום הראשון, וחיוב חודשי אוטומטי דרך createTransactionWithToken עם מזהה ייחודי לכל מחזור חיוב, כדי שתקלת רשת לא תגרום לחיוב כפול של אותו לקוח.
זהו מדריך טכני להטמעת סליקה, לא ייעוץ מס או משפטי. הסקיל עוסק בזרימת התשלום עצמה בלבד, ולא בהפקת מסמכי מס, ולכן יש לוודא בנפרד עם רואה חשבון שהעסק מוציא חשבונית מס או קבלה כחוק על כל עסקה. פרטי טוקן וכרטיס יש לטפל בהם כנתון רגיש ולעולם לא לרשום אותם בלוג.
למי זה מתאים
- בעלי אתרי מסחר שרוצים לחבר סליקה ישראלית עם דף תשלום מתארח
- מי שכבר עובד עם Grow או משולם ורוצה להוסיף תשלומים חוזרים או קישורי תשלום
- פרילנסרים שרוצים לשלוח קישור תשלום ללקוח דרך מייל או וואטסאפ בלי לבנות דף צ'ק אאוט
- מפתחים שנתקלים בשגיאות מוזרות מול Grow ורוצים להבין למה שגיאת סכום מופיעה גם כשהסכום תקין
- עסקים שרוצים לאפשר תשלום בביט, אפל פיי או גוגל פיי לצד כרטיס אשראי רגיל
מה הוא עושה
אזהרה מפורשת על פורמט הבקשה
כל קריאה חייבת FormData, לא JSON, כי שליחת JSON גורמת לשדות להתפרש כריקים ולשגיאת סכום מטעה במקום שגיאת תבנית ברורה.
בדיקת status ולא קוד HTTP
כל תשובה חוזרת עם קוד 200, גם בכישלון. ההצלחה נבדקת בשדה status בגוף התשובה, אחד להצלחה ואפס לכישלון.
שלב אישור חובה אחרי כל תשלום
קריאה ל approveTransaction אחרי קבלת ה webhook, שלב שחייב שני מזהים יחד ומפתחים רבים מדלגים עליו בטעות.
טוקניזציה לתשלומים חוזרים
שלוש דרכי הפעלה, עמוד תשלום מנוהל על ידי Grow, חיוב טוקן ישיר משרת לשרת, וסדרת חיוב פרימיום עם מזהה סדרה.
קישורי תשלום לחשבוניות
יצירת קישור תשלום לשליחה במייל, ב SMS או בוואטסאפ, שימושי לחשבונית פרילנסר בלי דף צ'ק אאוט.
אימות webhook לפני מילוי הזמנה
מדגיש שגוף ה webhook לא חתום, ולכן חובה לאמת מול Grow עם getTransactionInfo לפני שמזכים מוצר או שירות.
טבלת קודי שגיאה מפוענחים
מסביר קודי שגיאה נפוצים בעברית, כולל 712 שמסמן עסקה כפולה שכבר בוצעה, לא כישלון שדורש ניסיון חוזר.
דוגמאות שימוש
מה כותבים ל-Claude אחרי ההתקנה, ומה מקבלים.
דף תשלום ראשון לחנות
תשתמש בסקיל grow-payment-gateway ותעזור לי לבנות דף תשלום לחנות שלי עם Grow, סכום קבוע ואפשרות ביט לצד אשראי.מה מקבלים: קוד ליצירת createPaymentProcess עם FormData נכון, טיפול בתגובת ה callback, וקריאת approveTransaction אחרי אישור התשלום.
מנוי חודשי עם חיוב טוקן
תשתמש בסקיל grow-payment-gateway ותבנה חיוב חודשי אוטומטי של 99 שקל, עם שמירת כרטיס מהתשלום הראשון בלבד.מה מקבלים: שמירת cardToken מהתשלום הראשון, וקוד ל createTransactionWithToken עם מזהה עסקה ייחודי לכל חודש כדי למנוע חיוב כפול.
קישור תשלום לפרילנסר
תשתמש בסקיל grow-payment-gateway ותכין לי קישור תשלום לשליחה ללקוח במייל, על סכום של 2,400 שקל בעבור פרויקט עיצוב.מה מקבלים: קריאה ל createPaymentLink עם פרטי הלקוח והסכום, והחזרת כתובת URL מוכנה לשליחה.
דיבאג שגיאת סכום מוזרה
תשתמש בסקיל grow-payment-gateway ותעזור לי להבין למה אני מקבל שגיאת סכום שגוי למרות שהסכום שאני שולח תקין.מה מקבלים: בדיקה אם הבקשה נשלחת כ JSON במקום FormData, שהיא הסיבה הנפוצה ביותר לשגיאה הזו לפי הסקיל.
מה צריך לפני שמתחילים
- חשבון מסחר פעיל אצל Grow, עם userId, pageCode ולעיתים גם apiKey
- יכולת שליחת בקשות בפורמט multipart form data מהשרת, לא מהדפדפן
- כתובת HTTPS ציבורית לכתובות ה notifyUrl וה successUrl, לא כתובת localhost
- אין דרישת Python או תלות חיצונית להפעלת הסקיל עצמו
- אינו ייעוץ מס, ואינו מטפל בהפקת חשבונית מס בעצמו
אין עדיין Claude Code? במדריך הזה יש התקנה צעד אחרי צעד.
איך מתקינים את Grow Payment Gateway (Meshulam).
יש 3 דרכים, ומספיקה אחת מהן. הראשונה הכי פשוטה, בלי קוד בכלל.
הכי פשוט: באפליקציה של Claude, בלי שום קוד
מתאים ל-Claude במחשב ובדפדפן. לוקח דקה, ועושים את זה פעם אחת.
- מורידים את הסקילהורדת grow-payment-gateway.zip (42 KB)לא פותחים את הקובץ, מעלים אותו כמו שהוא.
- מדליקים פעם אחת את היכולתב-Claude נכנסים ל-Settings, ואז Capabilities, ומדליקים את
Code execution and file creation. - מעלים את הקובץנכנסים ל-Customize, ואז Skills, לוחצים על הפלוס, בוחרים
Create skillואזUpload a skill, ובוחרים את הקובץ שהורדתם. - זהו, עובדיםמבקשים מ-Claude את המשימה במילים רגילות, והוא משתמש בסקיל לבד כשהוא רלוונטי.
ב-Claude Code: מדביקים הודעה אחת
פותחים שיחה חדשה ב-Claude Code, מעתיקים את ההודעה ומדביקים. כש-Claude מבקש אישור להריץ, לוחצים Allow.
תתקין לי בבקשה את הסקיל grow-payment-gateway מהמאגר skills-il/tax-and-finance לתיקיית הסקילים שלי. תריץ את הפקודה הזו בדיוק: D="$(mktemp -d)" && git clone --depth 1 -q https://github.com/skills-il/tax-and-finance "$D/repo" && mkdir -p ~/.claude/skills && cp -R "$D/repo/grow-payment-gateway" ~/.claude/skills/ && rm -rf "$D" && echo "הותקן ✓"
בטרמינל, ידנית
למי שמעדיף להריץ בעצמו. מעתיקים לטרמינל ומריצים.
git clone --depth 1 https://github.com/skills-il/tax-and-finance /tmp/skills-il-tax-and-finance mkdir -p ~/.claude/skills cp -R /tmp/skills-il-tax-and-finance/grow-payment-gateway ~/.claude/skills/ rm -rf /tmp/skills-il-tax-and-finance npx skills-il add skills-il/tax-and-finance@v1.4.2-grow-payment-gateway --skill grow-payment-gateway -a claude-code -y -g
פותחים חשבון מסחר אצל Grow ומקבלים userId ו pageCode. אם משתמשים בסקריפט העזר המצורף, מגדירים משתנה סביבה בשם MESHULAM_API_KEY. אחר כך מפעילים מחדש את Claude Code.
- מריצים ls ~/.claude/skills ומוודאים שמופיעה תיקיית grow-payment-gateway
- שואלים את Claude האם קוד HTTP 200 מעיד על הצלחת תשלום ב Grow, ובודקים שהתשובה מסבירה שצריך לבדוק את שדה status בגוף התשובה
- מריצים בקשת בדיקה מול סביבת ה sandbox של Grow ומוודאים שמתקבלת תשובה תקינה
מריצים שוב את פקודת ההתקנה, והיא מעתיקה את הגרסה העדכנית מעל הקיימת.
rm -rf ~/.claude/skills/grow-payment-gateway
איך משתמשים ביום יום
- מוסרים מראש userId ו pageCode כדי לקבל קוד מדויק, ולא רק תבנית כללית
- מציינים אילו אמצעי תשלום רוצים לאפשר, אשראי, ביט, אפל פיי או גוגל פיי
- בכל בדיקת קוד, מוודאים שהבקשה נשלחת כ FormData ולא כ JSON
- אחרי קבלת webhook, תמיד מבקשים גם את שלב ה approveTransaction, לא רק את הטיפול בתוצאה
טיפים שימושיים
- אם מתקבלת שגיאת סכום שגוי שלא הגיונית, בודקים קודם אם הבקשה נשלחה כ JSON בטעות במקום FormData
- אף פעם לא סומכים על ה callback שמגיע לדפדפן, מוודאים תשלום דרך קריאת שרת לשרת בלבד
- קוד שגיאה 712 מסמן עסקה שכבר בוצעה, ולא כישלון שדורש ניסיון חוזר, טיפול שגוי בו עלול לגרום לחיוב כפול
- לחיוב טוקן חוזר, שולחים מזהה עסקה ייחודי וקבוע לאותו חיוב לוגי, לא מזהה חדש בכל ניסיון חוזר
- לפני שמפרסמים לייצור, בודקים שהתקשורת עם Grow מגיעה מהשרת ולא מהדפדפן, כי בקשות מהדפדפן נחסמות בלי הודעת שגיאה ברורה
תקלות נפוצות
כל הבקשות נכשלות עם שגיאת סכום שגוי
הקוד בודק את סטטוס ה HTTP ותמיד מקבל הצלחה
עסקאות נשארות תקועות אצל Grow
בקשה מהדפדפן נכשלת בלי שגיאה ברורה
שאלות ותשובות
Grow ו משולם זה אותו דבר
אפשר לבדוק את הקוד בלי חשבון מסחר
הסקיל מפיק חשבונית מס בעצמו
מה קורה אם לא קוראים ל approveTransaction
קרדיט ומקור. Grow Payment Gateway (Meshulam) נכתב על ידי skills-il ונמצא ב-skills-il/tax-and-finance ברישיון MIT. skills-il הוא פרויקט קוד פתוח ישראלי של סקילים ל-AI, ואפשר למצוא את כל הסקילים שלהם גם ב-agentskills.co.il. את העמוד כתב קורן בן עזרא אחרי בדיקה של המאגר ושל פקודות ההתקנה (30.09.2026). מאגרים מתעדכנים, ולכן אם משהו השתנה, המאגר הוא המקור הקובע.