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

Blik

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

Оплата

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

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

Info

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

Запрос

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

object
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
ip
string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
object
Секция информации о покупателе.
first_name
string
Имя покупателя.
last_name
string
Фамилия покупателя.
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"
    },
    "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 в автоматическом уведомлении и в ответе на запрос статуса будет отличаться от значения, отправленного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

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

object
return_url
обязательный
string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
string
blik
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": []
    }
  }
}