Скилл CloudPayments в Aizor: как подключить и автоматизировать платежи и возвраты
Содержание
Коротко. Скилл CloudPayments подключает ИИ-агента Aizor к эквайрингу: проверка статуса платежа, отмена, возвраты, подписки и другие операции API. Для подключения нужны Public ID и API Secret из личного кабинета CloudPayments, в настройках сайта. Новый сайт работает в тестовом режиме, в нём платежи только эмулируются. Стоимость самого API в документации не указана: условия эквайринга определяются договором.
Что даёт скилл CloudPayments в Aizor
По описанию Aizor, скилл даёт приём платежей и эквайринг через CloudPayments API: оплата по криптограмме и токену, двухстадийные платежи, отмена, возвраты, подписки и проверка статуса.
Есть важная оговорка. Криптограмма карты формируется скриптом Checkout на вашем сайте, а агент не должен получать данные чужих карт. Поэтому основная польза для владельца сайта или магазина в другом: проверить статус платежа, подтвердить или отменить платёж, оформить возврат, посмотреть и остановить подписку, выгрузить список операций. Агент описывает такие задачи словами, а вы сверяете результат.
Что понадобится
- Подключённый сайт в личном кабинете CloudPayments.
- Доступ к настройкам сайта, где указаны Public ID и API Secret.
- Приложение Aizor для macOS или Windows и скилл CloudPayments из каталога.
API работает по адресу api.cloudpayments.ru. Параметры передаются методом POST, ответ приходит в формате JSON.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
- Войдите в личный кабинет CloudPayments.
- Откройте настройки нужного сайта.
- Скопируйте Public ID. Он служит логином при HTTP Basic Auth.
- Скопируйте API Secret. Он служит паролем. В документации сказано, что секрет нужно хранить в защищённом месте.
Срок действия пары в документации не указан. Если у вас несколько сайтов, у каждого свой Public ID. Токены карт работают только на терминале (Public ID), на котором получены.
В Aizor установите скилл из каталога и вставьте Public ID и API Secret в его настройки. Список других скиллов: каталог инструкций.
Проверка: первые запросы агенту
- «Проверь, что соединение с CloudPayments работает.» (для этого в API есть тестовый метод
/test) - «Найди платёж по номеру заказа 12345 и скажи его статус.»
- «Покажи список операций за вчера.»
- «Оформи возврат на половину суммы по такой-то транзакции.» Это уже действие с деньгами, делайте его только после проверки.
Сначала работайте в тестовом режиме. Сразу после создания сайта в кабинете он находится в тестовом режиме: платежи и операции идут в режиме эмуляции. В документации даны тестовые карты, например 4242 4242 4242 4242 для успешной оплаты. Срок действия подойдёт любой непросроченный, а код CVV произвольный.
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Ежедневная сводка по операциям
Агент по расписанию выгружает список операций за день и присылает короткий итог: сколько платежей прошло, сколько отклонено. Планировщик описан на странице «Что такое Aizor».
Ответ покупателю о статусе платежа
Покупатель пишет номер заказа, вы пересылаете его агенту, и тот ищет платёж по номеру заказа. Документация отмечает, что отдельная проверка статуса нужна, если при оплате случился сбой и информация потерялась, в обычной работе статус приходит уведомлением.
Отмена и возврат
Агент готовит отмену оплаты или возврат (полный или частичный). Такие действия лучше включать только с ручным подтверждением: ошибка приведёт к реальному движению денег.
Управление подписками
В API есть методы для создания, поиска, изменения и отмены подписок на рекуррентные платежи. Агент может по просьбе найти подписку клиента и показать её параметры. Отмену оставьте под вашим подтверждением.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
| HTTP 401 Unauthorized | Не передан заголовок аутентификации или неверны Public ID и API Secret | Проверьте обе строки в настройках сайта в личном кабинете |
| HTTP 429 Too Many Requests | Больше 5 одновременных запросов на тестовом терминале или 30 на боевом | Дождитесь завершения запросов. Для пересмотра лимита обращаются к персональному менеджеру |
"Success": false и текст в Message | Запрос отклонён, например неверная сумма (Invalid Amount value) | Прочитайте Message и поправьте параметры |
| Платёж «не находится» | Платёж с таким номером заказа не найден (Not found) | Проверьте номер заказа и боевой или тестовый режим сайта |
| Не проходит возврат | Транзакция старше года, возвраты по ним не проводятся | Вопрос решается вне API: уточните порядок в поддержке CloudPayments |
Безопасность
- API Secret даёт доступ к операциям с деньгами. Не пересылайте его в чатах и документах.
- Не давайте агенту номера карт покупателей. Для оплаты картой используется криптограмма от скрипта Checkout, а не данные карты в чате.
- Возвраты, отмены и отмену подписок оставьте под ручным подтверждением в Aizor.
- Сначала проверяйте сценарии в тестовом режиме.
- Если секрет мог стать известен посторонним, смените его в настройках сайта в личном кабинете и обновите в скилле. Порядок смены в документации не описан, при затруднении обратитесь в поддержку CloudPayments.
Инструкция написана по официальной документации CloudPayments (developers.cloudpayments.ru), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
Читайте также
