Эндпоинты кратко
| Эндпоинт | Авторизация | Назначение |
|---|---|---|
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