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

Blik

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

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaynetworkGate запрос оплаты.
  3. PaynetworkGate присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. PaynetworkGate высылает торговцу автоматическое уведомление.

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://backoffice.paynetworks.io/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": []
        }
    }
}

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

Info

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

Оплата

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaynetworkGate.
  3. PaynetworkGate присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaynetworkGate.
  5. Покупатель завершает транзакцию.
  6. PaynetworkGate отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaynetworkGate с помощью запроса получения статуса транзакции.

Warning

Если покупатель отредактирует сумму оплаты на странице провайдера, то значение параметра amount в автоматическом уведомлении и в ответе на запрос статуса будет отличаться от значения, отправленного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string blik
customer object Секция информации о покупателе.
first_name * обязательный string Имя покупателя.
last_name * обязательный string Фамилия покупателя.
email * обязательный
 string Адрес электронной почты покупателя.
birth_date * обязательный
 string Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD
country * обязательный string Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AD (Андорра), AT (Австрия), BE (Бельгия), BG (Болгария), HR (Хорватия), CY (Кипр), CZ (Чехия), DK (Дания), EE (Эстония), FI (Финляндия), FR (Франция), DE (Германия), GR (Греция), HU (Венгрия), IS (Исландия), IE (Ирландия), IT (Италия), LV (Латвия), LI (Лихтенштейн), LT (Литва), LU (Люксембург), MT (Мальта), MC (Монако), NL (Нидерланды), NO (Норвегия), PL (Польша), PT (Португалия), RO (Румыния), SM (Сан-Марино), SK (Словакия), SI (Словения), ES (Испания), SE (Швеция), CH (Швейцария), GB (Великобритания). Новые страны регулярно добавляются в список возможных значений.
phone string Номер телефона покупателя без специальных символов.
address string (100) Адрес покупателя.
zip string (6) Почтовый индекс покупателя.
gender string Пол покупателя.
Возможные значения:
male;
female.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 1500,
        "currency": "PLN",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "blik"            
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "email": "test@example.com",
            "birth_date": "01-01-1980",
            "country": "PL"           
        }
    }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "560d9a3b-e2d2-42c1-9992-fc78e21adec2",
    "type": "payment",
    "status": "pending",
    "amount": 1500,
    "currency": "PLN",
    "description": "description",
    "created_at": "2025-01-22T08:27:11Z",
    "updated_at": "2025-01-22T08:27:15Z",
    "method_type": "blik",
    "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/560d9a3b-e2d2-42c1-9992-fc78e21adec2/53016ad33c5c3264d3da2611f8c64e0d002168f3309def82a73e8dd31093e889",
    "payment": {
      "status": "pending",
      "gateway_id": 4870,
      "ref_id": "OR-250122082714139",
      "message": "Transaction was initialized."
    },
    "blik": {
      "type": "blik"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },   
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "widget-ti/g?paytoken=9bce49ac-1ca0-45f3-a81e-44580cf6251a",
      "method": "GET",
      "fields": []
    }
  }
}