Open Banking Payment Requests (BETA)

Create an Open Banking Payment Request and receive asynchronous payment status updates by webhook.

Create a payment request that will appear on the debtor’s bank portal/app. Once the request is created, the bank will send an SMS to the debtor, notifying them on the request awaiting for approval.

📘

Supported Banks

Payment ProviderPrivate accountsBusiness account
Leumi/Pepper - 10✅✅
Poalim - 12✅✅
Discount/Mercantile - 11,17✅✅
Mizrahi - 20✅✅
FIBI group - 14,26,31,46,52❌ production bug on provider side✅

When to use OB-RTP

Use OB-RTP when:

  • You want to request payment without redirecting the payer immediately.
  • The payer should approve the request later inside their bank portal or app.
  • Your use case needs asynchronous collection, such as debt collection or business payment requests.

Use Single Payment or Fast Seamless instead when you need a single session synchronous process .

How the OB-RTP flow works

  1. Create a bearer token through the token generation API using srv: "seamless/tpp".
  2. Make a POST request with your payment details to the requests-for-payments API. Feezback forwards the request to the debtor's bank.
  3. Receive the payment identifier and any reported bank service issues in the response. The debtor approves the request later in their bank portal or app; you do not redirect them to a payment link.
  4. Monitor payment status updates through webhooks. Feezback monitors the transaction, sends an update on every status transition, and stops polling when the request reaches a final status.

1. Create a bearer token

OB-RTP uses the same bearer token flow as Seamless payment links.

Create the JSON payload

Replace {TPP_ID} with your organization ID and set iat and exp to current timestamps as described below.

{
  "sub": "sub",
  "iss": "tpp/{TPP_ID}",
  "srv": "seamless/tpp",
  "iat": 1728986260,
  "exp": 1728986860,
  "ttl": 600
}
FieldTypeRequiredDescription
substringYesSubject used for the API user path. Do not include personally identifiable information (PII) if the value may appear in a URL.
issstringYesIssuer in the format tpp/{TPP_ID}.
srvstringYesUse seamless/tpp.
iatnumberYesIssued-at timestamp in Unix seconds. Use the current time.
expnumberYesExpiration timestamp in Unix seconds. Use the current time plus 600 seconds.
ttlnumberYesToken validity in seconds. Use 600.

Sign the JWT

Convert the JSON from the previous step into a JWT (JSON Web Token).
Sign the payload with RS512 using the private key that matches the public key you provided to Feezback.
For manual JWT signing see https://www.jwt.io/.

SettingValue
AlgorithmRS512
Issuer formattpp/{TPP_ID}
Request originWhitelisted backend IP address

Exchange the signed JWT for a bearer token

Send the signed JWT to the /token endpoint. Replace {GENERATED_JWT_TOKEN} with your signed JWT and use the token endpoint for your environment from the table below.

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

Replace {ENVIRONMENT} with one of these values:

EnvironmentToken endpoint
Integrationhttps://lgs-integ01.feezback.cloud/token
Productionhttps://lgs-prod.feezback.cloud/token

Use the returned bearer token

The JSON response contains a token. Use the returned token in the Authorization header when calling the TPP API:

Authorization: Bearer {GENERATED_TOKEN_FROM_PREVIOUS_STEP}
The response token is valid for 600 seconds.

2. Make a POST request with your payment details

Call the requests-for-payments endpoiny with the bearer token. Use the same sub and TPP ID as in your JWT for the {sub}@{tpp_id} user path.

POST https://{TPP_ENVIRONMENT}-tpp.feezback.cloud/tpp/v1/users/{sub}@{tpp_id}/requests-for-payments
--header 'Authorization: Bearer {GENERATED_TOKEN_FROM_PREVIOUS_STEP}'

Use the correct API host:

EnvironmentTPP API host
Integrationhttps://integ01-tpp.feezback.cloud
Productionhttps://prod-tpp.feezback.cloud

Configure request fields

OB-RTP uses the standard Seamless payment fields, with these additions and changes:


FieldTypeRequiredNotes
debtorName
string
Yes
Payer name. Use Hebrew or English letters only.

All other standard payment fields according to the seamless configuration guide.

  • Only ILS (Israeli new shekel) is supported. Payment requests in other currencies are not supported.

Example request body for a private debtor:

{
    "context": "11112222",
    "idValue": "200200202",
    "debtorName": "ישראל ישראלי",
    "bankCode": "12",
    "accountType": "private",
    "amount": "712.00",
    "creditorAccount": "IL430110040000000123456",
    "creditorName": "חברה בעמ",
    "remittanceInformationUnstructured": "תשלום עבור שירות"
}

Example request body for a corporate debtor:

{
    "context": "11112222",
    "idValue": "200200202",
    "debtorName": "ישראל ישראלי",
    "bankCode": "12",
    "accountType": "corporate",
    "corporateId": "51222222222",
    "amount": "712.00",
    "creditorAccount": "IL430110040000000123456",
    "creditorName": "Kathleen Martinez",
    "remittanceInformationUnstructured": "תשלום עבור שירות"
}

3. Handle the payment request response

Success - 201

In response to a valid request, you will receive:

FieldDescription
paymentIdA unique identifier for the transaction, generated by Feezback.
aspspIssuesObject array — indicates if any service issues are currently active on the debtor's bank.

Example:

{
  "paymentId": "0f2aee50-dd9f-4bee-9583-1c7809c4f933",
  "aspspIssues": []
}

When a successfull response is received, it means a payment request awaits the debtor on his bank portal/app for approval. The debtor will get an SMS message from the bank notifying them on the payment request.

Error

If the OB-RTP service is not enabled for your organization, the request returns PAYMENT_REQUEST_METHOD_NOT_ALLOWED. Contact Feezback to enable the service for your organization.

In response to an invalid request, or if an error occurs, an error code and description are returned according to the following mapping:

Status codeError codeMessage
400
INVALID_PAYMENT_PAYLOAD
"Missing or invalid values format: [<fieldname>, ...]"
400
IBAN_IS_NOT_WHITELISTED
"Creditor account is not whitelisted"
424
ASPSP_ERROR
"Failed to initiate payment on the bank side"
500
PAYMENT_REQUEST_FAILED
"Failed to create payment"

Example:

{
  "error": {
    "code": "INVALID_PAYMENT_PAYLOAD",
    "message": "Missing or invalid values format: ['idValue']"
  },
  "meta": null
}

4. Monitor for payment status updates

Store the returned paymentId and your request's context value. Creating the request does not mean the debtor has approved it: the debtor approves it later in their bank portal or app, without a redirect from your application.

Feezback monitors the transaction and sends you the standard PaymentStatusChanged webhook on every status transition, with an additional payment_method field. Feezback stops polling when the request reaches a final status.

Transaction statuses

Status
Meaning
pending
The request was received by the bank but has not yet been matched to a customer.
received
The request is available for the customer on their bank portal/app and is awaiting confirmation.
presented (optional)
The payment request has been presented to the customer in their bank portal or app. Optional — not all banks send this status.

All other transaction statuses (for approval/rejection) are as detailed on Payment Webhooks according to the payment product applied (Masav/FP):

  • rejected
  • partiallyAcceptedTechnicalCorrect
  • acceptedFundsChecked
  • acceptedTechnicalValidation
  • acceptedWithChange
  • acceptedSettlementInProcess
  • acceptedSettlementCompleted

Webhook payload example

{
  "event": "PaymentStatusChanged",
  "timestamp": "2025-01-18T18:25:54.114182+00:00",
  "payload": {
    "paymentRequest": "uuid",
    "context": "rtp-20250113001",
    "payment_method": "OB-RTP",
    "currentStatus": "received",
    "previousStatus": "received"
  }
}
  • The payment_method field may contain PIS, RTP, or OB-RTP. OB-RTP stands for Open Banking Request To Pay
  • Use payload.context to correlate the webhook with your original request.
  • See Webhooks & IP Whitelisting for webhook delivery requirements and IP allowlisting.

Testing accounts

See Testing & mockbank

Operational notes

  • OB-RTP is asynchronous. Do not expect the payer to approve the request during the API call.

  • Store the returned payment request identifier and your context value.

  • Treat rejected and expiry-related statuses as terminal failure states.

  • Check the ASPSP issues feed before creating requests:

    https://fb.feezback.cloud/aspsp_issues.json

Postman collection

{
  "info": {
    "_postman_id": "079f2665-e118-4d83-9d77-21ce3d9f0998",
    "name": "Feezback Payment Request - Open Banking (Integration)",
    "description": "Feezback | בקשת תשלום בבנקאות פתוחה (OB-RTP). העסק שולח בקשת תשלום, והמשלם מאשר אותה בבנק שלו.\n\nהכנה: לייבא את ה-Environment, לבחור אותו ולמלא privateKey.\nסדר הרצה: 1 > 2 > Webhook עם הסטטוס.\n\nדוקומנטציה: https://docs.feezback.cloud/docs/request-to-pay\nwww.feezback.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{accessToken}}",
        "type": "string"
      }
    ]
  },
  "item": [
    {
      "name": "1. Get Access Token (seamless/tpp)",
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "// ---- חתימת JWT (RS512) עבור srv: seamless/tpp ----",
              "// אם הדבקתם JWT חתום ידנית במשתנה manualJwt - הוא ישמש במקום החתימה האוטומטית.",
              "const manual = pm.variables.get('manualJwt');",
              "if (manual && manual.trim()) {",
              "    pm.variables.set('signedJwt', manual.trim());",
              "    console.log('Using manualJwt');",
              "    return;",
              "}",
              "",
              "const now = Math.floor(Date.now() / 1000);",
              "const payload = {",
              "    sub: pm.variables.get('sub'),",
              "    iss: 'tpp/' + pm.variables.get('tppId'),",
              "    srv: 'seamless/tpp',",
              "    iat: now,",
              "    exp: now + 600,",
              "    ttl: 600",
              "};",
              "",
              "function signAndStore() {",
              "    var navigator = {}; var window = {};",
              "    eval(pm.collectionVariables.get('jsrsasign_lib'));",
              "    let key = pm.variables.get('privateKey');",
              "    if (key === undefined || key === null || String(key).trim() === '') {",
              "        throw new Error('privateKey ריק - ודאו שה-Environment הנכון נבחר למעלה מימין ושהמפתח הודבק ב-Current value');",
              "    }",
              "    key = String(key).replace(/\\\\n/g, '\\n').replace(/\\r/g, '').trim();",
              "    if (key.includes('PASTE_YOUR_KEY')) {",
              "        throw new Error('privateKey עדיין מכיל את טקסט הדוגמה - הדביקו את המפתח האמיתי ב-Current value');",
              "    }",
              "    const header = { alg: 'RS512', typ: 'JWT' };",
              "    let candidates = [];",
              "    if (key.includes('PRIVATE KEY')) {",
              "        candidates.push(key);",
              "    } else {",
              "        // מפתח בלי שורות BEGIN/END: מנסים לעטוף אוטומטית",
              "        const b64 = key.replace(/\\s+/g, '');",
              "        const body = b64.match(/.{1,64}/g).join('\\n');",
              "        candidates.push('-----BEGIN PRIVATE KEY-----\\n' + body + '\\n-----END PRIVATE KEY-----');",
              "        candidates.push('-----BEGIN RSA PRIVATE KEY-----\\n' + body + '\\n-----END RSA PRIVATE KEY-----');",
              "    }",
              "    let jwt = null, lastErr = null;",
              "    for (const k of candidates) {",
              "        try { jwt = KJUR.jws.JWS.sign('RS512', JSON.stringify(header), JSON.stringify(payload), k); break; }",
              "        catch (e) { lastErr = e; }",
              "    }",
              "    if (!jwt) {",
              "        throw new Error('לא הצלחנו לקרוא את privateKey כמפתח RSA פרטי (PEM). התחלת הערך: ' + key.slice(0, 30) + '... | ' + lastErr);",
              "    }",
              "    pm.variables.set('signedJwt', jwt);",
              "    console.log('JWT payload (seamless/tpp):', JSON.stringify(payload));",
              "}",
              "",
              "if (pm.collectionVariables.get('jsrsasign_lib')) {",
              "    signAndStore();",
              "} else {",
              "    pm.sendRequest('https://cdnjs.cloudflare.com/ajax/libs/jsrsasign/11.1.0/jsrsasign-all-min.js', (err, res) => {",
              "        if (err) { throw err; }",
              "        pm.collectionVariables.set('jsrsasign_lib', res.text());",
              "        signAndStore();",
              "    });",
              "}",
              ""
            ]
          }
        },
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "pm.test('Status 200', () => pm.response.to.have.status(200));",
              "const body = pm.response.json();",
              "const t = body.token || body.access_token;",
              "pm.test('Token returned', () => pm.expect(t).to.be.a('string'));",
              "pm.collectionVariables.set('accessToken', t);",
              "console.log('accessToken נשמר (תקף 600 שניות)');"
            ]
          }
        }
      ],
      "request": {
        "auth": {
          "type": "noauth"
        },
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"token\": \"{{signedJwt}}\"\n}"
        },
        "url": {
          "raw": "https://{{lgsHost}}/token",
          "host": [
            "https://{{lgsHost}}"
          ],
          "path": [
            "token"
          ]
        },
        "description": "Bearer token עם srv: seamless/tpp, חתום RS512. תקף 600 שניות."
      }
    },
    {
      "name": "2. Create Request for Payment",
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "const now = Date.now();",
              "pm.variables.set('rtpContext', 'postman-obrtp-' + now);"
            ]
          }
        },
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "pm.test('Status 200/201', () => pm.expect(pm.response.code).to.be.oneOf([200, 201]));",
              "let body = {};",
              "try { body = pm.response.json(); } catch (e) {}",
              "console.log('Request-for-payment response:', JSON.stringify(body));",
              "if (body.paymentId) { pm.collectionVariables.set('paymentId', body.paymentId); console.log('paymentId נשמר:', body.paymentId); }",
              "if (body.aspspIssues && body.aspspIssues.length) { console.log('שימו לב - תקלות ידועות בבנק:', JSON.stringify(body.aspspIssues)); }",
              "if (pm.response.code === 403) {",
              "    console.log('403 - ה-TPP לא מורשה ל-requests-for-payments. יש לבקש מפיזבק לאפשר seamless/tpp ל-endpoint הזה.');",
              "} else if (pm.response.code === 424) {",
              "    console.log('424 ASPSP_ERROR - שגיאה בצד הבנק. יש לפנות לפיזבק עם paymentId ושעה מדויקת.');",
              "} else if (pm.response.code >= 400) {",
              "    console.log('שגיאה:', pm.response.code, '- ראו את שדה השגיאה בתשובה.');",
              "} else {",
              "    console.log('הבקשה נשלחה לבנק של המשלם. המשלם מאשר אותה אצלו (אפליקציה/SMS), והסטטוס מגיע ב-Webhook.');",
              "}"
            ]
          }
        }
      ],
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"context\": \"{{rtpContext}}\",\n  \"idValue\": \"{{idValue}}\",\n  \"debtorName\": \"{{debtorName}}\",\n  \"bankCode\": \"{{bankCode}}\",\n  \"accountType\": \"{{accountType}}\",\n  \"amount\": \"{{amount}}\",\n  \"creditorAccount\": \"{{creditorAccount}}\",\n  \"creditorName\": \"{{creditorName}}\",\n  \"remittanceInformationUnstructured\": \"{{remittance}}\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://{{tppHost}}/tpp/v1/users/{{sub}}@{{tppId}}/requests-for-payments",
          "host": [
            "https://{{tppHost}}"
          ],
          "path": [
            "tpp",
            "v1",
            "users",
            "{{sub}}@{{tppId}}",
            "requests-for-payments"
          ]
        },
        "description": "שולח בקשת תשלום לבנק של המשלם. המשלם מאשר אותה אצלו (אפליקציה / SMS / אתר הבנק), בלי לינק ובלי הפניה.\n\nשדות: context, idValue (ת\"ז המשלם), debtorName (עברית/אנגלית בלבד), bankCode (בנק המשלם), accountType, amount, creditorAccount (החשבון שמקבל את הכסף - חייב להיות מאושר אצל פיזבק), creditorName, remittanceInformationUnstructured.\nבחשבון תאגידי (accountType: corporate) חובה גם corporateId.\n\nתשובה: paymentId ו-aspspIssues (תקלות ידועות בבנק).\nסטטוסים ב-Webhook:    סטטוסים ב-Webhook: pending / received > presented (אופציונלי) > סטטוסי accepted* כמו בתשלום רגיל (לפי סוג ההעברה) / rejected / expired.\nשגיאות: 400 INVALID_PAYMENT_PAYLOAD, 400 IBAN_IS_NOT_WHITELISTED, 424 ASPSP_ERROR, 500 PAYMENT_REQUEST_FAILED.\nלפני שליחה מומלץ לבדוק תקלות בבנקים: https://fb.feezback.cloud/aspsp_issues.json"
      }
    }
  ],
  "variable": [
    {
      "key": "accessToken",
      "value": ""
    },
    {
      "key": "paymentId",
      "value": ""
    },
    {
      "key": "jsrsasign_lib",
      "value": ""
    }
  ]
}

Did this page help you?