ארנק דיגיטלי

ארנק דיגיטלי - הסבר

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

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

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

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

הערך המרכזי:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שלב 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

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

פרטי התחברות

"Certification": "YOUR_CERTIFICATION_KEY"
"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 ייחודיים לכל העברה לצורך מעקב ובקרה.