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

Blik

Общий вариант интеграции

Оплата

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

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

Info

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

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

object
amount
обязательный
 bigInteger
Сумма транзакции в минимальных денежных единицах, например, 5000 (50 PLN).
currency
обязательный
 string
PLN
description
обязательный
 string(255)
Описание заказа.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
language
обязательный
 string
Язык страницы оплаты. Доступные значения: en (английский), pl (польский), ua (украинский) и pt (португальский).
ip
 string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
blik
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
middle_name
 string
Отчество покупателя.
country
 string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
email
 string
Адрес электронной почты покупателя.
phone
 string
Номер телефона покупателя.
city
 string
Город покупателя.
address
 string
Адрес покупателя.
zip
 string
Почтовый индекс покупателя.
birth_date
 string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
Пример запроса 
{
    "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",
          "phone": "0123456789",
          "email": "email@example.com",
          "country": "GB",
          "city": "City",
          "address": "First street, 8",
          "zip": "10115",
          "birth-date": "1990-01-01"                     
        }
    }
}
Ответ

Отправьте покупателя на 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://example/en/checkout?address=TGmEwV1RrNiF9f1Dk7By1Xk8F63P5jcbT1",
      "method": "GET",
      "fields": []
    }
  }
}

Возврат средств

Возвраты поддерживаются вариантами интеграции PG и DC.

Запрос

Отправьте стандартный запрос возврата средств. Сумма возврата не должна превышать сумму родительской транзакции. Для одной транзакции оплаты можно совершить несколько транзакций возврата средств при условии, что сумма возвратов не превышает сумму соответствующей им родительской транзакции.

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

Оплата

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

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

Info

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

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

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