Guides
  1. Payment Links
  2. Bulk Payouts (BETA)

Status updates

Monitor Bulk-Payout link statuses with webhook updates

A webhook is an automated API call from feezback to an endpoint API on your side.

With every status change of your payment link, you will get a webhook event:PaymentStatusChanged

🔃

Match the webhook to your transfer or customer

Use payload.context to correlate the webhook notification with a specific transaction. Use payload.user to match to your unique user identifier.


Webhook Event Details

  • Event Type: PaymentStatusChanged
  • Content Type: application/json

Payload Structure

Top-Level Fields

FieldTypeDescription
payloadObjectContains the main payment transaction details
eventStringThe type of event that triggered the webhook
timestampStringISO 8601 timestamp of when the event occurred

Payload Fields

Note: Do not limit payload fields, as additional fields may be passed by the bank in some scenarios.

Field
Type
Description
Example
user
String
User identifier - sub
"123456782@tppName"
paymentRequest
String, up to 50 digits
Unique UUID for the payment request
"9739700b-bfe9-4754-b31b-c55da09577ec"
aspspCode
String, up to 6 digits
Bank identifier code
"20"
psuId
String, up to 10 digits
Payment Service User ID
"123456782"
psuCorporateId
String, up to 10 digits
psu_corporate_id
“512222222”
debtorName
String, up to 25 digits
debtor name
חברה בע״מ
bulkIdentifier
String, up to 25 digits
bulk identifier
"123456782"
bulkDescription
String, up to 25 digits
bulk description
״תשלומי ספקים״
bulkExecutionDate
ISO date
execution date, if available
2025-12-25
requestedAmount
String, up to 7 digits
The total amount requested for payment
"100,000.00"
psuMessage
String, up to 21 digits
Message reference number (אסמכתא)
( Can be null if the bank did not send any or not final status )
"002115"
referenceNumber
String, up to 21 digits
Transaction reference number
( Can be null if the bank did not send any or not final status )
"002115"
transferType
String,
"masav" / “fp“ /“zahav“
Type of transfer
"masav"
paymentCount
currentStatus
String, see payment status table below
Current status of the payment
"acceptedTechnicalValidation"
previousStatus
String, see payment status table below
Previous status of the payment
(can be null if 1st status indication)
"received"
tpp
String, up to 10 digits
Customer identifier
"tppID"

Status Transitions

The webhook tracks status changes through:

  • previousStatus: The status before the change
  • currentStatus: The new status after the change

Example transition: received → acceptedTechnicalValidation


Sample Webhook Payload

Single payment – payment approved


{
  "event": "PaymentStatusChanged",
  "timestamp": "2026-07-23T06:47:23.244806+00:00",
  "payload": {
    "user": "51121212128@{tpp}",
    "bulkPaymentRequest": "2d32a587-9686-43a9-9b20-6f0282041b1a",
    "resourceId": "c5d7293c-733d-4e94-9a0b-b37673234bec",
    "psuId": "3030303030",
    "aspspCode": "10",
    "accountNumber": "10-123-123456",
    "accountType": "corporate",
    "psuMessage": "30193",
    "context": "ec42abe9-cb85-f111-ab0e-000d3aaa7adb",
    "transferType": "masav",
    "corporateId": "511234567",
    "executionDate": "2026-07-23",
    "purposeCode": null,
    "payments": [
      {
        "amount": "6281.00",
        "currency": "ILS",
        "creditorAccount": "IL15012600000000012345",
        "creditorAccountType": "iban",
        "description": "פנסיה משלימה"
      },
      {
        "amount": "6022.00",
        "currency": "ILS",
        "creditorAccount": "IL5901080000000299123457",
        "creditorAccountType": "iban",
        "description": "קרן השתלמות"
      },
      {
        "amount": "8365.00",
        "currency": "ILS",
        "creditorAccount": "IL80010800000002123456",
        "creditorAccountType": "iban",
        "description": "ביטוח מנהלים"
      }
    ],
    "paymentsCount": 3,
    "currentStatus": "acceptedTechnicalValidation",
    "previousStatus": "received",
    "tpp": "{tpp}"
  }
}

Status mapping

Feezback keeps sampling the payment status and saves the details in its database. A PaymentStatusChangedevent is sent to you with every status change.

StatusDefinitionMasavComment
receivedPayment initiation request is received by the bank.FirstTriggers when the user is redirected to the bank.
rejectedPayment initiation has been rejected.IntermediateWhen we get this status, the user is redirected to Feezback/Your rejection url.
expiredThe timeout for the RCVD payment has expired.IntermediateWhen we get this status, the user is redirected to Feezback/Your expiration url.
partially
Accepted
Technical
Correct		The transaction requires multiple authentications, where some but not yet all have been performed.IntermediateMostly relevant for corporate accounts where approval process required. This status means the transaction awaits further approval by other account assignees. After the transaction is approved by the rest of the assignees, the status will change to acceptedTechnicalValidation.
accepted
Technical
Validation		Transaction approved by the debtor bank and will be executed by the end of the current business day.Last statusThe debtor has the option to cancel the transfer on the bank channels until the transfer is executed. If approved after hours, it will be assigned to the next business day.
accepted
With
Change		Transaction approved by the debtor bank and will be executed by the end of the current business day, with minor changes like shortening the description of the transfer.Last statusThe debtor has the option to cancel the transfer on the bank channels until the transfer is executed. If approved after hours, it will be assigned to the next business day.


Updated 29 days ago

Did this page help you?