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 Provider Private accounts Business 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
- Create a bearer token through the token generation API using
srv: "seamless/tpp". - Make a POST request with your payment details to the requests-for-payments API. Feezback forwards the request to the debtor's bank.
- 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.
- 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
}| Field | Type | Required | Description |
|---|---|---|---|
sub | string | Yes | Subject used for the API user path. Do not include personally identifiable information (PII) if the value may appear in a URL. |
iss | string | Yes | Issuer in the format tpp/{TPP_ID}. |
srv | string | Yes | Use seamless/tpp. |
iat | number | Yes | Issued-at timestamp in Unix seconds. Use the current time. |
exp | number | Yes | Expiration timestamp in Unix seconds. Use the current time plus 600 seconds. |
ttl | number | Yes | Token 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/.
| Setting | Value |
|---|---|
| Algorithm | RS512 |
| Issuer format | tpp/{TPP_ID} |
| Request origin | Whitelisted 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:
| Environment | Token endpoint |
|---|---|
| Integration | https://lgs-integ01.feezback.cloud/token |
| Production | https://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:
| Environment | TPP API host |
|---|---|
| Integration | https://integ01-tpp.feezback.cloud |
| Production | https://prod-tpp.feezback.cloud |
Configure request fields
OB-RTP uses the standard Seamless payment fields, with these additions and changes:
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:
| Field | Description |
|---|---|
paymentId | A unique identifier for the transaction, generated by Feezback. |
aspspIssues | Object 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:
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
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_methodfield may containPIS,RTP, orOB-RTP. OB-RTP stands for Open Banking Request To Pay - Use
payload.contextto correlate the webhook with your original request. - See Webhooks & IP Whitelisting for webhook delivery requirements and IP allowlisting.
Testing accounts
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
contextvalue. -
Treat
rejectedand 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": ""
}
]
}Updated 10 days ago