Подключение оплаты через конкретный банк на вашем сайте

1. Вам необходимо завершить процесс регистрации интеграции.

Инструкция по подключению интеграции

---

2. Получение списка доступных банков

Чтобы получить список банков, отправьте запрос по следующему URL-адресу:

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

Get ob institutions

Пример ответа:

[
    {
    "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. Создание кнопки для выбранного банка

На своем сайте добавьте кнопку для оплаты через нужный банк, используя название (institution_name) и логотип (logo_link) из полученного списка

---

4. Создание платежной ссылки

Для генерации платежной ссылки отправьте POST-запрос с следующими параметрами:

Параметры запроса:

• merchant_order_id – уникальный идентификатор заказа (string).

• payment_amount – сумма платежа (number).

• payment_currency – валюта платежа "EUR"

• return_url – URL, на который будет переадресован клиент после завершения платежа.

• institution_id – идентификатор выбранного банка.

• institution_country_code – код страны банка.

Initiate Payment

Пример:

{
  "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"
}

После успешного создания ссылки, используйте полученный URL для перенаправления клиента на страницу оплаты

---

5. Передача параметров о плательщике через extraFields

Разные банки могут предъявлять свои требования к данным, которые необходимо предоставить для инициирования платежа

По умолчанию (для многих банков) extraFields нет, однако в некоторых случаях необходимо передавать определенные параметры.

В объекте extraFields могут быть следующие возможные значения:

• name

• bic (банковский идентификационный код)

• iban (номер счета)

• country

• city

• postalCode

• countryCode

• buildingNumber

• streetName

• addressLines

• psuId (идентификатор пользователя в банке)

• psuCorporateId (идентификатор компании в банке)

Подробное описание каждого поля см. в разделе «Initiate 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"
    ]
  },
]