Guides
  1. Payment Links
  2. Single Payment
  3. Seamless Link

Configuration guide

Follow this guide to configure your seamless payment link

The JWT includes the details of the requested payment:

  • Amount
  • Currency
  • Creditor account
  • Debtor ID (and optionally - account number)

Payment Line - JWT Payload Example

{
  "idValue": "200200202",
  "accountType": "private",
  "creditorAccount": "IL760125380000000693304",
  "creditorName": "Payee Name",
  "remittanceInformationUnstructured": "Invoice #4471",
  "bankCode": "10",
  "amount": "1.00",
  "context": "unique-transfer-id",
  "userAgreementTimestamp": "2025-03-18T12:09:05+00:00",
  "redirectSuccess": "https://example.com/success",
  "redirectFailure": "https://example.com/failure",
  "redirectNotComplete": "https://example.com/notComplete",
  "redirectNotConclusive": "https://example.com/notConclusive"
}

Request fields

Field
Type
Required
Description
optional values
idValue
string
Yes
The debtor ID
a valid Israeli ID / international Passport number*
creditorAccount
string
Yes
Creditor account number (BBAN/IBAN format)).
Whitelisted production accounts only
creditorName
string
Yes
Name of the payment receiver
He/En characters only. Special characters not allowed
remittance
Information
Unstructured
string
Yes
״סיבת ההעברה״
will appear in the debtor and creditor bank transactions.
Maximum 28 characters. He/En characters only. Special characters not allowed
bankCode
string
Yes
Debtor bank code.
2 digits number from a closed list of supported bank codes.
debtorAccount
string
No
The debtor's account number
Valid IBAN/BBAN (see validation API)
accountType
string
Yes
The account type
“Private” - פרטי
“business” - עוסק
“corporate” - תאגיד
corporateId
string
Mandatory if “accountType”=
“corporate”
business identifier (ח.פ.)
9 digits number starting with 5
amount
number
Yes
Payment amount
Amount in X.XX format. Minimum 1.00.
context
string
Yes
Transaction context returned in webhook notifications.
a unique transaction identifier to correlate the webhook with your internal transaction.
Max 50 characters.
user
Agreement
Timestamp
string
Yes
the time and date in which the user agreed to Feezback’s terms of use.
Users must actively approve Feezback’s terms of use:
תנאי שימוש מידע וייזום מאוחד .pdf
redirect
Success
string
Yes
URL to redirect the user after a successful transfer authorization.
redirect
Failure
string
Yes
URL to redirect the user if transfer authorization fails.
redirect
NotComplete
string
Yes
URL to redirect the user if transfer authorization awaits further approval.
redirect
NotConclusive
string
Yes
URL to redirect the user if we couldn't retrieve payment status.

Configure debtor idValue

  • The debtor's identifier when logging in to the bank app:
    a valid Israeli ID or international Passport number
    • passport number format:
      2 character country code - hyphen "-" - Passport number (1–9 alphanumeric characters)
      For example:
      IL-123456
🪪

ID must match bank login credentials

If the ID doesn't match the username and password on the bank app, authentication will fail.

Configure debtor corporateId

  • CorporateId must be included for payments from corporate accounts.
  • The corporateId is in addition to the payer's personal identifier (idValue)

Configure debtorAccount

  • debtorAccount is an optional parameter.
  • If not included in the request, the user will be requested to select an account to charge on the bank app, after login.
  • If debtorAccount is not included in the request, Feezback cannot guarantee it will return in the webhook data.

Configure userAgreementTimestamp

Configure flow.redirects

  • Your urls to redirect the debtor to at the end of the process (optional)
  • If not set, the flow will end at Feezback's Success/Rejection screen.
  • URLs may not exceed 128 characters

FieldTypeDescription
redirect
Success
string (URL)
URL to redirect the user after a successful transfer authorization.
redirect
Failure
string (URL)
URL to redirect the user if transfer authorization fails.
redirect
NotComplete
string (URL)
URL to redirect the user if transfer authorization awaits further approval.
redirect
NotConclusive
string (URL)
URL to redirect the user if transfer link expired.

Updated about 1 month ago

Did this page help you?