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

Blik

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

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет PaynetworkGate запрос оплаты.
  3. PaynetworkGate присылает в ответе торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель завершает платёж.
  6. 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.

Оплата

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaynetworkGate.
  3. PaynetworkGate присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaynetworkGate.
  5. Покупатель завершает транзакцию.
  6. 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": []
    }
  }
}