LiqPay Україна
Картки, Privat24, Apple/Google Pay, hold. Офіційна документація: https://www.liqpay.ua/documentation/api. Комісія шлюзу: 1,5 % (тариф LiqPay).
Доступи
public_key та private_key з кабінету LiqPay. Пісочниця — sandbox: 1 (LIQPAY_SANDBOX=1), тестові картки з документації.
- Змінні середовища
LIQPAY_PUBLIC_KEYLIQPAY_PRIVATE_KEYLIQPAY_SANDBOX=0|1- Вебхук
POST /webhooks/liqpay, form-urlencodeddata+signature; signature = base64(SHA1(private_key + data + private_key)).
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
GET https://www.liqpay.ua/api/3/checkout?data&signature | hosted-сторінка; data = base64(JSON{version:3, action: pay|hold, amount, currency, order_id, description, result_url, server_url, language: uk, expired_date, sandbox}) |
POST /api/request (action=status) | статус платежу |
POST /api/request (action=refund) | повернення (сума в грн) |
POST /api/request (action=hold_completion) | списання холду |
Статуси
success/sandbox → success · hold_wait → hold · reversed → reversed · failure/error → failure · processing/wait_accept/3ds_verify/otp_verify/… → processing · expired → expired.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
LIQPAY_SANDBOX=1 — платежі з позначкою sandbox, гроші не рухаються.
Обмеження
- UAH/USD/EUR
Не підтверджено живим прогоном
Реалізовано за офіційними доками та SDK; перший прогін на тестових ключах обов’язковий.
- поточна документація згадує sha3-256 у прозі, але всі приклади та SDK використовують sha1 для version 3 — реалізовано sha1