CloudPayments API: Выставить счёт ссылкой на оплату

Сценарий из mcp-everything. Актуально на 2026-10-24.

Оплата без корзины на сайте: отправить клиенту ссылку в мессенджер, по почте или SMS.

Создай счёт: POST /orders/create с Amount, Description, Email и InvoiceId. Чтобы CloudPayments сам отправил ссылку, добавь SendEmail = true (или Phone и SendSms).
В ответе Model.Url — ссылка на страницу оплаты, её можно отправить клиенту самостоятельно.
SuccessRedirectUrl и FailRedirectUrl вернут клиента на твой сайт после оплаты.
Об оплате узнавай из Pay-уведомления: по InvoiceId найди счёт у себя.

curl -X POST https://api.cloudpayments.ru/orders/create \
  -u '<Public ID>:<API Secret>' \
  -H 'Content-Type: application/json' \
  -d '{
        "Amount": 4900.0,
        "Currency": "RUB",
        "Description": "Консультация 24 октября",
        "Email": "client@example.ru",
        "InvoiceId": "INV-305",
        "SendEmail": true,
        "SuccessRedirectUrl": "https://example.ru/paid"
      }'

Базовые URL

Боевой: https://api.cloudpayments.ru

Авторизация

Тип: Basic Auth

HTTP Basic Auth: логин — Public ID, пароль — API Secret. Оба значения есть в личном кабинете. Без заголовка авторизации или с неверными данными API возвращает HTTP 401 Unauthorized. API Secret нужно хранить в защищённом месте.

Параметры передаются методом POST в теле запроса: application/x-www-form-urlencoded («ключ=значение») или application/json. Ответ всегда JSON и содержит как минимум Success и Message.

{ "Success": false, "Message": "Invalid Amount value" }

Методы сценария

POST /orders/create — Создание счёта со ссылкой на оплату

Формирует ссылку на оплату и при необходимости отправляет её плательщику по e-mail, SMS или Viber.

Пример ответа (сокращён):

Параметр	Где	Тип	Обяз.	Описание
`Amount`	body	Number	да	Сумма платежа
`Currency`	body	String	нет	Валюта, по умолчанию RUB
`Description`	body	String	да	Назначение платежа
`Email`	body	String	нет	E-mail плательщика
`RequireConfirmation`	body	Bool	нет	true — двухстадийная схема
`SendEmail`	body	Bool	нет	Отправить письмо со ссылкой
`InvoiceId`	body	String	нет	Номер заказа
`AccountId`	body	String	нет	Идентификатор пользователя
`OfferUri`	body	String	нет	Ссылка на оферту
`Phone`	body	String	нет	Телефон плательщика
`SendSms`	body	Bool	нет	Отправить SMS со ссылкой
`SendViber`	body	Bool	нет	Отправить сообщение в Viber
`CultureName`	body	String	нет	Язык уведомлений
`SubscriptionBehavior`	body	String	нет	Платёж с подпиской: CreateWeekly, CreateMonthly
`SuccessRedirectUrl`	body	String	нет	Редирект при успешной оплате
`FailRedirectUrl`	body	String	нет	Редирект при неуспешной оплате
`JsonData`	body	Json	нет	Данные транзакции, в том числе для онлайн-чека

Пример запроса:

{
    "Amount":10.0,
    "Currency":"RUB",
    "Description":"Оплата на сайте example.com",
    "Email":"client@test.local",
    "RequireConfirmation":true,
    "SendEmail":false
}

Пример ответа:

{
    "Model": {
        "Id": "gASGZVgUN21hcpPF",
        "Number": 2130,
        "Amount": 10.0,
        "Currency": "RUB",
        "Url": "https://orders.cloudpayments.ru/d/gASGZVgUN21hcpPF"
    },
    "Success": true,
    "Message": null
}

Нюансы

Success в ответе показывает только успешность запроса, а не статус транзакции. Статус транзакции смотрят в поле Model.Status или в уведомлениях.
Идемпотентность включается заголовком X-Request-ID с уникальным значением; результат хранится 1 час, новый запрос требует нового значения.
Если в целочисленное поле передать дробное число, ошибки не будет: значение математически округлится.
Токен работает только на том терминале (publicId), где был получен.
Финальный статус оплаты по токену СБП приходит только в Pay- и Fail-уведомлениях, а не в ответе на запрос.
Для ТСП с MCC 4814 обязателен телефон плательщика в Payer.Phone (только цифры, например +71234567890), иначе банки отклоняют операции.
Pay, Fail, Recurrent, Cancel, Confirm, Refund-уведомления повторяются до 100 раз (интервалы 1, 2, 5, 10, 30 минут), если сервер магазина недоступен или ответил кодом, отличным от нуля; таймаут ответа — 30 секунд.
Подлинность уведомлений проверяют по заголовкам X-Content-HMAC и Content-HMAC: HMAC-SHA256 от тела запроса (для GET — от строки параметров) в UTF-8, ключ — API Secret, результат в base64.
Уведомления приходят с адресов 185.98.81.0/28, 87.251.91.160/27, 46.46.175.96/27, 46.46.168.160/27, 162.55.174.97/32, 91.216.178.243/32.
Ответ на Check-уведомление: {"code":0} — принять платёж; коды 10, 11, 12, 13, 20 отклоняют его (неверный InvoiceId, AccountId, сумма, платёж не принят, просрочен).

Другие сценарии

Если этого недостаточно — официальная документация: https://developers.cloudpayments.ru/#api Вся интеграция одним документом: https://mcp-everything.ru/integrations/cloudpayments.md