CloudPayments API: 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
}

Базовые 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" }

Нюансы

• 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