Blik
Вариант интеграции 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": []
}
}
}
Вариант интеграции PR
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель вводит код Blik на странице оплаты и совершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту `PLN`.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"test": true,
"amount": 5000,
"currency": "PLN",
"description": "description",
"return_url": "https://return.com",
"language": "en",
"customer": {
"email": "example@example.com"
},
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"transaction": {
"uid": "17686da0-0ac6-424d-9aa7-a911d2fe507c",
"type": "payment",
"status": "pending",
"amount": 5000,
"currency": "PLN",
"description": "description",
"created_at": "2024-09-23T09:38:51Z",
"updated_at": "2024-09-23T09:38:51Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/17686da0-0ac6-424d-9aa7-a911d2fe507c/8010d8d1ac2064c99f189cb1edd651cb38b82e4c26a921d297eead385b5662ad?language=en",
"payment": {
"status": "pending",
"gateway_id": 4498,
"ref_id": "17686da0-0ac6-424d-9aa7-a911d2fe507c",
"message": "Transaction was initialized",
"bank_code": 0,
"rrn": "HPI00000000780H6"
},
"blik": {
"type": "blik"
},
"customer": {
"email": "example@example.com",
"ip": null
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized",
"test": true,
"language": "en",
"billing_address": {
"email": "example@example.com"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": true
},
"form": {
"action": "https://checkout.pr.io/payment/414c8d6e-29a5-4c76-865c-0877dab5d99a/efc015be911369924d55c91a5d8651dbdadf1ffd307e13f18e1fef992c6014a2",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции OX
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту `PLN`.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"test": true,
"amount": 1500,
"currency": "PLN",
"language": "en",
"description": "description",
"return_url": "https://return.com",
"method": {
"type": "blik"
},
"customer": {
"email": "test@example.com"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"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://ox/en/checkout?address=TGmEwV1RrNiF9f1Dk7By1Xk8F63P5jcbT1",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции DC
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN
.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"description": "description",
"test": true,
"return_url": "https://return.com",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe"
},
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"transaction": {
"uid": "61eb915c-90e9-45a6-bb1b-bce0980785fb",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "description",
"created_at": "2025-04-08T14:05:14Z",
"updated_at": "2025-04-08T14:05:14Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/61eb915c-90e9-45a6-bb1b-bce0980785fb/d348151ff49193e013684b1a69fe2d3e221618806499e83a5b46771020ee2b6a?language=en",
"payment": {
"status": "pending",
"gateway_id": 5220,
"ref_id": "d45d8a3c80d0d6bda403",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"test": true,
"language": "en",
"billing_address": {
"first_name": "John",
"last_name": "Doe"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"method": "GET",
"fields": []
}
}
}
Возврат средств
Запрос
Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.
Вариант интеграции TW2
Описание процесса оплаты
- Покупатель инициирует оплату на странице торговца.
- Торговец отправляет запрос оплаты в PaySage.io.
- PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
- Торговец перенаправляет покупателя на форму для завершения оплаты.
- Покупатель завершает оплату.
- PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.
Info
Этот вариант интеграции поддерживает только валюту PLN
.
Оплата
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"amount": 101,
"currency": "PLN",
"description": "test",
"test": false,
"tracking_id": "your_uniq_number21212",
"return_url": "https://your-success.url",
"method": {
"type": "blik"
}
}
}
Ответ
Создайте HTML-форму, используя параметры из секции form
. Отправьте покупателя на форму для завершения оплаты.
Пример ответа
{
"transaction": {
"uid": "c0fd532c-60e8-40a1-8850-8a365fc92420",
"type": "payment",
"status": "pending",
"amount": 101,
"currency": "PLN",
"description": "test",
"created_at": "2025-04-08T15:36:11Z",
"updated_at": "2025-04-08T15:36:11Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/c0fd532c-60e8-40a1-8850-8a365fc92420/de40d20b52c6b4a911df577a53f0da18ad412a92e8e75ae67cc22262ef3a1afb",
"payment": {
"status": "pending",
"gateway_id": 5236,
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number21212",
"test": false,
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-url",
"method": "POST",
"fields": [
{
"name": "memberId",
"value": "14363",
"type": "hidden"
},
{
"name": "terminalid",
"value": "8162",
"type": "hidden"
},
{
"name": "checksum",
"value": "e86d209a3efe8ffea3a727209f3ae856",
"type": "hidden"
},
{
"name": "merchantTransactionId",
"value": "c0fd532c-60e8-40a1-8850-8a365fc92420",
"type": "hidden"
},
{
"name": "amount",
"value": "1.01",
"type": "hidden"
},
{
"name": "currency",
"value": "PLN",
"type": "hidden"
},
{
"name": "paymentBrand",
"value": "BLIK",
"type": "hidden"
},
{
"name": "paymentMode",
"value": "EW",
"type": "hidden"
},
{
"name": "orderDescription",
"value": "test",
"type": "hidden"
},
{
"name": "country",
"value": "PL",
"type": "hidden"
},
{
"name": "merchantRedirectUrl",
"value": "https://api.paysage.io/beyag/transactions/returns/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/c0fd532c-60e8-40a1-8850-8a365fc92420",
"type": "hidden"
},
{
"name": "notificationUrl",
"value": "https://api.paysage.io/beyag/transactions/notifications/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/c0fd532c-60e8-40a1-8850-8a365fc92420",
"type": "hidden"
},
{
"name": "totype",
"value": "TransactWorld",
"type": "hidden"
}
]
}
}
}
Вариант интеграции PG
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN
.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"description": "description",
"test": true,
"return_url": "https://return.com",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe"
},
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"transaction": {
"uid": "61eb915c-90e9-45a6-bb1b-bce0980785fb",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "description",
"created_at": "2025-04-08T14:05:14Z",
"updated_at": "2025-04-08T14:05:14Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/61eb915c-90e9-45a6-bb1b-bce0980785fb/d348151ff49193e013684b1a69fe2d3e221618806499e83a5b46771020ee2b6a?language=en",
"payment": {
"status": "pending",
"gateway_id": 5220,
"ref_id": "d45d8a3c80d0d6bda403",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"test": true,
"language": "en",
"billing_address": {
"first_name": "John",
"last_name": "Doe"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"method": "GET",
"fields": []
}
}
}
Возврат средств
Запрос
Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.
Вариант интеграции CR
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты. Время жизни ссылки – 60 минут.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN
.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"description": "description",
"test": true,
"ip": "127.0.0.1",
"return_url": "https://return.com",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe",
"country": "PL",
"email": "john@example.com",
"city": "Warsaw",
"zip": "00-669",
"address": "Main Str. 1"
},
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"transaction": {
"uid": "5f2f5ddf-b633-4de3-a135-61cd220c4501",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "fghffhfg",
"created_at": "2025-05-12T07:22:05Z",
"updated_at": "2025-05-12T07:22:05Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/5f2f5ddf-b633-4de3-a135-61cd220c4501/115a2d5441cad15fb54c73a06e54cd092d8542f9531a462c5dd5736a5ea35122?language=en",
"payment": {
"status": "pending",
"gateway_id": 5345,
"ref_id": "296",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"first_name": "John",
"last_name": "Doe",
"email": "john@example.com",
"country": "PL",
"city": "Warsaw",
"zip": "00-669",
"address": "Main Str. 1",
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"billing_address": {
"first_name": "John",
"last_name": "Doe",
"email": "john@example.com",
"country": "PL",
"city": "Warsaw",
"zip": "00-669",
"address": "Main Str. 1"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"method": "GET",
"fields": []
}
}
}
Вариант интеграции GW2
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель вводит запрашиваемые данные на сайте оплаты и завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту PLN
.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
Пример запроса
{
"request": {
"amount": 500,
"currency": "PLN",
"description": "description",
"tracking_id": "your_uniq_number",
"test": true,
"return_url": "https://return.com",
"language": "en",
"method": {
"type": "blik"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action
.
Пример ответа
{
"transaction": {
"uid": "6baa3e8d-d907-457f-b759-6e973b0d9c53",
"type": "payment",
"status": "pending",
"amount": 500,
"currency": "PLN",
"description": "description",
"created_at": "2025-07-23T12:37:05Z",
"updated_at": "2025-07-23T12:37:25Z",
"method_type": "blik",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/6baa3e8d-d907-457f-b759-6e973b0d9c53/5a634a2aaa3183e28e58d61107671d874980aecf82fb20f12eccc0238ace20dd?language=en",
"payment": {
"status": "pending",
"gateway_id": 5602,
"ref_id": "33251",
"message": "Transaction was initialized."
},
"blik": {
"type": "blik"
},
"customer": {
"email": null,
"ip": "null"
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "payment-page",
"fields": [],
"method": "GET"
}
}
}