Blik

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

Оплата

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

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет Freepayment запрос оплаты, указав код BLIK.
Freepayment присылает в ответе торговцу ссылку на страницу оплаты.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель видит спиннер во время завершения платежа и перенаправляется на return_url.

Info

 Этот вариант интеграции поддерживает только валюту `PLN`.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip * обязательный	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
password * обязательный	string (6)	Код BLIK.
customer	object	Секция информации о покупателе.
first_name * обязательный	string	Имя покупателя. Параметр должен содержать от 2 до 50 символов. Допускается использование только букв латинского алфавита.
last_name * обязательный	string	Фамилия покупателя. Параметр должен содержать от 2 до 50 символов. Допускается использование только букв латинского алфавита.
email * обязательный	string	Адрес электронной почты покупателя.
phone	string	Номер телефона покупателя с `+`.

Пример запроса

{
    "request":{
        "amount":13500,
        "currency":"PLN",
        "description":"description",
        "test":false,             
        "tracking_id":"your_uniq_number",
        "language":"en",
        "notification_url":"https://example.com/notification",
        "return_url":"https://example.com/return/",
        "ip": "127.200.00.0",
        "customer":{
            "email":"jan@example.com",                  
            "first_name": "Jan",
            "last_name" : "Kowalski"
        },
        "method":{
            "type":"blik",
            "password": "777777"
        }
    }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

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

{
  "transaction": {
    "uid": "9b32fcba-f5eb-47bf-9ae5-4bbb8cf10072",
    "type": "payment",
    "status": "pending",
    "amount": 13500,
    "currency": "PLN",
    "description": "description",
    "created_at": "2024-10-09T12:29:57Z",
    "updated_at": "2024-10-09T12:29:59Z",
    "method_type": "blik",
    "receipt_url": "https://account.freepayment.online/customer/transactions/9b32fcba-f5eb-47bf-9ae5-4bbb8cf10072/042ad10c16b31828f97ea0e3a71c3371f6f1653a1100ba4e5ab3b00586dbeaaf?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 4544,
      "message": "Transaction was initialized.",
      "bank_code": ""
    },
    "blik": {
      "type": "blik",
      "password": "777777"
    },
    "customer": {
      "first_name": "Jan",
      "last_name": "Kowalski",
      "email": "jan@example.com",
      "ip": "127.200.00.0"
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": false,
    "language": "en",
    "billing_address": {
      "first_name": "Jan",
      "last_name": "Kowalski",
      "email": "jan@example.com"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://payment-page/redirect/to/269/251354/01T7HwrLOiTpujB6lpX6eiGOJruWdKbLr4iY4cpfvlTRceqsrXDy3UH7_9VU5r9ECz",
      "method": "GET",
      "fields": []
    }
  }
}

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

Оплата

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

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет Freepayment запрос оплаты.
Freepayment присылает в ответе торговцу ссылку на страницу оплаты.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель завершает платёж.
Freepayment высылает торговцу автоматическое уведомление.

Info

Этот вариант интеграции поддерживает только валюту PLN.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
customer	object	Секция информации о покупателе.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
additional_data	object	Секция, содержащая дополнительную информацию о платеже.
browser	object	Секция параметров браузера покупателя.
accept_header	string	Значение HTTP-заголовка `Accept` запроса от браузера покупателя.
screen_color_depth	integer	Глубина цвета экрана в битах на пиксель. Соответствует параметру `screen.colorDepth` в JavaScript. Возможные значения: `1` - 1 bit `4` - 4 bits `8` - 8 bits `15` - 15 bits `16` - 16 bits `24` - 24 bits `32` - 32 bits `48` - 48 bits.
language	string	Язык навигатора. Соответствует параметру `navigator.language` в JavaScript.
screen_height	integer	Высота экрана в пикселях. Соответствует параметру `screen.height` в JavaScript.
screen_width	integer	Ширина экрана в пикселях. Соответствует параметру `screen.width` в JavaScript.
time_zone	integer	Смещение часового пояса относительно часового пояса UTC в минутах для текущей локали. Соответствует параметру `new Date().getTimezoneOffset()` в JavaScript.
user_agent	string	Строка агента пользователя текущего браузера. Соответствует параметру `navigator.userAgent` в JavaScript.
java_enabled	boolean	Параметр показывает, включен ли java в текущем браузере или нет. Соответствует параметру `navigator.javaEnabled()` в JavaScript.
window_width	integer	Размер окна браузера по горизонтали в пикселях. Соответствует параметру `document.body.clientWidth` в JavaScript.
window_height	integer	Размер окна браузера по вертикали в пикселях. Соответствует параметру `document.body.clientHeight` в JavaScript.

Пример запроса

{
  "request": {
    "amount": 5000,
    "currency": "PLN",
    "ip": "127.0.0.1",
    "description": "description",
    "return_url": "https://return.com",
    "method": {
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe"
    },
    "additional_data": {
      "browser": {
        "accept_header": "text/html,application/xhtml+xml,application/xml",
        "screen_color_depth": 24,
        "language": "en",
        "screen_height": 800,
        "screen_width": 600,
        "time_zone": -300,
        "user_agent": "AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0",
        "java_enabled": true,
        "window_width": 1024,
        "window_height": 640
      }
    }
  }
}

Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

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

{
    "transaction": {
        "uid": "d7b88f80-f714-4f64-9aeb-dc880b3b7b4a",
        "type": "payment",
        "status": "pending",
        "amount": 2300,
        "currency": "PLN",
        "description": "test",
        "created_at": "2025-01-11T11:31:09Z",
        "updated_at": "2025-01-11T11:31:10Z",
        "method_type": "blik",
        "receipt_url": "https://account.freepayment.online/customer/transactions/d7b88f80-f714-4f64-9aeb-dc880b3b7b4a/e598bbe9b8a2deaf99fbcefca028f6c6c2b7eedf593d3ee37151e9acd61844da?language=ru",
        "payment": {
            "status": "pending",
            "gateway_id": 4824,
            "ref_id": "4214474",
            "message": "Invoice is created successfully, waiting for a payment",
            "bank_code": 31
        },
        "blik": {
            "type": "blik"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Invoice is created successfully, waiting for a payment",
        "tracking_id": "your_uniq_number21212",
        "test": true,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://test-ss/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
            "method": "GET",
            "fields": []
        }
    }
}