Эндпоинты транзакций
Базовый URL для всех запросов к платежному модулю:
https://api.js-only.com/v2/payments
1. Создание платежа (POST)
Инициализирует новую транзакцию. Система автоматически определяет оптимальный маршрут маршрутизации (routing) на основе доступной ликвидности.
{
"amount": 150000.00,
"currency": "RUB",
"destination": "acc_9928341",
"metadata": {
"invoice_id": "INV-2023-001"
}
}
- ✓ Валидация баланса происходит атомарно.
-
✓ Возвращает объект транзакции со статусом
PENDING.
Статус транзакции
Получение актуального статуса платежа по его уникальному идентификатору. Полезно для реализации поллинг-механизмов в UI.
status: "COMPLETED"
Отмена платежа
Мгновенная отмена транзакции, находящейся в статусе PENDING. Средства автоматически возвращаются на исходный счет.
Возвращает ошибку 409 Conflict, если транзакция уже выполнена.
Вебхуки уведомлений
Push-уведомления о изменении статуса транзакции. Гарантированная доставка (at-least-once delivery).
Event: payment.failed
Нужна помощь с интеграцией?
Наши инженеры готовы помочь с настройкой вебхуков и тестированием в песочнице (Sandbox).