CloudPayments: агент для платежей и подписок

CloudPayments — платёжный шлюз с открытым API: платежи, возвраты, подписки, счета и уведомления. Карточка для финансиста, который ведёт платёжный календарь и дебиторку и устал сверять операции вручную.

Шлюз работает по адресу api.cloudpayments.ru, личный кабинет — merchant.cloudpayments.ru. В API есть оплата по криптограмме и по токену карты, подтверждение, отмена и возврат, выплаты, просмотр транзакции, проверка статуса платежа, выгрузка транзакций и претензий за произвольный период, выгрузка токенов, подписки на рекуррентные платежи, создание и отмена счёта, настройки уведомлений. Отдельно описан онлайн-чек и уведомления Check, Pay, Fail, Confirm, Refund, Recurrent и Cancel с проверкой их подлинности.

### Платёжный календарь: сроки и пустые дни

Агент забирает выгрузку транзакций за период и список подписок, ставит ожидаемые списания на даты и показывает дни без поступлений. Отдельно отмечает подписки, у которых подходит к концу срок или исчерпан лимит периодов, и платежи, застрявшие в промежуточном статусе. На выходе календарь, где видно, откуда взялась каждая сумма.

### Поддержка на языке клиента

Агент берёт статус платежа или возврата и готовит ответ клиенту на его языке: что прошло, что в обработке, что вернулось и когда ждать деньги. В API есть раздел локализации, поэтому формулировки не нужно переводить вручную. Отправку ответа подтверждает сотрудник поддержки.

### Просроченные счета: напоминание клиенту

Агент сверяет выставленные счета с фактическими оплатами и собирает список тех, где срок прошёл, а денег нет. По каждому счёту он готовит напоминание с номером, суммой и датой, а неоплаченные и отменённые счета разделяет, чтобы клиенту не уходило лишнее письмо.

Возврат, отмена операции и решение по спорному платежу — только человек: агент показывает операцию и готовит основание, но деньги двигает сотрудник с правами. Также человек решает, стоит ли продлевать подписку клиента.

Нужны public key терминала и api secret: оба лежат в личном кабинете в настройках сайта. Авторизация в API — HTTP Basic, где логин это public key, а пароль — api secret; подойдёт терминал оплаты или выплаты. Хватит одного терминала, чтобы начать сверку.

Не хранит карточные данные и не проводит платёж без вашей команды. Не отменяет операции, если срок отмены уже прошёл. Не обещает, что статус в шлюзе совпадёт с банковской выпиской в ту же минуту: расхождение возможно, и агент его помечает.

Как не задвоить операцию при повторе? В API описан механизм идемпотентности: повторный запрос с тем же признаком не создаёт вторую операцию. Агент пользуется этим правилом, поэтому сбой связи не превращается в двойное списание.

Что делать с уведомлениями от шлюза? Их подлинность проверяется отдельным методом, и агент делает это до того, как положить событие в дело. Если проверка не прошла, событие отбрасывается и попадает в журнал как подозрительное.