לדלג לתוכן הראשי

תשלום מרובה (Bulk Payment) דרך ה-API

איך מייזמים תשלום מרובה לכמה נמענים בבקשה אחת, כולל מבנה bulkPaymentInformation והמגבלות.

נכתב על ידי Eliron Giny

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

דוגמה

POST /v2/pay/open-banking-init

{
  "providerId": "leumi",
  "psuId": "123456789",
  "bulkPaymentInformation": {
    "debtorAccountNumber": "IL...",
    "debtorAccountType": "iban",
    "batchBookingPreferred": true,
    "payments": [
      { "amount": 100, "currency": "ILS", "description": "...", "creditorAccountType": "iban", "creditorAccountNumber": "IL...", "creditorName": "נמען א" },
      { "amount": 250, "currency": "ILS", "description": "...", "merchantId": "..." }
    ]
  }
}

השדות

ב-bulkPaymentInformation (חובה):

  • debtorAccountNumber + debtorAccountType (iban/bban) – חשבון המקור.

  • payments – מערך התשלומים. כל פריט: amount (גדול מ-0), currency, description (חובה) + פרטי נמען (creditorAccountType/creditorAccountNumber/creditorName) או merchantId.

אופציונלי:

  • batchBookingPreferred – בקשה לעיבוד כאצווה.

  • paymentInformationId – מזהה לקוח חופשי (עד 35 תווים).

  • requestedExecutionDate או requestedExecutionTime – תזמון עתידי (מוציאים זה את זה).

מגבלות

  • מספר תשלומים מינימלי: דרך הפניה ישירה לבנק (/pay/open-banking-init) – מינימום 1. דרך ה-UI של Open Finance (/v2/payments) – מינימום 2.

  • מטבע: ILS.

  • חשבון נמען וחשבון מקור לא יכולים להיות זהים.

  • providerId נדרש (בהפניה ישירה לבנק).

תיעוד מלא

docs.open-finance.ai – bulk payments.

האם קיבלת תשובה לשאלתך?