קורן בן עזרא
מה Claude יכול לעשות עם Cardcom (קארדקום)
לקארדקום אין מחבר רשמי ל-Claude ואין שרת MCP רשמי. יש API רשמי ומלא (גרסה 11), ועליו Claude Code יכול לעבוד בשבילכם: לשלוף רשימת עסקאות לתקופה, להכין דף תשלום, להפיק מסמך ולבדוק תוצאה של עסקה. הסקיל של קהילת skills-il מלמד את Claude את הכללים של קארדקום ושל מסמכי מס בישראל, כדי שלא יטעה בשדות.
- רשימת עסקאות לפי טווח תאריכים
- תוצאה של דף תשלום ושל עסקה בודדת
- מסמכים שהופקו דרך קארדקום, לפי מה שהמפתח מורשה לראות
- יצירת דף תשלום חדש ללקוח, רק אחרי אישור שלכם
- הפקת מסמך במודול המסמכים, רק אחרי אישור שלכם
- החזר כספי או חיוב בטוקן אפשריים ב-API, ולכן במדריך הזה Claude מתבקש לא לבצע אותם בכלל
מה צריך לפני שמתחילים
- מסוף פעיל בקארדקום עם גישת API. אם אתם לא בטוחים, בודקים מול קארדקום
- הרשאה בממשק לנהל מפתחות API, או מישהו בעסק שיש לו אותה
- אפליקציית Claude למחשב, Mac או Windows, עם לשונית Code. היא כלולה בתוכניות Pro, Max, Team ו-Enterprise
- ב-Windows מומלץ להתקין Git for Windows מ-git-scm.com/downloads/win, כדי ש-Claude Code יעבוד עם Bash
- כ-20 דקות, פעם אחת בלבד
איך מחברים את Cardcom (קארדקום) ל-Claude.
אין לקארדקום מחבר רשמי ל-Claude ואין שרת MCP רשמי, ולכן הדרך הכי חזקה והרשמית היא ה-API של קארדקום (גרסה 11) דרך Claude Code. יוצרים מפתח API בממשק, ואת החלק הטכני Claude Code עושה מארבעה פרומפטים שמדביקים, בערך 20 דקות. מתחילים בקריאה בלבד, ורק אחר כך מוסיפים פעולות, תמיד עם אישור שלכם.
- 1
בודקים שיש לכם גישת API בקארדקום
גישת API היא חלק מהמסוף שלכם בקארדקום. לפני הכל בודקים שהיא פתוחה אצלכם. אם אתם לא בטוחים, שואלים את התמיכה של קארדקום, שיש לה גם קו תמיכה ייעודי למפתחים.
- נכנסים לממשק הניהול של קארדקום עם המשתמש הרגיל שלכם
- פותחים את התפריט הגדרות ובודקים שיש בו את האזור ניהול מפתחות API לממשקים
- אם האזור לא מופיע, פונים לקארדקום ומבקשים לפתוח גישת API למסוף
איפה:https://www.cardcom.solutions/developersקארדקום היא חברת סליקה, ולכן כל שינוי במסוף, כמו פתיחת מודול מסמכים או אמצעי תשלום, נעשה מולה ולא מול Claude.
- 2
יוצרים מפתח API נפרד ל-Claude
מפתח API בקארדקום מורכב משני חלקים: שם API (ApiName) וסיסמת API (ApiPassword). המערכת יוצרת את שניהם לבד. יוצרים מפתח חדש רק בשביל Claude, כדי שאפשר יהיה לבטל אותו בלי לפגוע בחיבורים אחרים, כמו האתר.
- נכנסים להגדרות, ואז הגדרות חברה ומשתמשים, ואז ניהול מפתחות API לממשקים
- יוצרים מפתח חדש ונותנים לו שם ברור, למשל claude-reports
- מעתיקים את שם ה-API ואת סיסמת ה-API לפנקס זמני, עד הצעד הבא
- רושמים בצד גם את מספר המסוף (Terminal) שלכם
איפה:הגדרות > הגדרות חברה ומשתמשים > ניהול מפתחות API לממשקים, בממשק של קארדקוםהשם המדויק של התפריט יכול להשתנות קצת בין גרסאות של הממשק. אם לא מוצאים אותו, התמיכה של קארדקום מכוונת אליו. המפתח הזה נותן גישה לחשבון הסליקה, ולכן לא שולחים אותו לאף אחד ולא מדביקים אותו בצ'אט.
- 3
Claude Code שומר את המפתח בקובץ מוגן
מכאן Claude Code עושה את החלק הטכני. פותחים את אפליקציית Claude במחשב, עוברים ללשונית Code, בוחרים Local ואז Select folder, ויוצרים או בוחרים תיקייה בשם cardcom בתוך תיקיית הבית. אם אתם על Windows, מחליפים בפרומפט את Mac ב-Windows. לפני כל פעולה Claude Code מבקש אישור: מאשרים אחת אחת, בלי לסמן אישור קבוע.
מדביקים ב-Claude Codeאני רוצה לחבר את Claude Code ל-API הרשמי של קארדקום, גרסה 11 (התיעוד: https://secure.cardcom.solutions/Api/v11/Docs). המחשב שלי הוא Mac. 1. תיצור בתיקייה הזאת קובץ בשם .env עם שלוש שורות: CARDCOM_TERMINAL=, CARDCOM_API_NAME= ו-CARDCOM_API_PASSWORD=, ותגביל אותו כך שרק המשתמש שלי יכול לקרוא אותו (ב-Mac עם chmod 600). 2. תפתח לי את הקובץ בעורך טקסט ותחכה. אני אדביק את הערכים ואשמור. אל תבקש ממני להדביק אותם בצ'אט. 3. תריץ קריאה אחת לקריאה בלבד: POST https://secure.cardcom.solutions/api/v11/Transactions/ListTransactions עם ApiName ו-ApiPassword מהקובץ, FromDate ו-ToDate של 7 הימים האחרונים בפורמט DDMMYYYY, Page 1 ו-Page_size 10. אל תשלח TerminalNumber בקריאה הזאת, כי היא לא מקבלת אותו. 4. תגיד לי כמה עסקאות חזרו ומה ה-ResponseCode, בלי להציג את המפתח. אל תיצור דף תשלום, אל תחייב, אל תבצע החזר ואל תפיק מסמך. לפני כל פקודה תסביר מה היא עושה ותחכה לאישור שלי.
הקובץ .env הוא סוד. לא שולחים אותו, לא מעלים אותו לשום מקום, ולא שומרים את התיקייה בתיקייה שמסונכרנת ל-iCloud, ל-OneDrive או ל-Dropbox.
- 4
מתקינים את הסקיל שמכיר את קארדקום
הסקיל cardcom-payment-gateway של skills-il הוא קוד פתוח, לא של קארדקום ולא של Anthropic. הוא מלמד את Claude את השדות של גרסה 11, את סוגי המסמכים ואת הטעויות הנפוצות, למשל שבחלק מהקריאות אסור לשלוח מספר מסוף. מדביקים את הפרומפט באותה שיחה.
מדביקים ב-Claude Codeתתקין לי את הסקיל cardcom-payment-gateway מהמאגר github.com/skills-il/tax-and-finance לתיקיית הסקילים של Claude Code, עם הפקודה הזאת: 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" אם אני על Windows, תתאים את הפקודה. אחר כך תקרא את ~/.claude/skills/cardcom-payment-gateway/SKILL.md ותסכם לי בשלוש שורות מה הוא מוסיף, בלי לגעת בחשבון בקארדקום.
- 5
קובעים כללים לפעולות שמזיזות כסף
מגדירים פעם אחת את הכללים, כדי ש-Claude לא יעשה שום דבר שמזיז כסף בלי אישור. הקובץ CLAUDE.md נטען אוטומטית בכל שיחה בתיקייה הזאת.
מדביקים ב-Claude Codeתיצור בתיקייה הזאת קובץ CLAUDE.md עם הכללים האלה, ותראה לי אותו לפני שמירה: 1. בחיבור לקארדקום מותר להריץ קריאות קריאה בלבד בלי לשאול, כמו רשימת עסקאות ותוצאת עסקה. 2. לפני יצירת דף תשלום או הפקת מסמך, תציג את כל הפרטים ותחכה לאישור מפורש שלי. 3. אסור לבצע חיוב בטוקן, החזר כספי או ביטול עסקה. אם אני מבקש, תסביר איך עושים את זה בממשק של קארדקום. 4. לעולם אל תציג את תוכן קובץ .env.
- 6
בודקים שהחיבור עובד
פותחים שיחה חדשה בלשונית Code באותה תיקייה, ומדביקים את פרומפט הבדיקה שמופיע מיד כאן למטה. אם חוזר סיכום עם מספרים שנראים נכון, הכל מחובר.
מדביקים ב-Claude. אם מתקבלת תשובה עם נתונים אמיתיים מהחשבון, הכל מחובר.
תשתמש בקובץ .env שבתיקייה הזאת ובסקיל cardcom-payment-gateway. תשלוף מקארדקום את העסקאות של 3 הימים האחרונים ותסכם כמה עסקאות היו ומה הסכום הכולל. קריאה בלבד: אל תיצור, אל תחייב ואל תציג את המפתח.פרומפטים מוכנים לעבודה
סיכום עסקאות שבועי
תשלוף מקארדקום את כל העסקאות מהשבוע האחרון ותסכם לפי ימיםדף תשלום ללקוח
תכין דף תשלום על 350 שקל ללקוח דנה לוי, עד 3 תשלומים, ותראה לי את הפרטים לפני שליחהבדיקת עסקה
תבדוק מה הסטטוס של העסקה האחרונה של הלקוח הזה, והאם הופק לה מסמךדוח לרואה החשבון
תכין קובץ CSV עם כל העסקאות של החודש הקודם, עם תאריך, סכום ומספר תשלומיםהשוואה חודשית
תשווה את סך העסקאות של החודש הזה לחודש הקודם, ותגיד לי באחוזים מה השתנהעסקאות בתשלומים
תראה לי אילו עסקאות מהחודש היו בתשלומים, וכמה תשלומים בכל אחתעסקאות בלי מסמך
תבדוק אם יש עסקאות מהשבוע האחרון שלא הופק להן מסמך, ותראה לי רשימההסבר שגיאה
קיבלתי מקארדקום את השגיאה הזאת בקריאה ל-API. תקרא את ה-Description ותסביר לי בעברית פשוטה מה לתקןדרכים נוספות להתחבר (למתקדמים)
ה-API הרשמי של קארדקום דרך Claude Code
בעלי עסקים ומפתחים שרוצים דוחות, בדיקת עסקאות ודפי תשלום משיחה, עם אישור על כל פעולה
- יוצרים מפתח API בממשק של קארדקום, תחת הגדרות, הגדרות חברה ומשתמשים, ניהול מפתחות API לממשקים
- שומרים את שם ה-API, את סיסמת ה-API ואת מספר המסוף בקובץ .env מוגן, ולא בצ'אט
- כל הקריאות נשלחות ב-POST לכתובת הבסיס https://secure.cardcom.solutions/api/v11, עם ApiName ולפי הצורך ApiPassword בגוף הבקשה
- בודקים כל תשובה לפי ResponseCode, כש-0 פירושו הצלחה, וקוראים את Description כשיש שגיאה
curl -X POST https://secure.cardcom.solutions/api/v11/Transactions/ListTransactions \
-H "Content-Type: application/json" \
-d '{"ApiName":"YOUR_API_NAME","ApiPassword":"YOUR_API_PASSWORD","FromDate":"01102026","ToDate":"07102026","Page":1,"Page_size":10}'https://secure.cardcom.solutions/Api/v11/Docs https://secure.cardcom.solutions/swagger/v11/swagger.json
בגרסה 11 חלק מהקריאות דורשות ApiPassword וחלק לא, וקריאות הדוחות לא מקבלות TerminalNumber בכלל. לכן כדאי לתת ל-Claude לקרוא את קובץ ה-Swagger או את הסקיל לפני שהוא בונה קריאה חדשה.
סקיל cardcom-payment-gateway של skills-il
מי שכבר עובד ב-Claude Code ורוצה ש-Claude יכיר את הכללים של קארדקום ושל מסמכי מס בישראל
- מתקינים את הסקיל בפקודה אחת, או ב-CLI של skills-il
- מפעילים מחדש את Claude Code כדי שהסקיל ייטען
- הסקיל עובד מעל אותו מפתח API, ולא נותן גישה לחשבון בלעדיו
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"
npx skills-il add skills-il/tax-and-finance@v2.4.0-cardcom-payment-gateway --skill cardcom-payment-gateway -a claude-code
זה סקיל, כלומר קובץ הנחיות, ולא שרת MCP. יש ברשת גם שרת MCP קהילתי לקארדקום, אבל הוא לא של קארדקום, ולכן הוא לא מומלץ כאן לחיבור שנוגע בכסף.
איך מחברים בלי לסכן את החשבון
- יוצרים מפתח API נפרד רק ל-Claude, כדי שאפשר יהיה למחוק אותו בלי לשבור את החיבור של האתר
- שומרים את המפתח בקובץ .env מוגן, לא מדביקים אותו בצ'אט ולא שומרים אותו בתיקייה מסונכרנת
- Claude לא מבצע חיובים בטוקן, החזרים או ביטולים. את אלה עושים בממשק של קארדקום, בעצמכם
- כל דף תשלום או מסמך מס עוברים דרככם לאישור לפני שליחה, כי הם נרשמים בהנהלת החשבונות
- אם עובד עזב או שמפתח דלף, מוחקים אותו בניהול מפתחות API לממשקים ויוצרים חדש
כמה זה עולה
החיבור עצמו והסקיל לא עולים כסף. העמלות והמנוי של קארדקום נקבעים בהסכם שלכם איתה ולא מתפרסמים במחירון אחיד, ולכן בודקים מולה אם גישת API או מודול המסמכים כרוכים בתוספת. צריך גם תוכנית בתשלום של Claude שכוללת את Claude Code.
תקלות נפוצות
ה-ResponseCode שונה מ-0
רשימת העסקאות נכשלת למרות שהמפתח נכון
עסקה מופיעה כמוצלחת אבל לא הופק לה מסמך
לא מוצאים בממשק את ניהול מפתחות API
שאלות ותשובות
יש לקארדקום מחבר רשמי ל-Claude?
Claude יכול לחייב לקוח בעצמו?
אפשר לבדוק בלי לגעת בכסף אמיתי?
זה מחליף את רואה החשבון?
מקורות. את העמוד כתב קורן בן עזרא לפי התיעוד הרשמי של Cardcom (קארדקום) ושל Anthropic, נכון ל-08.10.2026. ממשקים משתנים מהר, ולכן אם משהו נראה אחרת, התיעוד הרשמי הוא הקובע. המקורות: 1 · 2 · 3 · 4 · 5 · 6
