Blik

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

Оплата

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

Покупатель инициирует оплату на сайте торговца.
Торговец отправляет PacoPay Service Provider запрос оплаты.
PacoPay Service Provider присылает в ответе торговцу ссылку на страницу оплаты.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель завершает платёж.
PacoPay Service Provider высылает торговцу автоматическое уведомление. Торговец также может запросить статус оплаты у PacoPay Service Provider с помощью запроса получения статуса транзакции. Если транзакция успешна, уведомление или ответ на запрос статуса могут содержать параметр blik.account_number с маской карты.

Info

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

Запрос

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

object

return_url

обязательный

string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.

ip

string
IP-адрес покупателя.

object
Секция параметров способа оплаты.

type

обязательный

string
blik

object
Секция информации о покупателе.

first_name обязательный	string Имя покупателя.
last_name обязательный	string Фамилия покупателя.
email обязательный	string Email покупателя.

object
Секция, содержащая дополнительную информацию о платеже.

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",
      "email": "[email protected]"
    },
    "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://dashboard.paco-pay.com/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": "[email protected]",
            "first_name": "John",
            "last_name": "Doe",
            "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",
        "billing_address": {
            "email": "[email protected]",
            "last_name": "Doe",
            "first_name": "John"
        },
        "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
            },
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://test-ss/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
            "method": "GET",
            "fields": []
        }
    }
}