Создание платежа

Пример запроса (GET):

https://unitpay.ru/api?
     method=initPayment
     params[paymentType]=card
     params[projectId]=123456
     params[sum]=10
     params[account]=example
     params[desc]=description

Обязательные параметры:

paymentType	строка	Код платежной системы, через которую будет идти оплата
projectId	число	ID вашего проекта в системе UnitPay
sum	число	Сумма платежа в рублях (например, 100)
account	строка	Идентификатор абонента в системе партнера (например, логин или email абонента)
desc	строка	Описание заказа

Значение project Id и SECRET KEY проекта можно найти на странице Настройки проекта

Дополнительные параметры оплаты:

currency	строка	Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD итд. Полный список валют). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты
locale	строка	Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя
backUrl	строка	Адрес возврата пользователя с платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта. Примеры: https://redirect.<домен проекта>/?someParams", "https://<домен проекта>/redirect/
resultUrl	строка	Полный URL адрес перехода пользователя после оплаты (например, http://вашсайт.ru), принудительно отправляет плательщика по этому адресу после оплаты. Важно: домен не должен отличаться от домена проекта. Если параметр не задан, то будет использован адрес страницы чека платежа.

Запрос можно выполнить в тестовом режиме. Узнать подробнее

По мере выполнения платежа мы уведомляем платформу магазина о статусе оплаты, последовательно отправляя GET запросы на URL обработчика.

Пример успешного ответа:

Redirect

{
    "result": {
        "type": "redirect",
        "paymentId": 1231231234,
        "message": "Счет успешно выставлен, ожидается оплата",
        "receiptUrl": "https://unitpay.ru/pay/receipt/1231231234-12d1fae123",
        "statusUrl": "https://unitpay.ru/pay/receipt/1231231234-12d1fae123",
        "redirectUrl": "https://unitpay.ru/pay/123456-1fc2f/card?account=test_unitpay&sum=10.00&currency=RUB&signature=d85e744643bbae4dadf49e845a14f5728eaf13b7c533e7cd5277c0531d91cb2c&desc=test_unitpay&hideOtherMethods=true&locale=ru&paymentId=1231231234&hideMenu=true"
    }

message	string	Информация о результате формирования платежа
paymentId	integer	Номер платежа в системе UnitPay
type	string	Тип ответа: redirect — необходимо перенаправить пользователя на адрес, указанные в redirectUrl response - необходимо показать пользователю информацию, указанную в response invoice — счет создан автоматически и направлен плательщику. Дополнительных действий не требуется
redirectUrl	string	URL для переадресации пользователя на шлюз платежной платформы
response	string	html код формы html - необходимо отобразить на странице
invoiceId	string	id счета

Ошибочный ответ

{
    "error": {
        "message": "Не переданы обязательные параметры: account",
        "code": -32602
    }
}

message	string	Информация с описанием ошибки формирования платежа
code	number	Код ошибки

Описание возможных ошибок:

-32000	Неверные параметры авторизации (например, login)
-32602	Ошибочные параметры запроса (запрос написан с ошибкой)
-32603	Внутренняя техническая ошибка