PayU Польща
BLIK, картки, Klarna/PayPo/Twisto, Raty. Офіційна документація: https://developers.payu.com/europe/docs/. Комісія шлюзу: за тарифом PayU.
Доступи
POS id, OAuth client_id/client_secret, second key (MD5) з панелі. Пісочниця secure.snd.payu.com, публічний тестовий POS 300746.
- Змінні середовища
PAYU_POS_IDPAYU_CLIENT_IDPAYU_CLIENT_SECRETPAYU_SECOND_KEYPAYU_SANDBOX- Вебхук
POST /webhooks/payu; заголовокOpenPayu-Signature: sender=…;signature=…;algorithm=MD5|SHA-256, signature = hash(тіло + second_key). Відповідь 200 обов’язкова (PayU повторює до 72 год).
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST /pl/standard/user/oauth/authorize | client_credentials → bearer (кешується, оновлюється при 401) |
POST /api/v2_1/orders | notifyUrl, continueUrl, customerIp, merchantPosId, description, currencyCode, totalAmount (грош), extOrderId, products[], buyer{} → 302 + redirectUri, orderId |
GET /api/v2_1/orders/{id} | статус |
POST /api/v2_1/orders/{id}/refunds · /captures · DELETE /orders/{id} | повернення · списання · скасування |
Статуси
NEW → created · PENDING → processing · WAITING_FOR_CONFIRMATION → hold · COMPLETED → success · CANCELED/REJECTED → failure.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
Пісочниця з публічними ключами в документації; статус hold залежить від налаштування auto-receive на POS.
Обмеження
- PLN, EUR, USD, GBP, CZK, HUF (BLIK/перекази лише PLN/CZK/EUR)
- реєстрація мерчанта вимагає PESEL представника — для нерезидентів через менеджера
Не підтверджено живим прогоном
Реалізовано за офіційними доками та SDK; перший прогін на тестових ключах обов’язковий.
- тіло відповіді /captures
- buyer.phone з «+»