Connecting payment via a specific bank on your platform

1. You need to complete the integration registration process.

Integration Connection Guide

---

2. Retrieving the List of Banks for Payment

To retrieve the list of banks, make a request to the following URL:

https://api.martpay.net/api/v2/pis/payment/ob-institutions

Get ob institutions

Example answer:

[
    {
    "institution_id": "22cd85e2-c368-4310-a9e6-a3d208e2eb4b",
    "institution_name": "ABN AMRO",
    "country_code": "NL",
    "logo_link": "https://d1uuj3mi6rzwpm.cloudfront.net/logos/providers/nl/abn_amro_nl.svg",
    "is_for_test": false
    }
]

---

3. Creating a button for the selected bank

Add a payment button for a specific bank on the page, using its institution_name and logo_link from the list.

---

4. Creating a payment link

To create a payment link, send a POST request with the following parameters:

Request Parameters:

• merchant_order_id – unique order identifier (string)

• payment_amount – payment amount (number)

• payment_currency – payment currency, e.g., "EUR"

• return_url – URL to which the customer will be redirected after completing the payment

• institution_id – identifier of the selected bank

• institution_country_code – bank country code

Initiate Payment

Example:

{
  "merchant_order_id": "order_id", 
  "payment_amount": 10, 
  "payment_currency": "EUR",
  "return_url": "https://display-parameters.com",
  "institution_id": "banco-comercial-portugues-sa-sandbox",
  "institution_country_code": "PT"
}

Once the link is created, redirect the customer to the provided URL to complete the payment.

---

5. Passing Payer Information via extraFields

Different banks may have specific requirements for the data that must be provided when initiating a payment. By default, the extraFields parameter is not required for most banks; however, in certain cases, it is necessary to include specific additional parameters.

The extraFields object can include the following possible values:

• name

• bic (Bank Identifier Code)

• iban (account number)

• country

• city

• postalCode

• countryCode

• buildingNumber

• streetName

• addressLines

• psuId (user identifier in the bank)

• psuCorporateId (company identifier in the bank)

For a detailed description of each field, see the “Initiate Payment” section.

The example below shows the additional fields that must be provided when creating a payment.

[
  {
    "institution_id": "67bd35a3-2574-4c76-911c-6974aeb4cbbd",
    "institution_name": "Allianz Bank Financial Advisors",
    "country_code": "IT",
    "logoUrl": "https://d1uuj3mi6rzwpm.cloudfront.net/logos/providers/bg/allianz_bg.svg",
    "is_for_test": false,
    "extraFields": [
      "iban"
    ]
  },
]