ZefirPayAPI v2
Поддержка
Разделы документации

Запрос создания платежа

Объект, который передаётся в теле запроса Создание платежа.

{
  "currency": "rub",
  "amount": "1500.00",
  "uuid": "order-1024",
  "shopId": 482193,
  "description": "Оплата заказа №1024",
  "website_url": "https://shop.example.com/orders/1024",
  "language": "ru",
  "client": "buyer@example.com",
  "items": [
    {"description": "Подписка на 1 месяц", "quantity": 1, "price": 1500}
  ],
  "sign": "56ca36a52215141d58343fed155d15786508f182"
}

Поля

ПараметрТипОбязательныйОписание
currencystringдаВалюта платежа. Допустимое значение: rub
amountstringдаОбщая сумма с копейками, например "1500.00". От 10.00 до 300000.00, не больше двух знаков после точки
uuidstringдаНомер заказа в вашей системе, 1–128 символов. Защищает от двойной оплаты одного заказа
shopIdintegerдаID магазина
descriptionstringдаНазначение платежа, 1–1000 символов. Показывается покупателю на странице оплаты
website_urlstringнетАдрес страницы вашего сайта, на которую покупатель вернётся после оплаты. Только http:// или https://
languagestringнетЯзык страницы оплаты: ru
clientstringнетEmail или телефон покупателя, до 255 символов
itemsarrayнетПозиции заказа
signstringдаПодпись запроса: sha1(currency + amount + shopId + секретный_ключ)

Позиция заказа (элемент items)

ПараметрТипОбязательныйОписание
descriptionstringдаНазвание товара или услуги
quantitynumberдаКоличество
pricenumberдаЦена за единицу в рублях

Позиции сохраняются вместе с платежом. Дополнительные поля позиции сохраняются без изменений.