Financial Events Triggers

What are Financial Events Triggers?

Feezback scans accounts with valid consents monthly to detect the following events:

Event	`event` value	Status
Outstanding balance	`OutstandingBalance`	Live
Salary from a new employer	`NewSalary`	Live
Child birth	`NewChild`	Live
New insurance policy detected	`NewInsurancePolicy`	Live
Car insurance about to expire	`expiringCarInsurance`	Live — NEW
House insurance about to expire	`expiringHouseInsurance`	Live — NEW
Health insurance about to expire	`expiringHealthInsurance`	Live — NEW
Life insurance about to expire	`expiringLifeInsurance`	Live — NEW
Loan payment about to end	`ExpiringLoan`	Coming Soon — not yet live
Deposit about to reach exit point	`depositExitPoint`	Coming Soon — not yet live

Data included

When this feature is enabled, a webhook message is triggered on the 3rd day of each calendar month, covering events detected in the previous full calendar month. It provides transaction and balance details relevant to the detected event.

Envelope fields:

Field	Type	Description
`event_name`	String	The type of event that triggered the webhook
`Data`	Object	The details of the account and transactions that triggered the event
`timestamp`	String	ISO 8601 timestamp of when the event occurred

Data Payloads

Outstanding balance

Event name: OutstandingBalance

{
  "event": "OutstandingBalance",
  "payload": {
    "tpp": "test",
    "user": "123456789@test",
    "psuId": "123456789",
    "totalBalance": [
      { "amount": 16000.0, "currency": "USD" },
      { "amount": 51000.0, "currency": "ILS" }
    ]
  },
  "timestamp": "2025-02-03T09:00:21.986886+00:00"
}

Field	Description	Label
`event_name`	זוהתה יתרה גבוהה	`OutstandingBalance`
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`totalBalance.amount`	סך היתרה שזוהתה כיתרה גבוהה	סך היתרה
`totalBalance.currency`	מטבע היתרה שזוהתה	מטבע היתרה

Note: talk to your Feezback integration contact to configure the high balance amount.

Salary from a new employer

Event name: NewSalary

{
  "payload": {
    "tpp": "test",
    "user": "123456789@test",
    "psuId": "123456789",
    "transaction": {
      "time": "2024-12-13",
      "amount": 3170.0,
      "currency": "ILS",
      "debtorName": "newEmployeeSalary",
      "standardName": "מו משכור בה-י"
    }
  },
  "event": "NewSalary",
  "timestamp": "2025-02-03T09:00:08.015378+00:00"
}

Field	Description	Label
`event_name`	זוהתה תנועה מסוג משכורת ממעסיק חדש	newSalary
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`standardName`	שם התנועה הסטנדרטי של פיזבק	שם התנועה הסטנדרטי של פיזבק
`debtorName`	שם החשבון ממנו התקבלה המשכורת	שם המחויב
`amount`	סכום התנועה	סכום התנועה
`currency`	המטבע בו התבצעה התנועה	מטבע
`time`	התאריך בו התבצעה התנועה	תאריך התנועה

Child birth

Event name: NewChild

{
  "payload": {
    "tpp": "test",
    "user": "123456789@test",
    "psuId": "123456789",
    "transaction": {
      "time": "2024-12-07",
      "amount": 3170.0,
      "currency": "ILS",
      "standardName": "ביטוח לאומי - קצבת ילדים",
      "remittanceInformationUnstructured": "קצבת ילדים"
    }
  },
  "timestamp": "2025-02-03T09:00:10.879686+00:00",
  "event": "NewChild"
}

Field	Description	Label
`event_name`	זוהתה תנועת קצבת ילדים בסכום שלא התקבל בעבר	newChild
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`standardName`	שם התנועה הסטנדרטי של פיזבק	שם התנועה הסטנדרטי של פיזבק
`remittanceInformationUnstructured`	שם התנועה כפי שהתקבל מהבנק	שם התנועה כפי שהתקבל מהבנק
`amount`	סכום התנועה	סכום התנועה
`currency`	המטבע בו התבצעה התנועה	מטבע
`time`	התאריך בו התבצעה התנועה	תאריך התנועה

New insurance policy detected

Event name: NewInsurancePolicy

{
  "payload": {
    "tpp": "test",
    "user": "123456789@sandbox",
    "psuId": "123456789",
    "transaction": {
      "time": "2024-07-16",
      "amount": -500,
      "currency": "ILS",
      "standardName": "מנורה מבטחים",
      "remittanceInformationUnstructured": "מנורה מבטחים פ"
    }
  },
  "event": "NewInsurancePolicy",
  "timestamp": "2025-01-09T15:00:07.636504+00:00"
}

Field	Description	Label
`event_name`	זוהתה תנועת חובה חדשה בקטגוריית ביטוח	newInsurancePolicy
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`standardName`	שם התנועה הסטנדרטי של פיזבק	שם התנועה הסטנדרטי של פיזבק
`remittanceInformationUnstructured`	שם התנועה כפי שהתקבל מהבנק	שם התנועה כפי שהתקבל מהבנק
`amount`	סכום התנועה	סכום התנועה
`currency`	המטבע בו התבצעה התנועה	מטבע
`time`	התאריך בו התבצעה התנועה	תאריך התנועה

Car insurance about to expire

Event name: expiringCarInsurance

{
  "event": "expiringCarInsurance",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "transaction": {
      "cardAcceptorName": "aig רכב חובה",
      "transactionDate": "2024-02-17",
      "transactionAmount": "320.06",
      "transactionCurrency": "ILS",
      "paymentsNumber": 12,
      "paymentNumber": 11
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description	Label
`event_name`	זוהה תשלום אחד לפני אחרון של ביטוח רכב	expiringCarInsurance
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`transaction.cardAcceptorName`	שם בית העסק המקבל את עסקת התשלומים	מקבל התשלום
`transaction.transactionDate`	תאריך התנועה	תאריך התנועה
`transaction.transactionAmount`	סכום התנועה	סכום התנועה
`transaction.transactionCurrency`	המטבע בו התבצעה התנועה	מטבע
`transaction.paymentsNumber`	מספר התשלומים הכולל בעסקה	תשלומים
`transaction.paymentNumber`	מספר התשלום הנוכחי מתוך סך התשלומים	תשלום

House insurance about to expire

Event name: expiringHouseInsurance

{
  "event": "expiringHouseInsurance",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "transaction": {
      "cardAcceptorName": "ישיר ביטוח דירה",
      "transactionDate": "2024-02-17",
      "transactionAmount": "320.06",
      "transactionCurrency": "ILS",
      "paymentsNumber": 12,
      "paymentNumber": 11
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description	Label
`event_name`	זוהה תשלום אחד לפני אחרון של ביטוח דירה	expiringHouseInsurance
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`transaction.cardAcceptorName`	שם בית העסק המקבל את עסקת התשלומים	מקבל התשלום
`transaction.transactionDate`	תאריך התנועה	תאריך התנועה
`transaction.transactionAmount`	סכום התנועה	סכום התנועה
`transaction.transactionCurrency`	המטבע בו התבצעה התנועה	מטבע
`transaction.paymentsNumber`	מספר התשלומים הכולל בעסקה	תשלומים
`transaction.paymentNumber`	מספר התשלום הנוכחי מתוך סך התשלומים	תשלום

Health insurance about to expire

Event name: expiringHealthInsurance

{
  "event": "expiringHealthInsurance",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "transaction": {
      "cardAcceptorName": "מגדל בריאות",
      "transactionDate": "2024-02-17",
      "transactionAmount": "320.06",
      "transactionCurrency": "ILS",
      "paymentsNumber": 12,
      "paymentNumber": 11
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description	Label
`event_name`	זוהה תשלום אחד לפני אחרון של ביטוח בריאות ו/או סיעוד	expiringHealthInsurance
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`transaction.cardAcceptorName`	שם בית העסק המקבל את עסקת התשלומים	מקבל התשלום
`transaction.transactionDate`	תאריך התנועה	תאריך התנועה
`transaction.transactionAmount`	סכום התנועה	סכום התנועה
`transaction.transactionCurrency`	המטבע בו התבצעה התנועה	מטבע
`transaction.paymentsNumber`	מספר התשלומים הכולל בעסקה	תשלומים
`transaction.paymentNumber`	מספר התשלום הנוכחי מתוך סך התשלומים	תשלום

Life insurance about to expire

Event name: expiringLifeInsurance

{
  "event": "expiringLifeInsurance",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "transaction": {
      "cardAcceptorName": "מנורה מבטחים - חיים",
      "transactionDate": "2024-02-17",
      "transactionAmount": "320.06",
      "transactionCurrency": "ILS",
      "paymentsNumber": 12,
      "paymentNumber": 11
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description	Label
`event_name`	זוהה תשלום אחד לפני אחרון של ביטוח חיים	expiringLifeInsurance
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה	מזהה משתמש
`psuId`	תעודת הזהות של בעל ההסכמה	תעודת זהות
`transaction.cardAcceptorName`	שם בית העסק המקבל את עסקת התשלומים	מקבל התשלום
`transaction.transactionDate`	תאריך התנועה	תאריך התנועה
`transaction.transactionAmount`	סכום התנועה	סכום התנועה
`transaction.transactionCurrency`	המטבע בו התבצעה התנועה	מטבע
`transaction.paymentsNumber`	מספר התשלומים הכולל בעסקה	תשלומים
`transaction.paymentNumber`	מספר התשלום הנוכחי מתוך סך התשלומים	תשלום

Loan payment about to end — Coming Soon, not yet live

Event name: ExpiringLoan

{
  "event": "ExpiringLoan",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "loan": {
      "product": "הלוואה לכל מטרה",
      "startingDate": "2021-01-01",
      "endDate": "2022-01-01",
      "balance": "100.0",
      "originalAmount": "200.0",
      "isMortgage": true,
      "details": "{\"linkageType\":\"לא צמוד\"}",
      "collateralsInvolved": "false",
      "interest": [
        {
          "type": "FIXD",
          "rate": [
            { "percentage": "4.5", "fromAmount": null, "toAmount": null }
          ],
          "toDateTime": "2021-01-05T23:59:59",
          "fromDateTime": null,
          "changeMechanism": null,
          "relatedIndices": null
        }
      ]
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description
`event_name`	זוהתה הלוואה שעומדת להסתיים בחודש הקרוב
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה
`psuId`	תעודת הזהות של בעל ההסכמה
`loan.product`	שם מוצר האשראי
`loan.startingDate`	תאריך תחילת ההלוואה
`loan.endDate`	תאריך סיום ההלוואה
`loan.balance`	יתרה להחזר
`loan.originalAmount`	סכום מקורי
`loan.isMortgage`	שדה בוליאני שמציין האם ההלוואה היא מסוג משכנתא
`loan.details`	פרטים נוספים במידה והתקבלו מהבנק
`loan.collateralsInvolved`	שדה בוליאני — `true` אם יש נכסים/חשבונות משועבדים כנגד ההלוואה
`loan.interest.type`	סוג הריבית
`loan.interest.rate.percentage`	סכום הריבית באחוזים
`loan.interest.rate.fromAmount`	הסכום ממנו הריבית תקפה
`loan.interest.rate.toAmount`	הסכום עד אליו הריבית תקפה
`loan.interest.fromDateTime`	תאריך תחילת הריבית
`loan.interest.toDateTime`	תאריך סיום הריבית
`loan.interest.changeMechanism`	מנגנון שינוי בין ריביות
`loan.interest.relatedIndices`	מדדים קשורים לריבית במידה ויש

Deposit about to reach exit point — Coming Soon, not yet live

Event name: depositExitPoint

{
  "event": "depositExitPoint",
  "payload": {
    "user": "Useridentifier@test",
    "psuId": "314690000",
    "deposit": {
      "name": "Yearly deposit",
      "relatedDates": {
        "contractAvailabilityDate": "2024-03-21",
        "contractEndDate": "2025-03-14",
        "contractStartDate": "2024-03-14"
      },
      "balance": { "amount": "1851.54", "currency": "ILS" },
      "interest": [
        {
          "fromDateTime": "2023-01-05",
          "toDateTime": "2023-12-31",
          "type": "FIXD",
          "rate": [
            {
              "fromAmount": { "amount": "12.34", "currency": "ILS" },
              "percentage": "-25",
              "toAmount": { "amount": "12.34", "currency": "ILS" }
            }
          ]
        }
      ]
    }
  },
  "timestamp": "2024-04-08T05:01:12.981118+00:00"
}

Field	Description
`event_name`	זוהה חיסכון או פיקדון שעומד להסתיים בחודש הקרוב
`user`	מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה
`psuId`	תעודת הזהות של בעל ההסכמה
`deposit.name`	שם מוצר החיסכון
`deposit.relatedDates.contractAvailabilityDate`	תאריך תחנת יציאה קרובה
`deposit.relatedDates.contractEndDate`	תאריך סיום הפיקדון
`deposit.relatedDates.contractStartDate`	תאריך תחילת הפיקדון
`deposit.balance.amount`	יתרה נוכחית בפיקדון
`deposit.balance.currency`	מטבע היתרה
`deposit.interest.type`	סוג הריבית
`deposit.interest.fromDateTime`	תאריך תחילת הריבית
`deposit.interest.toDateTime`	תאריך סיום הריבית
`deposit.interest.rate.fromAmount.amount`	הסכום ממנו הריבית תקפה
`deposit.interest.rate.fromAmount.currency`	מטבע הסכום ממנו הריבית תקפה
`deposit.interest.rate.toAmount.amount`	הסכום עד אליו הריבית תקפה
`deposit.interest.rate.toAmount.currency`	מטבע הסכום עד אליו הריבית תקפה

What are Financial Events Triggers?

Data included

Data Payloads

Outstanding balance

Salary from a new employer

Child birth

New insurance policy detected

Car insurance about to expire

House insurance about to expire

Health insurance about to expire

Life insurance about to expire

Loan payment about to end — Coming Soon, not yet live

Deposit about to reach exit point — Coming Soon, not yet live

Field

Description

event_name

זוהה חיסכון או פיקדון שעומד להסתיים בחודש הקרוב

user

מזהה המשתמש שנשלח למערכת בעת בקשת ההסכמה

psuId

תעודת הזהות של בעל ההסכמה

deposit.name

שם מוצר החיסכון

deposit.relatedDates.contractAvailabilityDate

תאריך תחנת יציאה קרובה

deposit.relatedDates.contractEndDate

תאריך סיום הפיקדון

deposit.relatedDates.contractStartDate

תאריך תחילת הפיקדון

deposit.balance.amount

יתרה נוכחית בפיקדון

deposit.balance.currency

מטבע היתרה

deposit.interest.type

סוג הריבית

deposit.interest.fromDateTime

תאריך תחילת הריבית

deposit.interest.toDateTime

תאריך סיום הריבית

deposit.interest.rate.fromAmount.amount

הסכום ממנו הריבית תקפה

deposit.interest.rate.fromAmount.currency

מטבע הסכום ממנו הריבית תקפה

deposit.interest.rate.toAmount.amount

הסכום עד אליו הריבית תקפה

deposit.interest.rate.toAmount.currency

מטבע הסכום עד אליו הריבית תקפה

`event_name`

`user`

`psuId`

`deposit.name`

`deposit.relatedDates.contractAvailabilityDate`

`deposit.relatedDates.contractEndDate`

`deposit.relatedDates.contractStartDate`

`deposit.balance.amount`

`deposit.balance.currency`

`deposit.interest.type`

`deposit.interest.fromDateTime`

`deposit.interest.toDateTime`

`deposit.interest.rate.fromAmount.amount`

`deposit.interest.rate.fromAmount.currency`

`deposit.interest.rate.toAmount.amount`

`deposit.interest.rate.toAmount.currency`