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

תשלום תקופתי (Standing Order) דרך ה-API

איך מייזמים תשלום תקופתי (הוראת קבע) דרך ה-API, כולל מבנה periodicPaymentInformation וכל השדות.

נכתב על ידי Eliron Giny

תשלום תקופתי (Standing Order / הוראת קבע) מבצע העברה חוזרת בתדירות קבועה. הוא נוצר באותן שתי שיטות כמו תשלום רגיל (ראה סקירה ושתי השיטות), אבל עם אובייקט periodicPaymentInformation במקום paymentInformation.

דוגמה

POST /v2/pay/open-banking-init

{
  "providerId": "hapoalim",
  "psuId": "123456789",
  "redirectUrl": "https://your-app.com/return",
  "periodicPaymentInformation": {
    "amount": 500,
    "currency": "ILS",
    "description": "מנוי חודשי",
    "creditorAccountType": "iban",
    "creditorAccountNumber": "IL...",
    "creditorName": "שם הנמען",
    "debtorAccountNumber": "IL...",
    "debtorAccountType": "iban",
    "startDate": "2026-07-01",
    "endDate": "2026-12-01",
    "frequency": "Monthly",
    "dayOfExecution": "1",
    "executionRule": "following"
  }
}

השדות

חובה:

  • amount, currency, description

  • startDate – תאריך ISO שבו מתחילים.

  • frequency – תדירות. ערכים אפשריים: Daily, Weekly, EveryTwoWeeks, Monthly, EveryTwoMonths, Quarterly, SemiAnnual, Annual, MonthlyVariable.

  • debtorAccountNumber + debtorAccountType (iban/bban) – חשבון המקור. בהפניה ישירה לבנק שדות אלה נדרשים.

אופציונלי / מותנה:

  • endDate – מתי מסתיים (ISO). בהפניה ישירה לבנק בדרך כלל נדרש.

  • dayOfExecution – יום בחודש לביצוע ("1" עד "31").

  • executionRule – טיפול ביום שאינו עסקים: following (היום הבא) או preceding (היום הקודם).

  • monthsOfExecution – מערך חודשים, רק עבור frequency: MonthlyVariable.

תיעוד מלא

docs.open-finance.ai – periodic payments.

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