Przelewy24 Польща
BLIK, картки, PayPo, Raty, Apple/Google Pay. Офіційна документація: https://developers.przelewy24.pl/. Комісія шлюзу: за тарифом P24 (BLIK/картки ~1,29 % + 0,30 zł).
Доступи
merchantId, posId, CRC, API key (reports) з панелі P24. Пісочниця: sandbox.przelewy24.pl з окремими ключами (P24_SANDBOX=1). Активація 59 zł.
- Змінні середовища
P24_MERCHANT_IDP24_POS_IDP24_CRCP24_REPORT_KEYP24_SANDBOXP24_METHOD (опц.)- Вебхук
POST /webhooks/p24JSON (merchantId, posId, sessionId, amount, originAmount, currency, orderId, methodId, statement, sign); sign = SHA-384 над цими полями + CRC. Basic auth запитів:posId:apiKey.
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST /api/v1/transaction/register | sessionId, amount (грош), currency, description, email, urlReturn, urlStatus, timeLimit, method?; sign = SHA-384(JSON{sessionId, merchantId, amount, currency, crc}) → token → /trnRequest/{token} |
PUT /api/v1/transaction/verify | обов’язкова верифікація після нотифікації — інакше платіж лишається «авансом»; Місток робить її автоматично |
GET /api/v1/transaction/by/sessionId/{id} | статус (0 created, 1 processing, 2 success, 3 reversed) |
POST /api/v1/transaction/refund | refunds[{orderId, sessionId, amount, description}] |
Статуси
Нотифікація приходить лише для успішних платежів; статуси P24 0/1/2/3 → created/processing/success/reversed.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
Пісочниця з тестовими методами; BLIK-коди для тестів видає підтримка P24.
Обмеження
- PLN/EUR/GBP/CZK
- email покупця обов’язковий
- нерезидентні компанії — за погодженням з P24 (офіційно не заборонено, не підтверджено)
Не підтверджено живим прогоном
Реалізовано за офіційними доками та SDK; перший прогін на тестових ключах обов’язковий.
- перелік полів нотифікації та семантика кодів статусів узяті з офіційного OpenAPI через дзеркала — сайт P24 рендериться JS