Документация API v2.4

Эндпоинты транзакций

Базовый URL для всех запросов к платежному модулю:
https://api.js-only.com/v2/payments

1. Создание платежа (POST)

Инициализирует новую транзакцию. Система автоматически определяет оптимальный маршрут маршрутизации (routing) на основе доступной ликвидности.

POST /payments
{
  "amount": 150000.00,
  "currency": "RUB",
  "destination": "acc_9928341",
  "metadata": {
    "invoice_id": "INV-2023-001"
  }
}
  • Валидация баланса происходит атомарно.
  • Возвращает объект транзакции со статусом PENDING.
Схема потока транзакции от инициации до подтверждения
GET /payments/{id}

Статус транзакции

Получение актуального статуса платежа по его уникальному идентификатору. Полезно для реализации поллинг-механизмов в UI.

Response:
status: "COMPLETED"
POST /payments/{id}/cancel

Отмена платежа

Мгновенная отмена транзакции, находящейся в статусе PENDING. Средства автоматически возвращаются на исходный счет.

Возвращает ошибку 409 Conflict, если транзакция уже выполнена.

Webhooks

Вебхуки уведомлений

Push-уведомления о изменении статуса транзакции. Гарантированная доставка (at-least-once delivery).

Event: payment.completed
Event: payment.failed
50ms Среднее время отклика API
12k+ Запросов в секунду (RPS)
0.01% Процент отказов

Нужна помощь с интеграцией?

Наши инженеры готовы помочь с настройкой вебхуков и тестированием в песочнице (Sandbox).

Открыть песочницу Связаться с поддержкой