Blik
Вариант интеграции SS
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaynetworkGate запрос оплаты.
- PaynetworkGate присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaynetworkGate высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту `PLN`.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
Параметр | Тип данных | Описание |
---|---|---|
request | object | |
return_url * обязательный |
string | URL, на который будет возвращен покупатель после завершения операции в платёжной системе. |
method | object | Секция параметров способа оплаты. |
type * обязательный |
string | blik |
Пример запроса
{
"request": {
"amount": 5000,
"currency": "PLN",
"description": "description",
"return_url": "https://return.com",
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на 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
.
Оплата
Процесс проведения оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет запрос оплаты в PaynetworkGate.
- PaynetworkGate присылает в ответе секцию
form
с полемaction
, содержащим URL страницы оплаты. - Продавец перенаправляет покупателя на страницу из параметра
form.action
из ответа PaynetworkGate. - Покупатель завершает транзакцию.
- 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": []
}
}
}