Blik
Общий вариант интеграции
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту `PLN`.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"test": true,
"amount": 1500,
"currency": "PLN",
"language": "en",
"ip": "127.0.0.1",
"description": "description",
"return_url": "https://return.com",
"method": {
"type": "blik"
},
"customer": {
"first_name": "John",
"last_name": "Kohl",
"middle_name": "James",
"external_id": "123abc",
"phone": "0123456789",
"email": "email@example.com",
"country": "GB",
"city": "City",
"address": "First street, 8",
"zip": "10115",
"birth-date": "1990-01-01"
}
}
}
Ответ
Перенаправьте покупателя с помощью данных form из ответа на запрос оплаты.
Пример ответа
{
"transaction": {
"uid": "193d6738-76de-4895-8ba7-bae9f445125d",
"type": "payment",
"status": "pending",
"amount": 1500,
"currency": "PLN",
"description": "description",
"created_at": "2025-01-23T14:01:09Z",
"updated_at": "2025-01-23T14:01:09Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/193d6738-76de-4895-8ba7-bae9f445125d/d7f9bf41df62deb99ce1bc97792e99e7d23fa72f4fef9270525a3a4a793d1e29?language=en",
"payment": {
"status": "pending",
"gateway_id": 4879,
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"email": "test@example.com",
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"test": true,
"language": "en",
"billing_address": {
"email": "test@example.com"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "https://example/en/checkout?address=TGmEwV1RrNiF9f1Dk7By1Xk8F63P5jcbT1",
"method": "GET",
"fields": []
}
}
}
Пример ответа для варианта интеграции PW
{
"transaction": {
"uid": "ca03d661-39fd-46f7-bc05-2593da4596a8",
"type": "payment",
"status": "pending",
"amount": 1000,
"currency": "PLN",
"description": "Order 1234",
"created_at": "2026-10-29T13:27:02Z",
"updated_at": "2026-10-29T13:27:02Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/ca03d661-39fd-46f7-bc05-2593da4596a8/8f2b3d0751f71938b047b824098502f59260180219fcd83e5e404d878262c8cb",
"payment": {
"status": "pending",
"gateway_id": 7644,
"ref_id": "8465086589143191"
},
"blik": {
"type": "blik"
},
"customer": {
"zip": "00-669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "+48500111222",
"address": "Main Street 1",
"country": "PL",
"last_name": "Nowak",
"birth_date": "1990-05-14",
"first_name": "Anna",
"external_id": "customer-1234",
"ip": "203.0.113.10"
},
"manually_corrected_at": null,
"version": 1,
"test": false,
"billing_address": {
"zip": "00-669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "+48500111222",
"address": "Main Street 1",
"country": "PL",
"last_name": "Nowak",
"birth_date": "1990-05-14",
"first_name": "Anna"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "successful"
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"fields": [
{
"name": "data",
"value": "b5633b68-b81c-408a-b7d1-1f2a5a8f2436"
},
{
"name": "invoice_id",
"value": "a6c2af27-7581-40b7-9b9c-f8616f7918f5"
},
{
"name": "nonce",
"value": "5165d637b5b5887498f3dcd62447783c"
},
{
"name": "signature",
"value": "b5e4dc064829b80bfbaa2336c9cb4d65"
},
{
"name": "timestamp",
"value": "1788959232"
}
],
"method": "GET"
}
}
}
Возврат средств
Возвраты поддерживаются вариантами интеграции PW, PG и DC.
Запрос
Отправьте стандартный запрос возврата средств.
Для вариантов интеграции PG и ВС сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.
Для вариата интеграции PW cумма возврата должна быть равна сумме соответствующей транзакции оплаты.
Вариант интеграции MH
Оплата
Процесс оплаты
- Покупатель выбирает Blik в качестве способа оплаты на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель совершает оплату.
- PaySage.io высылает торговцу автоматическое уведомление.
- Торговец отображает покупателю результат оплаты.
Info
Этот вариант интеграции поддерживает только валюту `PLN` и `EUR`.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"description": "description",
"test": true,
"return_url": "https://return.com",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe",
"phone": "17777777777",
"email": "example@example.com",
"country": "PL"
},
"method": {
"type": "blik",
"user_id": "fdsaf345"
}
}
}
Ответ
Секция blik из ответа на запрос будет иметь те же параметры, что были присланы в запросе, а также дополнительную секцию form с необходимыми параметрами, чтобы сформировать веб-форму для осуществления оплаты.
Пример ответа
{
"transaction": {
"uid": "0c317a6e-6484-4d3f-9880-362e44a177b3",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "description",
"created_at": "2024-03-14T12:52:34Z",
"updated_at": "2024-03-14T12:52:34Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/0c317a6e-6484-4d3f-9880-362e44a177b3/c464dc235b72b3cdf5cc5eee22493e13020bf89b1311aca6b9102a1f406a6d1d?language=en",
"payment": {
"status": "pending",
"gateway_id": 3806,
"ref_id": "1710420754629",
"message": "Transaction was initialized",
"rrn": 33761341
},
"blik": {
"user_id": "fdsaf345",
"type": "blik"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "example@example.com",
"country": "PL",
"phone": "17777777777",
"ip": "null"
},
"manually_corrected_at": null,
"message": "Transaction was initialized",
"test": true,
"language": "en",
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"email": "example@example.com",
"country": "PL",
"phone": "17777777777"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "https://mh/v1/paymentpage/1298/1710420754629",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции CA
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 1010,
"currency": "PLN",
"description": "description",
"skip_duplicate_check": true,
"test": false,
"tracking_id": "189",
"notification_url": "https://notification-url",
"return_url": "https://return-url",
"ip": "127.0.0.1",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe",
"country": "PL",
"city": "Warsaw",
"zip": "00-669",
"email": "john@example.com",
"address": "1st Street",
"phone": "17777777777",
"external_id": "123bh7"
},
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "b9265cbb-1a18-4276-ba32-7508a93eec4d",
"type": "payment",
"status": "pending",
"amount": 1010,
"currency": "PLN",
"description": "description",
"created_at": "2026-04-23T13:57:16Z",
"updated_at": "2026-04-23T13:57:16Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/b9265cbb-1a18-4276-ba32-7508a93eec4d/3d8e6b0e0d2a8ef787d70cc3d150496681e7a1b388f4602c36e41e77cb37c673?language=en",
"payment": {
"status": "pending",
"gateway_id": 6539,
"ref_id": "ca096dc9-4924-4b67-869f-2ed3ace1c579",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik",
"use_pending_page": true
},
"customer": {
"zip": "00-669",
"city": "Warsaw",
"email": "john@example.com",
"phone": "17777777777",
"address": "1st Street",
"country": "PL",
"last_name": "Doe",
"first_name": "John",
"external_id": "123bh7",
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 2,
"message": "Transaction was initialized.",
"tracking_id": "189",
"test": false,
"language": "en",
"billing_address": {
"zip": "00-669",
"city": "Warsaw",
"email": "john@example.com",
"phone": "17777777777",
"address": "1st Street",
"country": "PL",
"last_name": "Doe",
"first_name": "John"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "successful"
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"fields": [],
"method": "GET"
}
}
}
Вариант интеграции PFN
Оплата
Этот вариант интеграции поддерживает два сценария оплаты: с передачей BLIK-кода в запросе на оплату и с перенаправлением покупателя на страницу провайдера без передачи кода. Уточните в службе поддержки или у вашего менеджера, какой сценарий доступен для вашего магазина.
Сценарий оплаты с вводом BLIK-кода на странице торговца
- Покупатель инициирует оплату на сайте торговца и вводит 6-значный BLIK-код.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io отправляет ответ со статусом
pending. - Покупатель подтверждает оплату в мобильном приложении банка.
- PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа.
Сценарий оплаты с перенаправлением на страницу провайдера
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "PLN",
"description": "Order description",
"test": false,
"tracking_id": "Tracking-123",
"notification_url": "https://example.com/notification",
"return_url": "https://example.com/return",
"ip": "127.0.0.1",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe",
"birth_date": "1990-01-25",
"email": "john@example.com",
"phone": "48500111222",
"city": "Warsaw",
"address": "Main Str. 1",
"zip": "00669",
"external_id": "123bh7"
},
"method": {
"type": "blik",
"password": "123456"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "0fa0eb13-d58b-4cac-b39a-0fb9604410e6",
"type": "payment",
"status": "pending",
"amount": 100,
"currency": "PLN",
"description": "Order description",
"created_at": "2026-09-30T08:18:04Z",
"updated_at": "2026-09-30T08:18:04Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/0fa0eb13-d58b-4cac-b39a-0fb9604410e6/ba9a1640045b7feca38c200475eb1cf2f16e2f779e0ecaa0111b1b2d2d8d0262?language=en",
"payment": {
"status": "pending",
"gateway_id": 7371,
"ref_id": "665735860496205854",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"zip": "00669",
"city": "Warsaw",
"email": "john@example.com",
"phone": "48500111222",
"address": "Main Str. 1",
"last_name": "Doe",
"birth_date": "1990-01-25",
"first_name": "John",
"external_id": "123bh7",
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"tracking_id": "Tracking-123",
"test": false,
"language": "en",
"billing_address": {
"zip": "00669",
"city": "Warsaw",
"email": "john@example.com",
"phone": "48500111222",
"address": "Main Str. 1",
"last_name": "Doe",
"birth_date": "1990-01-25",
"first_name": "John"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped"
},
"gateway": {
"iframe": false
}
}
}
Вариант интеграции APR
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца и вводит 6-значный BLIK-код.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io отправляет ответ со статусом
pending. - Покупатель подтверждает оплату в мобильном приложении банка.
- PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа.
Info
Этот вариант интеграции поддерживает только валюту PLN.
Запрос
Отправьте запрос оплаты, указав следующие данные:
|
|||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "PLN",
"description": "Заказ 1234",
"return_url": "https://example.com/return",
"customer": {
"external_id": "customer-1234",
"first_name": "Anna",
"last_name": "Nowak",
"birth_date": "1990-01-25",
"email": "anna@example.com",
"phone": "48500111222",
"city": "Warsaw",
"address": "Main Street 1",
"zip": "00669"
},
"method": {
"type": "blik",
"password": "123456"
}
}
}
Ответ
Сначала платёж получает статус pending. Покупатель подтверждает оплату в мобильном приложении банка. Финальный статус придёт в автоматическом уведомлении.
Пример ответа
{
"transaction": {
"uid": "0be95466-c46d-47d8-a1d9-e7570ed65316",
"type": "payment",
"status": "pending",
"amount": 100,
"currency": "PLN",
"description": "Order 1234",
"created_at": "2026-10-02T09:14:27Z",
"updated_at": "2026-10-02T09:14:27Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/0be95466-c46d-47d8-a1d9-e7570ed65316/d5da7a2d71df1bba2fefb78f9bf059a25d42ff8bd14b3cff02fa934c09245342",
"payment": {
"status": "pending",
"gateway_id": 7494,
"ref_id": "30066568314",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"zip": "00669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "48500111222",
"address": "Main Street 1",
"last_name": "Nowak",
"birth_date": "1990-01-25",
"first_name": "Anna",
"external_id": "customer-1234",
"ip": null
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"test": false,
"billing_address": {
"zip": "00669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "48500111222",
"address": "Main Street 1",
"last_name": "Nowak",
"birth_date": "1990-01-25",
"first_name": "Anna"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped"
},
"gateway": {
"iframe": true
}
}
}
Вариант интеграции PPZ
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца и вводит шестизначный BLIK-код.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io отправляет ответ со статусом
pending. - Покупатель подтверждает оплату в мобильном приложении банка.
- PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом платежа. Торговец также может отправить запрос получения статуса транзакции.
Info
Этот вариант интеграции поддерживает только валюту PLN. Минимальная сумма оплаты — 5 PLN.
Запрос
Отправьте запрос оплаты со следующими данными:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"return_url": "https://example.com/return",
"description": "Order 1234",
"ip": "203.0.113.10",
"method": {
"type": "blik",
"password": "123456"
},
"customer": {
"first_name": "Anna",
"last_name": "Nowak",
"email": "anna@example.com",
"external_id": "customer-1234",
"phone": "+48500111222",
"address": "Main Street 1",
"city": "Warsaw",
"zip": "00-669",
"country": "PL"
},
"additional_data": {
"browser": {
"user_agent": "Mozilla/5.0 (iPhone)"
}
}
}
}
Ответ
Сначала платёж получает статус pending. Покупатель подтверждает оплату в мобильном приложении банка. Получите финальный статус из автоматического уведомления или с помощью запроса получения статуса транзакции.
Пример ответа
{
"transaction": {
"uid": "68c9b124-8c36-4cfb-bbba-4b6f39efe30f",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "Order 1234",
"created_at": "2026-10-02T14:59:05Z",
"updated_at": "2026-10-02T14:59:06Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/68c9b124-8c36-4cfb-bbba-4b6f39efe30f/22fd22ec6dedc1d8e83fa0300a749dd4cdfb9bc2d1563b1f502f0f7dc9e6973d",
"payment": {
"status": "pending",
"gateway_id": 7514,
"ref_id": "248797710577",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"zip": "00-669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "+48500111222",
"address": "Main Street 1",
"country": "PL",
"last_name": "Nowak",
"first_name": "Anna",
"external_id": "customer-1234",
"ip": "203.0.113.10"
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"test": false,
"billing_address": {
"zip": "00-669",
"city": "Warsaw",
"email": "anna@example.com",
"phone": "+48500111222",
"address": "Main Street 1",
"country": "PL",
"last_name": "Nowak",
"first_name": "Anna"
},
"additional_data": {
"browser": {
"user_agent": "Mozilla/5.0 (iPhone)"
},
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "skipped"
},
"gateway": {
"iframe": false
}
}
}
Возврат средств
Запрос
Отправьте стандартный запрос возврата средств. Сумма возврата должна быть равна сумме соответствующей транзакции оплаты. Для одной транзакции оплаты возможен только один полный возврат средств.