Feezback Link

Use Feezback's LGS (Link Generation Service) to start a user-facing payment initiation flow. Your backend signs a JSON Web Token (JWT), sends it to Feezback from a whitelisted IP address, receives a payment link in return, and forwards that link to the debtor. Once the debtor completes the flow, Feezback sends payment status updates to your webhook endpoint.

Prerequisites

Before you start make sure you have your organization ID and environment access according to the getting started guide.​

In this page

1. Build the JWT payload according to the configuration guide.
2. Sign the payload with your private key using RS512.
3. Send the signed JWT to Feezback's /link endpoint.
4. Receive a payment link in the response.
5. Redirect the debtor to this link or send it by email/SMS.
6. The debtor opens the link, completes the process, and approves the transfer.
7. Feezback sends payment status updates according to your webhook configurations.

1.Build a JSON according to the configuration guide

2.Sign the JWT

Convert the JSON from the previous step into a JWT (JSON Web Token):
Sign the JWT with the private key that matches the public key you sent to Feezback.

For manual JWT signing see https://www.jwt.io/.

3. Send the JWT to Feezback

Before sending the request, replace {GENERATED_JWT_TOKEN} with a JWT signed using your private key and the RS512 algorithm (from previous step).

Send the signed JWT to the /link endpoint for the selected environment.

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

Replace {ENVIRONMENT} with one of these values:

A JSON response is returned. Use the link value from the response body to start the payment process for the payer.

Use this request structure to test link generation in Postman.

{
  "info": {
    "name": "Fast",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Fast LGS",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\"token\": \"{GENERATED_JWT_TOKEN}\"}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "https://lgs-integ01.feezback.cloud/link",
          "protocol": "https",
          "host": [
            "lgs-integ01",
            "feezback",
            "cloud"
          ],
          "path": [
            "link"
          ]
        }
      }
    }
  ]
}

4.Receive a payment link in the response

Example:

https://shl.feezback.cloud/bCIa0cYoSIGd

5.Redirect the debtor to this link or send it by email/SMS

• If redirecting from an app/webpage, make sure to open the link on an external browser and not within a webview/iframe. Opening on a browser ensures optimal success rates when redirecting to the banks' apps.

6.The debtor opens the link, completes the process, and approves the transfer

• On mobile devices, the bank's app will open if installed on the device.
• The user may authenticate with any available method (faceId/fingerprint/password)

7.Listen for status updates from Feezback via webhook endpoint or email

Feezback monitors the transaction and sends you notifications with every payment status update - from redirecting to the bank to receiving the funds. Read more on webhook updates.