Guides
  1. Payment Links
  2. Foreign Currency (BETA)

Feezback link configuration

Congifure a payment link with foreign currency options on Feezback's screens.

  1. Configure currency options and default value

    Within the transfer.currency object, include the following values

    Field
    Type
    Foreign currency instructions
    value
    The default currency selected
    editable
    Defines wethere the debtor may change the default currency
    if "true" - the user may select a different currency from the supportedCurrencies list.
    supportedCurrencies
    A list of supported currencies
    3 letters currency code for each supported currency. Send [*] to support all currencies.

  2. Configure additional "payment" object requirements:

  • If transfer.currency is not ILS, or if you enable supportedCurrencies other then ILS,
    all of the following fields are required to generate a link:
Field
Type
Foreign currency/International instructions
payment.
transfer.
currency.
value
string
The default currency for the transfer
payment.
transfer.
currency.
editable
boolean
Defined wether the debtor can select a different currency from the supportedCurrencies list
payment.
transfer.
currency.
supportesCurrencies
list
a list of currencies you accept (no limitation is BETA). if currency.editable=false, the user will not be able to select from the list.
payment.
creditor.
enCreditorName
string
creditor name in EN characters and spaces only. No special characters.
payment.
creditor.
enCreditorName.
address.
town
string
creditor city in EN characters and spaces only. No special characters.
payment.
creditor.
enCreditorName.
address.
country
string
creditor country in EN characters and spaces only. No special characters
payment.
creditor.
creditorAgent
string
The creditor's bank account SWIFT code
payment.
creditor.
reasonCode
string
A reason code representing the transfer reason. See codes mapping.

Example payload:

{
  "encrypt": true,
  "iss": "tpp/{tppId}",
  "srv": "fast/user",
  "sub": "123456",
  "flow": {
    "id": "default",
    "userWasAuthenticated": true,
    "context": "{transactionIdentifier}",
    "userIdentifier": {
      "type": "ID",
      "value": "123456789",
      "editable": true
    },
    "redirects": {
     "pisSuccess": "https://example.com/success",
     "pisFailure": "https://example.com/failure",
     "pisNotComplete": "https://example.com/not-complete",
     "ttlExpired": "https://example.com/expired"
    },
    "payment": {
      "remittanceInformationUnstructured": "payment description",
      "creditor": {
        "name": "חברה בע״מ",
        "account": "IL360115350000123456789",
        "accountType": "iban",
        "enCreditorName": "Company LTD",
        "address": {
          "town": "Tel Aviv",
          "country": "IL"
        },
        "creditorAgent": "XXXUILITX",
        "reasonCode": "12"
      },
      "transfer": {
        "amount": {
          "value": "1.00",
          "editable": true
        },
        "currency": {
          "value": "ILS",
          "editable": true,
          "supportedCurrencies": [
            "EUR",
            "ILS",
            "USD"
          ]
        }
      }
    }
  }
}

Updated 7 days ago

Did this page help you?