Создание платежа (простой способ)
Создание платежа
GET
https://unitpay.ru/pay/PUBLIC-KEY?sum&account&desc&signature
Для инициализации платежа посредством единой формы оплаты вам достаточно направить пользователя по специальному URL и передать ряд обязательных для оплаты параметров.
Path Parameters
Name | Type | Description |
---|---|---|
sum | number | Сумма платежа. По умолчанию в рублях. См. дополнительный параметр currency. |
account | string | Идентификатор абонента в вашей системе (например email или номер заказа). |
desc | string | Описание заказа. Используется только для информирования при совершении платежа. |
signature | string | Цифровая подпись запроса. Она защищает вас от злоумышленников - подмены описания или стоимости заказа, размещения ссылки на оплату на ресурсах мошенников. Образуется как sha256( account + "{up}" + currency + "{up}" + desc + "{up}" + sum + "{up}" + secretKey), где sha256 - метод хеширования; "{up}" - разделитель параметров в хеш-функции; secretKey - секретный ключ проекта (доступен в личном кабинете); Важно. Если вы не передаете currency на форму оплаты, то этот параметр не должен участвовать в формировании подписи. |
currency | string | Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD итд. Полный список валют: https://help.unitpay.ru/payments/create-payment). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты. |
locale | string | Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя. |
backUrl | string | Адрес возврата пользователя с платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта.
Примеры: |
subscription | string | Допустимые значения: true, false. Используйте данный флаг, если требуется создать подписку по карте плательщика. Идентификатор подписки (subscriptionId) будет передан в методе PAY на ваш обработчик платежа. Использование подписок возможно только после согласования с вашим курирующим менеджером. |
Если вы подключили онлайн-кассу в ЛК, то для формирования чеков необходимо дополнительно передать ряд параметров.
Пример:
Значение PUBLIC KEY и SECRET KEY проекта можно найти на странице Настройки проекта
Пример формирования цифровой подписи:
Метод оплаты по умолчанию
Вы можете определить платежную систему, которая будет использоваться по умолчанию для пользователя. Для этого в конец URL вашей платежной формы (к примеру https://unitpay.ru/pay/demo) добавьте параметр / код_системы, соответствующий буквенному коду платежной системы.
Возврат на сайт магазина
После инициализации оплаты пользователь переходит на страницу чека, где отслеживается статус платежа. При получении успешного либо ошибочного статуса пользователь переходит на сайт партнера по кнопке "В магазин" (поля Fail URL/Success URL в настройках личного кабинета) с GET параметрами:
Значение | Описание | |
account | текст | Идентификатор абонента в системе партнера (например, логин или email абонента) |
paymentId | число | Номер платежа в системе UnitPay |
Если необходимо принудительно редиректить пользователей сразу после успешной оплаты, то воспользуйтесь параметром resultUrl из запроса на создание платежа
Если ваш сайт создан с помощью CMS, ознакомьтесь со списком готовых модулей.
Last updated