קורן בן עזרא
skills-ilמה זה Cardcom Payment Gateway?
cardcom-payment-gateway הוא סקיל טכני שמלמד את Claude לבנות אינטגרציה עם חברת הסליקה הישראלית Cardcom, כולל דף תשלום מאובטח, טוקניזציה לחיוב חוזר, והפקה אוטומטית של חשבונית מס וקבלה בהתאם לחוק. הוא מבוסס על ה API הרשמי V11, כולל בדיקות אימות תשלום מלאות ומנגנון מספר ההקצאה. אינו ייעוץ מס או הנהלת חשבונות.
עסק ישראלי שרוצה לקבל תשלומים באתר צריך גם לסלוק אשראי וגם להוציא חשבונית מס כחוק, ורוב שערי הסליקה מטפלים רק בחלק הראשון. cardcom-payment-gateway מכוון בדיוק לנקודה הזו, כי Cardcom מייצרת חשבונית וקבלה אוטומטית כחלק מתהליך התשלום עצמו, על ידי הוספת אובייקט Document לבקשת התשלום. הסקיל מסביר את שלוש דרכי האינטגרציה, Low Profile שבה Cardcom מציגה את טופס האשראי בעצמה, קריאה ישירה בין שרתים לחיוב טוקן שמור, ויצירת מסמך בלבד בלי תשלום.
החלק הכי חשוב לבדיקה הוא אימות תוצאת התשלום, כי הקוד ברמה העליונה של תשובת ה API לא בהכרח אומר שהעסקה הצליחה, הוא רק אומר שהבקשה הייתה תקינה מבחינה טכנית. התוצאה האמיתית של החיוב יושבת שכבה עמוקה יותר בתוך השדה TranzactionInfo, וצריך לבדוק חמישה תנאים לפני שממלאים הזמנה, כולל שהסכום בפועל תואם למה שציפיתם וששדה המסמך לא ריק. הסקיל גם מסביר בפירוט את חובת מספר ההקצאה על חשבוניות מעל הסף, ומדגיש שיש להפעיל אותה בהגדרות התאגיד ברשות המסים, היא לא פעילה כברירת מחדל.
לדוגמה, בעל חנות שרוצה לגבות תשלום חודשי של 149 שקל למנוי מקבל הדרכה ליצירת טוקן בתשלום הראשון, שמירת פרטי הכרטיס באופן מאובטח בלבד, וחיוב אוטומטי כל חודש עם מזהה עסקה ייחודי שמונע חיוב כפול במקרה של תקלת תקשורת.
זהו מדריך טכני להטמעת סליקה, לא ייעוץ מס, הנהלת חשבונות או משפטי. המסמכים שהאינטגרציה מפיקה הם מסמכי מס לכל דבר, ואחריות התאמתם לדין ולתיעוד הנכון היא של בעל העסק. יש לוודא עם רואה חשבון שהגדרות המסמכים והרשאת מספר ההקצאה תקינות לפני מעבר לסביבת ייצור.
למי זה מתאים
- בעלי חנויות אונליין ואתרי איקומרס שרוצים לקבל אשראי ולהפיק חשבוניות אוטומטית באותו תהליך
- מפתחים שבונים מנוי חודשי או תשלום חוזר עם חיוב אוטומטי של כרטיס שמור
- עסקים שכבר עובדים עם Cardcom ורוצים להוסיף אמצעי תשלום כמו Bit, Apple Pay או Google Pay
- מי שצריך להוציא חשבונית מס בלבד על תשלום שכבר התקבל בהעברה בנקאית
- פרילנסרים או סוכנויות שבונות אתרי לקוחות ורוצות תבנית אינטגרציה מהימנה ל Cardcom
מה הוא עושה
שלוש דרכי אינטגרציה מוסברות
Low Profile לדף תשלום מאובטח עם היקף PCI מינימלי, קריאת שרת לשרת לחיוב טוקן, ויצירת מסמך בלבד בלי תשלום.
חמישה תנאים לאימות תשלום
רשימה מדויקת של מה חייב להתקיים לפני מילוי הזמנה, כולל שהתוצאה הפנימית של העסקה תקינה ושהסכום תואם למצופה.
הפקת חשבונית וקבלה אוטומטית
הוספת אובייקט Document לבקשת התשלום מפיקה חשבונית מס וקבלה כחוק, כולל שליחה אוטומטית במייל ללקוח.
הסבר מלא על מספר הקצאה
מדגיש שהמנגנון פועל אוטומטית מול רשות המסים, אבל לא מופעל כברירת מחדל וטעון הרשמה בהגדרות התאגיד ברשות המסים.
טוקניזציה לתשלומים חוזרים
יצירת טוקן בתשלום ראשון ושימוש בו לחיוב חודשי, עם מזהה עסקה ייחודי שמונע חיוב כפול בתקלת תקשורת.
טיפול בהחזרים וביטולים
הבחנה בין ביטול עסקה לפני זיכוי לבין החזר אמיתי אחרי זיכוי, כל אחד עם קריאת API נפרדת.
תיעוד שגיאות מדויק
מסביר את מבנה קוד השגיאה האמיתי של V11 ומזהיר מפני שדות ישנים ממדריכים מיושנים שלא קיימים בגרסה הנוכחית.
סקריפט אימות תגובה
validate_cardcom_response.py בודק תגובת API אחת ומצביע אם יש בה בעיה, תשלום, טוקן או מסמך, לפני שממשיכים בקוד.
דוגמאות שימוש
מה כותבים ל-Claude אחרי ההתקנה, ומה מקבלים.
צ'ק אאוט עם חשבונית אוטומטית
תשתמש בסקיל cardcom-payment-gateway ותעזור לי לבנות דף תשלום לאתר איקומרס שלי שמפיק חשבונית מס וקבלה אוטומטית ללקוח.מה מקבלים: קוד ליצירת Low Profile עם אובייקט Document מצורף, ו webhook שמאמת את התשלום בפועל לפני שליחת אישור הזמנה.
מנוי חודשי עם חיוב טוקן
תשתמש בסקיל cardcom-payment-gateway ותבנה לי חיוב חודשי אוטומטי של 149 שקל למנוי, עם שמירת כרטיס אשראי בפעם הראשונה בלבד.מה מקבלים: תהליך שמירת טוקן בתשלום הראשון, וקוד לחיוב חודשי דרך cron עם מזהה עסקה ייחודי לכל מחזור חיוב.
חשבונית בלי סליקה
תשתמש בסקיל cardcom-payment-gateway ותעזור לי להפיק חשבונית מס דרך Cardcom על תשלום שכבר קיבלתי בהעברה בנקאית.מה מקבלים: קריאה ישירה ל Documents/CreateDocument עם פרטי הלקוח והמוצר, בלי חיוב אשראי בכלל.
טיפול בהחזר כספי ללקוח
תשתמש בסקיל cardcom-payment-gateway ותסביר לי איך להחזיר ללקוח 100 שקל מתוך עסקה של 300 שקל, כולל מסמך זיכוי.מה מקבלים: קריאה ל RefundByTransactionId עם סכום חלקי, ולאחריה יצירת מסמך זיכוי תואם כדי שהחשבונות יתאזנו.
מה צריך לפני שמתחילים
- חשבון מסחר פעיל אצל Cardcom, עם מספר טרמינל, שם משתמש API וסיסמת API
- אימות מספר הקצאה מופעל בהגדרות התאגיד באתר רשות המסים, לצורך חשבוניות מעל הסף
- Python 3 אופציונלי בלבד להרצת סקריפט האימות המצורף
- כתובת HTTPS ציבורית לכתובות ה webhook וההפניה, לא כתובת localhost
- אינו ייעוץ מס והוא לא בודק לבד את התאמת הגדרות המסמכים לצרכי העסק
אין עדיין Claude Code? במדריך הזה יש התקנה צעד אחרי צעד.
איך מתקינים את Cardcom Payment Gateway.
יש 3 דרכים, ומספיקה אחת מהן. הראשונה הכי פשוטה, בלי קוד בכלל.
הכי פשוט: באפליקציה של Claude, בלי שום קוד
מתאים ל-Claude במחשב ובדפדפן. לוקח דקה, ועושים את זה פעם אחת.
- מורידים את הסקילהורדת cardcom-payment-gateway.zip (56 KB)לא פותחים את הקובץ, מעלים אותו כמו שהוא.
- מדליקים פעם אחת את היכולתב-Claude נכנסים ל-Settings, ואז Capabilities, ומדליקים את
Code execution and file creation. - מעלים את הקובץנכנסים ל-Customize, ואז Skills, לוחצים על הפלוס, בוחרים
Create skillואזUpload a skill, ובוחרים את הקובץ שהורדתם. - זהו, עובדיםמבקשים מ-Claude את המשימה במילים רגילות, והוא משתמש בסקיל לבד כשהוא רלוונטי.
ב-Claude Code: מדביקים הודעה אחת
פותחים שיחה חדשה ב-Claude Code, מעתיקים את ההודעה ומדביקים. כש-Claude מבקש אישור להריץ, לוחצים Allow.
תתקין לי בבקשה את הסקיל cardcom-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/cardcom-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/cardcom-payment-gateway ~/.claude/skills/ rm -rf /tmp/skills-il-tax-and-finance npx skills-il add skills-il/tax-and-finance@v2.4.0-cardcom-payment-gateway --skill cardcom-payment-gateway -a claude-code -y -g
פותחים חשבון מסחר אצל Cardcom ומקבלים מספר טרמינל, שם משתמש וסיסמת API. אם רוצים להריץ את סקריפט האימות, מתקינים Python 3. אחר כך מפעילים מחדש את Claude Code.
- מריצים ls ~/.claude/skills ומוודאים שמופיעה תיקיית cardcom-payment-gateway
- שואלים את Claude אילו חמישה תנאים צריכים להתקיים לפני שממלאים הזמנה אחרי תשלום, ובודקים שהתשובה מפרטת את כולם
- מריצים בקשת בדיקה מול טרמינל הבדיקה של Cardcom ומוודאים שמתקבלת תשובה עם ResponseCode
מריצים שוב את פקודת ההתקנה, והיא מעתיקה את הגרסה העדכנית מעל הקיימת.
rm -rf ~/.claude/skills/cardcom-payment-gateway
איך משתמשים ביום יום
- מוסרים מראש אילו פרטים כבר יש, מספר טרמינל, שם משתמש וסיסמת API, כדי לקבל קוד מדויק ולא כללי
- מציינים איזה סוג מסמך צריך, חשבונית מס וקבלה, חשבונית בלבד, או קבלה בלבד
- לפני העלאה לייצור, מבקשים מהסקיל לבדוק את חמשת תנאי האימות בקוד שנכתב
- פרטי כרטיס אשראי אף פעם לא נשמרים בקוד עצמו, רק טוקן שמתקבל מ Cardcom
טיפים שימושיים
- עדיף להתחיל עם Low Profile, זה מקטין את היקף התאימות ל PCI ומשאיר את הזנת הכרטיס אצל Cardcom
- בכל חיוב טוקן שולחים מזהה עסקה ייחודי משלכם, כדי שתקלת תקשורת לא תגרום לחיוב כפול באמת
- מספר ההקצאה על חשבוניות לא פעיל אוטומטית, צריך להפעיל אותו במערכת ההרשאה הדיגיטלית ברשות המסים לפני שסומכים עליו
- לפני שמסתמכים על ResponseCode ברמה העליונה, בודקים גם את השכבה הפנימית של פרטי העסקה, כי הן שתי בדיקות נפרדות
- בהרשאות J5, שמקפיאות סכום בלי לגבות אותו, צריך תמיד שלב תפיסה נפרד, אחרת הכסף נשאר מוקפא אצל הלקוח בלי סיבה
תקלות נפוצות
התשלום עבר אבל לא הופקה חשבונית
לא בטוח אם התשלום באמת הצליח
החזר כספי מחזיר שגיאה
לא ברור למה חשבוניות לא מקבלות מספר הקצאה
שאלות ותשובות
Cardcom מחליפה את הצורך ברואה חשבון
אפשר לקבל תשלום בלי להפיק מסמך
יש תמיכה בביט ואפל פיי
צריך תשלום כדי להשתמש בסקיל עצמו
קרדיט ומקור. Cardcom Payment Gateway נכתב על ידי skills-il ונמצא ב-skills-il/tax-and-finance ברישיון MIT. skills-il הוא פרויקט קוד פתוח ישראלי של סקילים ל-AI, ואפשר למצוא את כל הסקילים שלהם גם ב-agentskills.co.il. את העמוד כתב קורן בן עזרא אחרי בדיקה של המאגר ושל פקודות ההתקנה (30.09.2026). מאגרים מתעדכנים, ולכן אם משהו השתנה, המאגר הוא המקור הקובע.