Fondy (Flitt) Україна
Картки, Apple/Google Pay, hold (preauth), hosted checkout; UAH/USD/EUR/PLN. Офіційна документація: https://docs.fondy.io/gateway/. Комісія шлюзу: за тарифом Fondy/Flitt (поле fee у callback/статусі).
Доступи
merchant_id і payment key з кабінету: Merchant Settings → Technical.
- Змінні середовища
FONDY_MERCHANT_IDFONDY_SECRET_KEYFONDY_API_BASE (опц.)- Вебхук
POST /webhooks/fondyJSON; signature = sha1(payment_key|значення всіх непорожніх полів, відсортованих за ключем). Відповідь200 OK; інакше Fondy повторює до 24 год.
Що викликає Місток
| Запит | Поля / сенс |
|---|---|
POST https://pay.fondy.eu/api/checkout/url | merchant_id, order_id, order_desc, amount (копійки), currency, response_url, server_callback_url, lifetime, preauth Y/N, signature → checkout_url |
POST /api/status/order_id | order_status, actual_amount, fee, reversal_amount (1018 = Order Not Found → created) |
POST /api/reverse/order_id | повернення |
POST /api/capture/order_id | списання холду |
Статуси
approved → success (preauth без capture → hold) · created → created · processing → processing · declined → failure · expired → expired · reversed → reversed.
Модель Містка: created → processing → (hold →) success | failure | expired | reversed. Замовлення в Shopify отримує оплату лише на success і лише після звірки суми й валюти з нашим записом.
Пісочниця
Тестовий merchant_id 1396424 / ключ «test»; картка 4444 5555 6666 1111 — approve, 4444 1111 6666 5555 — decline.
Обмеження
- order_id/order_desc до 1024 символів
- callback-IP Fondy 54.154.216.60
Не підтверджено живим прогоном
Реалізовано за офіційними доками та SDK; перший прогін на тестових ключах обов’язковий.
- вкладені об’єкти виключено з підпису
- визначення hold через суфікс order_id + capture_status