Bulk Payouts (BETA)

Bulk Payouts lets a businesses submit multiple outbound bank transfer requests using a smart link . Use it for supplier payments, payroll, pension or provident-fund payments, and refunds.

What you need to know before you start

• Bulk payouts uses each bank's Bulk service for processing multiple business payouts approval and execution flows.

  Different approval and execution rules may apply according to the bank account authorizations requirements.

• Bulk payouts initiates the approval process from a specific authorizer identified with personal ID (ת.ז.) and corportate ID (ח.פ.).

• Authorized bank signatories need to approve the batch on their bank app/website to complete the execution approval process.

• Feezback monitors the execution approval process and sends webhook updates when the first and last assignees complete approval.

How the Bulk Payment flow works

1. Build a JWT with srv: "seamless/tpp".
2. Sign the JWT with your private key using RS512.
3. Send the signed JWT to Feezback’s /token endpoint.
4. Receive a bearer token that is valid for 600 seconds.
5. Call the TPP bulk payments API with the bearer token.
6. Receive a redirect URI for authorized-signatory approval.
7. Redirect the authorized signatory to approve the batch.
8. Receive status updates as the bank processes the request.

1. Request a bearer token

Create a JWT for the Seamless token flow.

{
  "sub": "sub",
  "iss": "tpp/{TPP_ID}",
  "srv": "seamless/tpp",
  "iat": 1728986260,
  "exp": 1728986860,
  "ttl": 600
}

Send the signed JWT to the /token endpoint.

curl --location --request POST 'https://{ENVIRONMENT}.feezback.cloud/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "token": "{GENERATED_JWT_TOKEN}"
  }'

2. Create the bulk payment

Call the TPP bulk payments API with the bearer token.

POST https://{TPP_ENVIRONMENT}-tpp.feezback.cloud/tpp/v1/users/{sub}@{tpp_id}/bulk-payments

Use the correct TPP API host:

Example request body:

{
  "idValue": "200200202",
  "corporateId": "511234567",
  "debtorName": "Debtor Ltd",
  "accountType": "corporate",
  "debtorAccount": "120120-001-999999",
  "remittanceInformationUnstructured": "Monthly payroll",
  "executionDate": "2026-03-03",
  "purposeCode": "SALA",
  "context": "batch-2026-03",
  "payments": [
    {
      "instructedAmount": {
        "currency": "ILS",
        "amount": "123"
      },
      "remittanceInformationUnstructured": "Salary - employee 1",
      "creditor": {
        "name": "Employee One",
        "account": "12-538-693304"
      }
    }
  ],
  "userAgreementTimestamp": "2026-02-02T11:14:05.435Z",
  "redirectSuccess": "https://success",
  "redirectFailure": "https://failure",
  "redirectNotComplete": "https://notComplete",
  "redirectNotConclusive": "https://notConclusive"
}

Request fields

Payment item fields

Limits and rules

Statuses

Bulk payments progress through bank statuses.

RCVD → PATC / PART → ACTC / ACWC / RJCT / CANC

Common error codes

Testing outcomes

Use the 5-digit test account 12345 with these PSU IDs to test bulk payout outcomes.