Jump to Content

Bulk Payouts Webhook

This page covers the status webhook fired for Bulk Payouts — corporate-account batch transfers.

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

see Webhooks - Async Updates or Webhook Security

Bulk payment status webhook

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

Updated 7 days ago

Did this page help you?