У вас есть сайт, CRM-система или онлайн-школа, и вы хотите начать принимать платежи от клиентов. Вы уже знаете, что для этого нужен интернет-эквайринг, но боитесь, что интеграция — это сложно и долго? Что, если я скажу, что весь процесс от создания счета до получения денег можно автоматизировать с помощью нескольких простых HTTP-запросов?
Эта статья — не теоретический обзор, а практическое руководство. Мы по шагам разберем, как с помощью сервиса-оркестратора Chekly.ru и его REST API подключить к вашему проекту прием платежей через ЮKassa и автоматическую отправку чеков через Эвотор.
Для кого эта инструкция?
- Для владельцев бизнеса, которые хотят поставить задачу разработчику и понимать, как устроен процесс.
- Для разработчиков, которые ищут простое и быстрое решение для интеграции платежей и фискализации.
- Для всех, кто устал от ручного выставления счетов и хочет полной автоматизации.
Шаг 0: Что нам понадобится?
- Аккаунт в ЮKassa: Это наш сервис интернет-эквайринга.
- Аккаунт в облачной кассе Эвотор: Для автоматической фискализации чеков по 54-ФЗ.
Шаг 1: Настройка Chekly (5 минут)
Прежде чем писать код, нужно подготовить сам сервис.
- Получаем API-токен. Находим на странице свой персональный токен и копируем его. Он понадобится нам для всех запросов к API.
- Подключаем сервисы. Вводим API-ключи от наших аккаунтов ЮKassa и Эвотор. Для начала можно использовать тестовые ключи (sandbox), чтобы безопасно все отладить.
- Настраиваем HTTP-уведомления в ЮKassa. В личном кабинете ЮKassa нужно указать URL для уведомлений: https://chekly.ru/yookassa/callback. Это критически важный шаг, чтобы Chekly мог автоматически узнавать о статусе платежей.
Все, наша "панель управления" готова. Теперь можно переходить к коду.
Шаг 2: Создаем счет (Invoice) через API
Первое, что нужно сделать — создать "контейнер" для будущей оплаты.
Эндпоинт: POST /api/v1/invoices
Мы отправляем простой POST-запрос, в котором указываем email или телефон клиента. Эти данные Chekly потом использует для отправки фискального чека.
Пример запроса:
curl -X POST "https://chekly.ru/api/v1/invoices" \
-H "Authorization: Bearer <ваш_api_токен>" \
-H "Content-Type: application/json" \
-d '{
"datetime": "2026-01-15T12:00:00Z",
"customer_email": "client@example.com"
}'
Ответ: В ответ мы получим ID созданного счета. Сохраняем его, он понадобится на следующем шаге.
{
"id": 102,
"name": "СЧЕТ/2026/01/001"
}
Шаг 3: Наполняем счет позициями (Invoice Lines)
Теперь нужно добавить в наш счет товары или услуги. Для этого в Chekly есть каталог услуг, который вы можете наполнить через интерфейс или также через API.
Эндпоинт: POST /api/v1/invoice-lines
Мы отправляем запрос, в котором указываем ID счета (из шага 2), ID продукта из каталога и количество.
Пример запроса:
curl -X POST "https://chekly.ru/api/v1/invoice-lines" \
-H "Authorization: Bearer <ваш_api_токен>" \
-H "Content-Type: application/json" \
-d '{
"invoice_id": 102,
"product_id": 1,
"quantity": 1.5
}'
Здесь product_id: 1 — это, например, "Часовая консультация" из вашего каталога.
Шаг 4: Создаем платеж и получаем ссылку на оплату
Когда счет полностью сформирован, мы инициируем создание платежа.
Эндпоинт: POST /api/v1/payments
Отправляем запрос с ID нашего счета и суммой.
Пример запроса:
curl -X POST "https://chekly.ru/api/v1/payments" \
-H "Authorization: Bearer <ваш_api_токен>" \
-H "Content-Type: application/json" \
-d '{
"invoice_id": 102,
"amount": 3000.00
}'
Ответ: И вот она, магия! Chekly обращается к ЮKassa и в ответ возвращает нам готовую ссылку на оплату.
{
"id": 55,
"amount": 3000.00,
"confirmation_url": "https://yoomoney.ru/checkout/payments/v2/contract?orderId=..."
}
Эту ссылку (confirmation_url) вы можете показать клиенту на вашем сайте, отправив его на страницу оплаты, или вставить в кнопку "Оплатить".
Что происходит дальше? (Полный автомат)
На этом ваша работа как разработчика закончена. Дальше Chekly все делает сам:
- Клиент оплачивает счет по ссылке через безопасную форму ЮKassa.
- ЮKassa отправляет HTTP-уведомление на https://chekly.ru/yookassa/callback.
- Chekly получает это уведомление, понимает, что счет оплачен.
- Мгновенно дает команду вашей онлайн-кассе Эвотор сформировать фискальный чек.
- Готовый чек отправляется на email клиента, который вы указали на шаге 2.
Заключение
Как видите, интеграция эквайринга и фискализации — это не так страшно, как кажется. Вместо того чтобы писать сложную логику для взаимодействия с несколькими сервисами, вы используете единое и простое API.
Сервисы-оркестраторы вроде Chekly.ru берут на себя всю рутину, позволяя вам сосредоточиться на логике вашего продукта. Это экономит десятки часов разработки и защищает бизнес от головной боли с соблюдением 54-ФЗ.
