בנק דיגיטלי

🧾 מה הפיצ'ר עושה – בנק דיגיטלי

הבנק הדיגיטלי מאפשר לבית העסק לנהל את כספי הסליקה שלו בתוך המערכת, מבלי להעביר אותם לחשבון הבנק החיצוני.

במקום תהליך רגיל שבו כספים נסלקים -> מועברים לבנק -> משולמים לספקים,
המערכת יוצרת יתרה זמינה בתוך "בנק דיגיטלי" שממנה ניתן לבצע פעולות ישירות.

יכולות מרכזיות:

• צבירת כספים מסליקות ליתרה פנימית
• ניהול יתרה בזמן אמת
• תשלומים לספקים / קבלני משנה מתוך הבנק הדיגיטלי
• חיסכון בזמן ובהעברות בנקאיות
• שליטה ובקרה מלאה על תזרים הכסף

הערך המרכזי:

הכסף “נשאר במערכת” וממשיך לעבוד – במקום לצאת לבנק ואז לחזור.

🎯 למי זה מתאים?

הפתרון מתאים במיוחד לעסקים שמנהלים תשלומים שוטפים לגורמים נוספים:

🏪 עסקים עם ספקי משנה

• מרקטפלייסים
• פלטפורמות שירותים (שליחים, נותני שירות, פרילנסרים)
• חברות שמנהלות רשת של ספקים

🧑‍💼 עסקים עם תזרים מורכב

• עסקים עם הרבה כניסות ויציאות כספיות
• כאלו שרוצים לצמצם תלות בבנק ובהעברות חיצוניות

🚚 חברות לוגיסטיקה / משלוחים

• תשלום לשליחים מתוך הכנסות שנכנסו באותו יום

🧾 סוכנויות / מתווכים

• גביית כסף מלקוחות והעברתו לספקים/שותפים

💡 סטארטאפים ופלטפורמות פיננסיות

• שרוצים לבנות חוויית “בנק בתוך המוצר”

שלבים להקמת בנק דיגיטלי:

שלב 1: פתיחת בנק דיגיטלי עבור ספק קיים

לצורך פתיחת בנק דיגיטלי יש לבצע קריאה ל־Endpoint הבא:

POST /api/v11/CompanyOperations/OpenDigitalBankToAnExistingSapak

פרמטרים נדרשים

Certification

תעודת הממשקים של בית העסק.

ניתן ליצור את התעודה מתוך אתר CardCom:

הגדרות → הגדרות חברה ומשתמשים → תעודה לממשקים

לאחר לחיצה על "צור תעודה", יורד למחשב קובץ מסוג PFX. יש להמיר את הקובץ למחרוזת Base64 ולהזין את הערך המתקבל בפרמטר Certification.

מדריך להמרת קובץ PFX ל־Base64:
https://www.techfabric.com/blog/convert-pfx-certificate-to-base64-string

מומלץ לשמור את המחרוזת במקום מאובטח.

פרטי התחברות

"UserName": "your_username",
"UserPassword": "your_password"

פרטי הספק

"SapakNumberId": 12345,
"IsModifyExistingSapak": true

SapakNumberId – מספר הספק של בית העסק שברצונכם לחבר לבנק הדיגיטלי.

IsModifyExistingSapak – ערך בוליאני שיש להעביר כ־true לצורך קישור הספק לבנק הדיגיטלי.

פרטי הבנק הדיגיטלי

"DigitalBankInfo": {
    "SubSupplierAdditionalFeePerTransactionPercentage": 0.5,
    "SubSupplierAdditionalFeePerTransactionFixed": 0.10,
    "MaxAmount": 50000.00,
    "MaxMonthlyAmount": 200000,
    "MaxTransactionsDaily": 10,
    "Document": "BASE64_ENCODED_DOCUMENT_HERE"
}

הסבר הפרמטרים:

דוגמא לפניה:

// פתיחת בנק דיגיטלי עבור ספק קיים

var openDigitalBankRequest = new OpenDigitalBankToAnExistingSapakRequest
{
    Certification = "YOUR_CERT",
    UserName = "user@example.com",
    UserPassword = "password123",
    SapakNumberId = 12345,

    // יש להעביר true כדי לקשר את הספק לבנק הדיגיטלי
    IsModifyExistingSapak = true,

    DigitalBankInfo = new DigitalBankInfo
    {
        // עמלת העברה באחוזים
        SubSupplierAdditionalFeePerTransactionPercentage = 0.5m,

        // עמלת העברה קבועה בש"ח
        SubSupplierAdditionalFeePerTransactionFixed = 0.10m,

        // סכום מקסימלי להעברה בודדת
        MaxAmount = 50000m,

        // סכום העברות חודשי מקסימלי
        MaxMonthlyAmount = 200000,

        // מספר העברות מקסימלי ביום
        MaxTransactionsDaily = 10,

        // אישור ניהול חשבון בפורמט Base64
        Document = documentBytes
    }
};

// POST /api/v11/CompanyOperations/OpenDigitalBankToAnExistingSapak

הערה: הפרמטר Document צריך להכיל את אישור ניהול החשבון כשהוא מקודד בפורמט Base64. בנוסף, לצורך קישור ספק קיים לבנק הדיגיטלי יש להעביר IsModifyExistingSapak = true.

שלב 2: ביצוע העברה מהבנק הדיגיטלי

לאחר הקמת הבנק הדיגיטלי ניתן לבצע העברות כספים באמצעות הקריאה:

POST /api/v11/Financial/TransferFromDigitalBank

פרמטרים נדרשים

"Certification": "YOUR_CERTIFICATION_KEY",
"UserName": "your_username",
"UserPassword": "your_password",
"WithdrawSapak": 12345,
"BankNumber": 10,
"BankBranch": 123,
"BankAccount": "123456789",
"BankHolderName": "John Doe",
"Amount": 1000.50,
"Description": "Monthly withdrawal",
"ExternalAsmachta": "UNIQUE-REF-2024-001"

הסבר הפרמטרים

דוגמה לפניה:

// ביצוע העברה מהבנק הדיגיטלי

var transferRequest = new MoneyTransferRequest
{
    Certification = "YOUR_CERT",
    UserName = "user@example.com",
    UserPassword = "password123",

    // מספר הספק של הבנק הדיגיטלי ממנו תתבצע ההעברה
    WithdrawSapak = 12345,

    // פרטי חשבון היעד
    BankNumber = 10,
    BankBranch = 123,
    BankAccount = "123456789",
    BankHolderName = "John Doe",

    // סכום ההעברה
    Amount = 1000.50m,

    // תיאור ההעברה (אופציונלי)
    Description = "Monthly withdrawal",

    // מזהה ייחודי שהוגדר במערכת בית העסק
    ExternalAsmachta = "UNIQUE-REF-2024-001"
};

// POST /api/v11/Financial/TransferFromDigitalBank

// Response:
// {
//     "response": true
// }

הערה: מומלץ להעביר ערך ייחודי בפרמטר ExternalAsmachta עבור כל העברה. מזהה זה מאפשר מעקב, התאמות וביטול העברות במידת הצורך.

שלב 3: ביטול העברה מבנק דיגיטלי

ניתן לבטל העברה כל עוד היא טרם עובדה במערכת. ברוב המקרים חלון הביטול עומד על כ־24 שעות (עשוי להשתנות בהתאם לסטטוס ההעברה).

לצורך ביטול יש לבצע קריאה ל־Endpoint:

POST /api/v11/Financial/CancelDigitalBankTransfer

פרמטרים נדרשים

"Certification": "YOUR_CERTIFICATION_KEY",
"UserName": "your_username",
"UserPassword": "your_password",
"WithdrawSapak": 12345,
"ExternalAsmachta": "UNIQUE-REF-2024-001"

דוגמה לפניה:

// ביטול העברה מהבנק הדיגיטלי

var cancelRequest = new MoneyTransferCancelRequest
{
    Certification = "YOUR_CERT",
    UserName = "user@example.com",
    UserPassword = "password123",

    // מספר הספק של הבנק הדיגיטלי ממנו בוצעה ההעברה
    WithdrawSapak = 12345,

    // מזהה ההעברה המקורי כפי שנשלח בעת ביצוע ההעברה
    ExternalAsmachta = "UNIQUE-REF-2024-001"
};

// POST /api/v11/Financial/CancelDigitalBankTransfer

// Response:
// {
//     "response": true
// }

שלב 4: משיכת מידע על העברות שבוצעו בבנק הדיגיטלי

ניתן לשלוף מידע על העברות שבוצעו בבנק הדיגיטלי לפי טווח תאריכים.

לצורך כך יש לבצע קריאה ל־Endpoint:

POST /api/v11/Financial/GetMoneyTransfers

פרמטרים נדרשים

"Certification": "YOUR_CERTIFICATION_KEY",
"UserName": "your_username",
"UserPassword": "your_password",
"WithdrawsSapakId": 12345,
"ExternalAsmachta": "UNIQUE-REF-2024-001",
"FromDate": "2024-01-01T00:00:00",
"ToDate": "2024-12-31T23:59:59",
"IsValid": true

הסבר הפרמטרים

דוגמה לפניה:

// שליפת העברות מהבנק הדיגיטלי לפי טווח תאריכים

var getTransfersRequest = new GetMoneyTransfersRequest
{
    Certification = "YOUR_CERT",
    UserName = "user@example.com",
    UserPassword = "password123",

    // מספר הספק של הבנק הדיגיטלי
    WithdrawsSapakId = 12345,

    // טווח תאריכים לחיפוש
    FromDate = new DateTime(2024, 1, 1),
    ToDate = new DateTime(2024, 12, 31),

    // null = החזרת כל ההעברות (תקינות ולא תקינות)
    IsValid = null
};

// POST /api/v11/Financial/GetMoneyTransfers

הערה: ניתן להשתמש בפרמטר IsValid לצורך סינון התוצאות:

• true – החזרת העברות תקינות בלבד.
• false – החזרת העברות שנכשלו או בוטלו בלבד.
• null – החזרת כל ההעברות ללא סינון.

סיכום

העבודה מול בנק דיגיטלי באמצעות ה־API כוללת ארבע פעולות עיקריות:

1. פתיחת בנק דיגיטלי עבור ספק קיים.
2. ביצוע העברות כספים מהבנק הדיגיטלי.
3. ביטול העברות שטרם עובדו.
4. שליפת מידע ודוחות על העברות שבוצעו.

מומלץ לשמור את תעודת הממשקים ואת פרטי ההתחברות בצורה מאובטחת ולהשתמש במזהי ExternalAsmachta ייחודיים לכל העברה לצורך מעקב ובקרה.