Польша
Платежи BLIK в PLN
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
| Валюта | Код страны | Способ оплаты |
|---|---|---|
PLN | PL | BLIK |
Плательщик перенаправляется на paymentLink, вводит 6-значный код BLIK из банковского приложения и подтверждает платёж в приложении.
amount указывается в польских злотых, не более двух знаков после запятой, например 150.00.
Чем отличается от обычного заказа
Заказ создаётся через стандартный эндпоинт POST /v1/orders. Базовые поля (amount, currency, successUrl, failUrl, callbackUrl и т. д.) такие же, как у обычного заказа; дополнительно к ним передаётся объект customer с данными плательщика.
| Поле | Тип | Описание |
|---|---|---|
customer | object | Данные плательщика. Набор обязательных полей приведён ниже |
Поля объекта customer
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
firstName | string | ✅ Да | Имя |
lastName | string | ✅ Да | Фамилия |
email | string | ✅ Да | Email плательщика |
phone | string | ✅ Да | Телефон в международном формате, например +48 600123456. Номер из 9 цифр без кода страны считается польским |
country | string | ❌ Нет | Страна плательщика, ISO 3166-1 alpha-2 (например, PL) |
Если хотя бы одно из обязательных полей не передано, заказ не создаётся — API отвечает 400 Bad Request со списком недостающих полей.
Пример запроса
{
"purpose": "Payment for order #1234",
"amount": "150.00",
"currency": "PLN",
"externalId": "23456789",
"externalUserId": "437568",
"successUrl": "https://example.com/success",
"failUrl": "https://example.com/fail",
"callbackUrl": "https://example.com/webhooks/payments",
"customer": {
"firstName": "Jan",
"lastName": "Kowalski",
"email": "jan.kowalski@example.com",
"phone": "+48 600123456"
}
}Ответ
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.
Поля объекта заказа
Итоговая сумма может отличаться от запрошенной. В этом случае заказ всё равно переходит в COMPLETED, а amount в объекте заказа обновляется до фактически полученной суммы. Сверьте её с ожидаемой перед выполнением заказа.