Bulk Payouts Webhook

For general webhook mechanics (response requirements, security, IP whitelisting, troubleshooting),

see Webhooks - Async Updates or Webhook Security

Bulk payment status webhook

⚠️
The reference material for this webhook documents payload fields and statuses, but doesn't give an explicit event name (unlike PaymentStatusChanged or MandateStatusChanged). Confirm the exact event value with your Feezback integration contact before building a strict parser against it.

Payload fields

Field	Description
`user`	`sub@tpp`
`paymentRequest`	Unique UUID
`aspspCode`	Bank code
`psuId`	Authorized signatory ID
`psuCorporateId`	Corporate ID (ח.פ.)
`debtorName`	Paying organization's name
`bulkIdentifier`	Bulk batch identifier
`bulkDescription`	Description
`bulkExecutionDate`	Execution date
`requestedAmount`	Total amount
`psuMessage`	Reference number (`null` until terminal)
`referenceNumber`	Reference number
`transferType`	`masav` / `fp` / `zahav`
`currentStatus`	See status list below
`previousStatus`	`null` if this is the first update
`tpp`	Your client identifier

⚠️ Do not validate against a strict schema. Additional fields may be present — parse only what you need.

Statuses

Initial: RCVD
Intermediate: PATC (partially approved, needs further approval), PART (some payments received)
Terminal: ACTC (AcceptedTechnicalCorrect ✅), ACWC (AcceptedWithChange ✅), RJCT (Rejected ❌), CANC (Cancelled ❌)

Related error codes (payment creation, not webhook)

Status	Error Code	Meaning
400	`INVALID_PAYMENT_PAYLOAD`	Missing or invalid field
400	`IBAN_IS_NOT_WHITELISTED`	Creditor account not whitelisted
424	`ASPSP_ERROR`	Passed Feezback validation but the bank rejected it — contact Feezback with the `paymentId` and exact time
500	`PAYMENT_REQUEST_FAILED`	Failed to create the payment

Testing (Mock Bank)

Create a bulk payment without debtorAccount in the request.
Choose MockBank on the Feezback screens.
Enter a 5-digit account number: 12345.

Test ID (`psuId`)	Result
`200200202`	acceptedTechnicalValidation ✅
`998814644`	Rejected ❌
`320634389`	Partially Authorized