Ендпоінти коротко
| Ендпоінт | Авторизація | Призначення |
|---|---|---|
POST /v1/payments | секретний ключ | Створити платіж карткою чи гаманцем |
POST /v1/pay | — | Створити платіж без акаунта (з гаманцем для виплати) |
POST /v1/crypto/payments | секретний ключ | Створити криптоплатіж |
POST /v1/crypto/pay | — | Криптоплатіж без акаунта |
GET /v1/payments/:id | секретний ключ | Статус платежу |
GET /v1/payments | секретний ключ | Список платежів |
GET /v1/providers | — | Способи оплати, доступні для суми й валюти |
GET /v1/crypto/coins | — | Монети, мережі й мінімуми крипто-шлюзу |
GET /v1/currencies | — | Підтримувані фіатні валюти |
Повний довідник з усіма полями, помилками й прикладами — у документації API.
Створення платежу
Передайте суму й валюту; за бажання закріпіть спосіб оплати через provider (наприклад, stripe для карток і Apple Pay, paypal, revolut або transak для UPI). Надішліть покупця на checkout_url.
curl -X POST https://api.utopay.app/v1/payments \
-H "Authorization: Bearer utopay_sk_live_..." \
-H "content-type: application/json" \
-d '{ "amount": 49.90, "currency": "EUR", "description": "Order #1042",
"success_url": "https://shop.example/thanks" }'
# → { "id": "ord_…", "status": "pending",
# "checkout_url": "https://api.utopay.app/pay/ord_…" }
Підтвердження вебхуками
Зареєструйте ендпоінт у кабінеті. UTOPAY надсилає payment.succeeded, payment.underpaid, payment.expired і payment.failed із заголовком x-utopay-signature (HMAC-SHA256 від мітки часу й вихідного тіла запиту). Повтори тривають близько семи годин. Приклади перевірки на Node.js, PHP і Python — у документації з вебхуків.
Варіанти без коду та з мінімумом коду
- Платіжні посилання — створіть посилання в кабінеті й поділіться ним, код не потрібен. Див. платіжні посилання.
- Плагіни для CMS — WooCommerce, WHMCS, OpenCart, PrestaShop, MODX, Easy Digital Downloads, Paid Memberships Pro і Tilda. Див. плагіни.
- Тестовий режим — тестові ключі створюють замовлення без реальних грошей, а статуси можна симулювати з кабінету.
Оновлено · Команда UTOPAY