For the complete documentation index, see llms.txt. This page is also available as Markdown.

Создание платежа (редирект)

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

GET https://unitpay.ru/api

method              = initPayment
params[paymentType] = card
params[projectId]   = 123456
params[secretKey]   = 1234567890abc1234567890abcd12345
params[sum]         = 10
params[account]     = example
params[desc]        = description

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

paymentType

строка

Код платежной системы, через которую будет идти оплата

projectId

число

ID вашего проекта в системе UnitPay

secretKey

строка

Секретный ключ

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), принудительно отправляет плательщика по этому адресу после оплаты. Важно: домен не должен отличаться от домена проекта. Если параметр не задан, то будет использован адрес страницы чека платежа.

hideOtherMethods

строка

true или false Скрывает окно выбора других способов оплаты

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

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

message

string

Информация о результате формирования платежа

paymentId

integer

Номер платежа в системе UnitPay

type

string

Тип ответа:

redirect — необходимо перенаправить пользователя на адрес, указанные в redirectUrl

response - необходимо показать пользователю информацию, указанную в response invoice — счет создан автоматически и направлен плательщику. Дополнительных действий не требуется

redirectUrl

string

URL для переадресации пользователя на шлюз платежной платформы

response

string

html код формы

html - необходимо отобразить на странице

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

message

string

Информация с описанием ошибки формирования платежа

code

number

Код ошибки

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

-32000

Неверные параметры авторизации (например, login)

-32602

Ошибочные параметры запроса (запрос написан с ошибкой)

-32603

Внутренняя техническая ошибка

Последнее обновление

Это было полезно?