---
updatedAt: 2026-11-11T09:57:57.000Z
agentTools:
  projectIndex: https://docs.feezback.cloud/llms.txt
---

# Immediate Payment Links

Payment links with real-time execution — guaranteed immediate or with automatic fallback to regular transfers.

Immediate Payments enables real-time execution of bank transfers initiated with a payment link. Using **FP** (immediate transfer) or **Zahav** (RTGS) as the underlying payment product, with Feezback automatically resolving the best suited transfer type given the debtor and creditor banks.

### How to generate an immediate payment link?

1. Complete the Single-Payment integration and configuration requirements for <Anchor target="_blank" href="/docs/feezback-link">Feezback-Link</Anchor> or for a <Anchor target="_blank" href="/docs/fast-seamless">Seamless-link</Anchor>
2. Once you are able to generate a single payment link, configure the "`paymentMode`" within the request body:
   1. "**IMMEDIATE**": for Zahav/FP execution only (available within Zahav working hours).
   2. "**PREFER\_IMMEDIATE**": for Masav execution out of Zahav availability hours (Masav execution is completed by the end of the business day).
3. Generate a Payment link
4. If you enable currency selection, you will get the actual currency used for the transaction with the webhook status updates.

## The two `paymentMode` values

Add an optional `paymentMode` field to `flow.payment` in your signed JWT:

| `paymentMode`      | Behavior                                                                                                                                                       | Rejected outside Zahav hours?                                                                                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `IMMEDIATE`        | Only FP or Zahav is used. No fallback.                                                                                                                         | **Yes** — link generation is rejected with a dedicated error if requested outside Zahav availability hours (see below), including within 7 minutes of hours closing. |
| `PREFER_IMMEDIATE` | FP or Zahav is preferable. If neither is available (due to unsupported ASPSP pair, or outside Zahav hours), the payment automatically falls back to **Masav**. | No — this mode always has a fallback, so no hours-based gate applies at request/generation time.                                                                     |

If `paymentMode` is omitted, behavior is unchanged (standard Masav execution with FP where available).

##

## Zahav availability hours

| Day                  | Hours       |
| -------------------- | ----------- |
| Sunday–Thursday      | 07:45–18:45 |
| Friday / holiday eve | 07:45–14:00 |
| Saturday / holiday   | Closed      |

Link generation for `paymentMode=IMMEDIATE` is rejected during closed hours **and within the last 7 minutes before closing**.&#x20;

<br />

## Requesting an Immediate Payment

### 1. Set `paymentMode`

Accepted values: `"IMMEDIATE"`, `"PREFER_IMMEDIATE"`. Omit or send `null` for standard (non-immediate) behavior.

### 2. Debtor details

For `"IMMEDIATE"`/ `"PREFER_IMMEDIATE"` payments, the following fields are required when generating a link:

| Field            | Feezback Link (UI)                                      | Seamless Link                             |
| ---------------- | ------------------------------------------------------- | ----------------------------------------- |
| `debtorName`     | Optional — collected in the Feezback UI if not supplied | **Mandatory** — no UI to collect it later |
| `debtorAddress1` | Optional — collected in the Feezback UI if not supplied | **Mandatory** — no UI to collect it later |

Both fields: English characters only (`a-z A-Z 0-9 ' ( ) ,`), max 35 characters.

### 3. Validation rules

For `"IMMEDIATE"`/ `"PREFER_IMMEDIATE"` payments, the following validations are required for existing fields when generating a link:

1. `creditorName`: English characters only (`a-z A-Z 0-9 ' ( ) ,`)
2. `remittanceInformationUnstructured`: English characters only (`a-z A-Z 0-9 ' ( ) ,`)
3. `instructedAmount.currency` must be `ILS` (immediate payments are supported for ILS only, foreign-currency options are not available).
4. Periodic-payment options are not available

<br />

### 4. Response

#### Errors specific to Immediate Payments:

1. **Request an "IMMEDIATE" link generation outside Zahav availability hours**:
   1. Fezzback link returns error code "1024"
   2. Seamless link returns the following error object in the response body:<br />
      ```text
      HTTP/1.1 400 Bad Request
      {
        "error": {
          "code": "INVALID_PAYMENT_PAYLOAD",
          "message": "Immediate payment is not available at the moment"
        },
        "meta": null
      }
      ```
2. **Required or ASPSP-specific fields missing/invalid:**<br />Standard field-validation error, same pattern as other payment link payloads. See [Error Scenarios](https://docs.feezback.cloud/docs/error-handling-1) and [Payment rejection and Error Scenarios](https://docs.feezback.cloud/docs/payment-rejection-and-error-scenarios) for the general error format.

## Payment status & webhooks

You will keep getting the same <Anchor target="_blank" href="https://docs.feezback.cloud/update/docs/webhook-updates">status updates via webhook</Anchor> as for any payment link.

Look for the following fields on the webhook payload to understand what payment method was applied and when the funds are expected on the creditor account:

1. `transferType` : indicates the actual payment product used for the transfer
   1. Optional values:
      1. "zahav"
      2. "fp"
      3. "masav"
2. `currentStatus`: different payment products return different statuses when the payment is approved. See more on the [payment statuses page](https://docs.feezback.cloud/update/docs/payment-statuses)

<Callout icon="far fa-circle-info" theme="info">
  ### ZAHAV payment status may be delayed

  Since Zahav payments include a confirmation from the creditor bank that the funds were received, the final approval status may be sent **up to 30 minutes** after the debtor approval of the transaction.
</Callout>

## Fees

The immediate option may incur Zahav fees charged to the debtor, according to their bank account's fee policy.

<br />