Перейти к содержанию

Blik

Вариант интеграции MF

Оплата

Процесс оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет в MerchantPay запрос оплаты со значением blik в параметре method.type.
  3. MerchantPay возвращает URL страницы оплаты в параметре redirect_url.
  4. Торговец перенаправляет покупателя на этот URL. Покупатель вводит шестизначный BLIK-код и подтверждает оплату в мобильном приложении банка.
  5. MerchantPay отправляет торговцу автоматическое уведомление с финальным статусом оплаты. Торговец также может отправить запрос получения статуса транзакции.

Info

Доступные валюты зависят от настроек шлюза. Настройки по умолчанию включают EUR, GBP и PLN.

Запрос

Отправьте запрос оплаты со следующими данными:
object
amount
обязательный
 bigInteger
Сумма транзакции в минимальных денежных единицах, например, 1000 (10 единиц выбранной валюты).
currency
обязательный
 string (3)
Валюта транзакции в формате ISO 4217 alpha-3.
description
обязательный
 string (512)
Описание заказа.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
ip
 string
IP-адрес покупателя.
language
 string (2)
Язык покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
blik.
object
Секция информации о покупателе.
first_name
обязательный
 string (60)
Имя покупателя.
last_name
обязательный
 string (60)
Фамилия покупателя.
email
обязательный
 string
Адрес электронной почты покупателя.
external_id
 string (128)
Идентификатор покупателя в системе торговца.
birth_date
 string
Дата рождения покупателя в формате ISO 8601 (YYYY-MM-DD).
phone
 string (18)
Номер телефона покупателя, включая код страны.
country
обязательный
 string (2)
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
address
обязательный
 string (300)
Платёжный адрес покупателя.
city
обязательный
 string (50)
Город покупателя.
state
 string (40)
Штат или регион покупателя.
zip
обязательный
 string (12)
Почтовый индекс покупателя.
Пример запроса 
{
    "request": {
        "amount": 1000,
        "currency": "PLN",
        "description": "Order 1234",
        "return_url": "https://example.com/return",
        "ip": "203.0.113.10",
        "language": "en",
        "method": {
            "type": "blik"
        },
        "customer": {
            "first_name": "Anna",
            "last_name": "Nowak",
            "email": "anna@example.com",
            "external_id": "customer-1234",
            "birth_date": "1990-05-14",
            "phone": "+48500111222",
            "country": "PL",
            "address": "Main Street 1",
            "city": "Warsaw",
            "zip": "00-669"
        }
    }
}
Ответ

Перенаправьте покупателя на URL из параметра redirect_url. Возврат покупателя на сайт торговца не подтверждает статус оплаты. Для получения результата используйте автоматическое уведомление или запрос получения статуса транзакции.

Пример ответа 
{
    "transaction": {
        "uid": "9e56f974-d451-48de-b6ad-26b6d50ad659",
        "type": "payment",
        "status": "pending",
        "amount": 1000,
        "currency": "PLN",
        "description": "Order 1234",
        "created_at": "2026-10-21T12:59:01Z",
        "updated_at": "2026-10-21T12:59:01Z",
        "method_type": "blik",
        "receipt_url": "https://backoffice.universepay.eu/customer/transactions/9e56f974-d451-48de-b6ad-26b6d50ad659/4dde6130921fed930ca8c1cd4e04a9d532cc082b855f87a41964c1568345865e?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 6749,
            "ref_id": "e3907a8b339943b9b0642e56e184789b",
            "message": "Transaction was initialized."
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "birth_date": "1990-05-14",
            "first_name": "Anna",
            "external_id": "customer-1234",
            "ip": "203.0.113.10"
        },
        "manually_corrected_at": null,
        "version": 2,
        "message": "Transaction was initialized.",
        "test": false,
        "language": "en",
        "billing_address": {
            "zip": "00-669",
            "city": "Warsaw",
            "email": "anna@example.com",
            "phone": "+48500111222",
            "address": "Main Street 1",
            "country": "PL",
            "last_name": "Nowak",
            "birth_date": "1990-05-14",
            "first_name": "Anna"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}