smarty-billingДата актуальности: 2026-06-18. Read-only документация.
Справочник REST-эндпоинтов, экспонируемых роутамиsmarty-backend-stable/smarty-billing/routes/.
Все маршруты подключены под префиксом /api/v2 (значение config.rest.api). Полный путь эндпоинта:
/api/v2 + basePath роутера + path createRoute
| Класс запроса | Описание |
|---|---|
AuthRequest |
Требует авторизованную сессию (cookie/token) + валидный аккаунт. |
NoAuthRequest |
Без авторизации (webhook-хуки от платёжных систем). |
BasicRequest |
Базовая авторизация (legacy-хуки). |
Сервис монтирует три дочерних роутера:
| Роутер | Файл | basePath | Описание |
|---|---|---|---|
paymentInit |
paymentInit.js |
/payment |
Инициализация оплаты |
webHooks2checkout |
webhooks2checkout.js |
/2checkout |
Обработчик запросов от 2Checkout |
yandexHook |
yamoneyHooks.js |
/yandex |
Обработчик запросов от Яндекс.Денег |
paymentInit.js)Базовый путь: /api/v2/payment
Описание: "Инициализация оплаты"
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/payment/web |
Auth (не wsapi) | Инициализация оплаты через WEB | body: billing (данные тарифа) |
POST |
/payment/mobile |
Auth (не wsapi) | Инициализация оплаты через мобильное приложение | body: billing (данные тарифа) |
Валидация:
.com / .ru) по hostname запроса.Receipt.factory создаёт обработчик на основе платформы и данных billing.redirect_url (web) или объект order (mobile).webhooks2checkout.js)Базовый путь: /api/v2/2checkout
Описание: "Обработчик запросов от 2Checkout"
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/2checkout/order/:handlerType |
Basic (legacy) | Webhook от 2Checkout (fraud/invoice/refund) | path: handlerType (enum: fraud, invoice, refund); body: данные от 2Checkout |
Логика обработки handlerType:
fraud: если fraud_status === 'fail' -- статус FRAUD.invoice: если invoice_status === 'deposited' -- applyPay; если 'declined' -- статус CANCEL.refund: статус REFUND.| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/2checkout/:billing/:_orderId |
Auth | Проведение оплаты и смена тарифного плана | path: billing (enum: 2coext, paypal), _orderId (ObjectId); query: параметры от 2Checkout |
Примечание: после проведения оплаты перенаправляет на /settings/billing?merchant_order_id=....
yamoneyHooks.js)Базовый путь: /api/v2/yandex
Описание: "Обработчик запросов от Яндекс.Денег"
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/yandex/capture |
NoAuth | Подтверждение оплаты от Яндекс.Денег | body: { object: { id, ... } } |
Логика: валидирует квитанцию, получает информацию о платеже, подтверждает (capture), при необходимости активирует автоплатёж.
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/yamoney/to-capture |
NoAuth | Webhook для перехвата оплаты (to-capture) | body: { object: { id } } |
POST |
/yamoney/track |
NoAuth | Трекинг платежа (создание YaPaymentsHandler) | body: { paymentId, host } |
Валидация track: проверка isValidRequestBody по hash-заголовку.
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/yandex/:billing/:_orderId |
Auth | Перенаправление после оплаты Яндекс.Денег | path: billing, _orderId (ObjectId) |
Примечание: в dev-окружении симулирует capture; в production перенаправляет на smartycrm{.com|.ru}/crm/settings/billing.
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
POST |
/api/v2/payment/web |
Auth | Инициализация оплаты (WEB) |
POST |
/api/v2/payment/mobile |
Auth | Инициализация оплаты (мобильное приложение) |
POST |
/api/v2/2checkout/order/:handlerType |
Basic | Webhook от 2Checkout |
GET |
/api/v2/2checkout/:billing/:_orderId |
Auth | Проведение оплаты 2Checkout |
POST |
/api/v2/yandex/capture |
NoAuth | Подтверждение оплаты Яндекс.Денег |
POST |
/api/v2/yamoney/to-capture |
NoAuth | Webhook to-capture |
POST |
/api/v2/yamoney/track |
NoAuth | Трекинг платежа |
GET |
/api/v2/yandex/:billing/:_orderId |
Auth | Callback после оплаты Яндекс.Денег |