Blik

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

Оплата

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

Покупатель выбирает Blik в качестве способа оплаты на сайте торговца.
Торговец отправляет PaySage.io запрос оплаты.
PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
Торговец перенаправляет покупателя на страницу оплаты.
Покупатель совершает оплату.
PaySage.io высылает торговцу автоматическое уведомление.
Торговец отображает покупателю результат оплаты.

Info

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

Запрос

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

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
user_id * обязательный	string	Уникальный идентификатор покупателя в системе торговца.
customer	object	Секция информации о покупателе.
first_name * обязательный	string	Имя покупателя.
last_name * обязательный	string	Фамилия покупателя.
email * обязательный	string	Адрес электронной почты покупателя.
phone * обязательный	string	Номер телефона покупателя с кодом страны и без специальных символов.
country * обязательный	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `PL`.

Пример запроса

{
  "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	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
customer	object	Секция информации о покупателе.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
middle_name	string	Отчество покупателя.
email	string	Адрес электронной почты покупателя.
country	string	Страна покупателя в формате в ISO 3166-1 alpha-2 формате. Всегда `PL`.
city	string	Город покупателя.
address	string	Адрес покупателя.
zip	string	Почтовый индекс покупателя.
birth_date	string	Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).

Пример запроса

{
    "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	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
language * обязательный	string	Язык страницы оплаты. Доступные значения: `en` (английский), `pl` (польский), `ua` (украинский) и `pt` (португальский).
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
customer	object	Секция информации о покупателе.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
email	string	Адрес электронной почты покупателя.
phone	string	Номер телефона покупателя.
city	string	Город покупателя.
address	string	Адрес покупателя.
zip	string	Почтовый индекс покупателя.

Пример запроса

{
    "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	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
ip	string	IP-адрес покупателя.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
customer	object	Секция информации о покупателе.
first_name * обязательный	string	Имя покупателя.
last_name * обязательный	string	Фамилия покупателя.
email	string	Адрес электронной почты покупателя.
phone	string	Номер телефона покупателя.
city	string	Город покупателя.
address	string	Адрес покупателя.
zip	string	Почтовый индекс покупателя.
birth_date	string	Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).

Пример запроса

{
    "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	object
amount * обязательный	bigInteger	Сумма транзакции в минимальных денежных единицах, например, 5000 (50 PLN).
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method	object	Секция параметров способа оплаты.
type * обязательный	string	`blik`
ip	string	IP-адрес покупателя.
customer	object	Секция информации о покупателе.
country	string	Страна покупателя в формате ISO 3166-1 alpha-2. Например, `PL`.
phone	string	Номер телефона покупателя.
email	string	Адрес электронной почты покупателя.
first_name	string	Имя покупателя.
last_name	string	Фамилия покупателя.
city	string (120)	Город покупателя.
zip	string (40)	Почтовый индекс покупателя.
state	string	Двухбуквенная аббревиатура штата, если страна покупателя `US`, `CA` или `IN`.
address	string (510)	Адрес покупателя.

Пример запроса

{
    "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"
                }
            ]
        }
    }
}