Создание платежа
https://unitpay.ru/api?
method=initPayment
params[paymentType]=yandex
params[sum]=10.00
params[account]=order413
params[projectId]=1
params[secretKey]=ключ
params[ip]=77.129.27.24
params[resultUrl]=http://вашсайт.ru
params[customerEmail]=Email плательщика
method=initPayment
params[paymentType]=yandex
params[sum]=10.00
params[account]=order413
params[projectId]=1
params[secretKey]=ключ
params[ip]=77.129.27.24
params[resultUrl]=http://вашсайт.ru
params[customerEmail]=Email плательщика
Обязательные параметры:
Значение | Описание | |
paymentType | строка | Код платежной системы, через которую будет идти оплата |
account |
строка | Идентификатор абонента в системе партнера (например, логин или email абонента) |
sum | число | Сумма платежа в рублях (например, 10.00) |
projectId | число | ID вашего проекта в системе UnitPay |
resultUrl | строка | Urlencoded адрес перехода пользователя после оплаты (например, http://вашсайт.ru). Если параметр не задан, то будет использован адрес страницы чека платежа. |
desc | строка | Описание заказа |
ip | строка | IP адрес плательщика |
secretKey | строка | Секретный ключ, доступен в настройках проекта |
Онлайн кассы для юридических лиц РФ:
Значение | Описание | |
customerEmail | строка | Email плательщика |
customerPhone | число | Телефон плательщика в международном формате без "+" |
cashItems | строка | Позиции заказа. Значение данного параметра обязательно должно быть переведено в json и закодировано с помощью base64. Формат позиций параметра: base64_encode(json_encode([["name" => "Хостинг на 1 месяц", "count" => 1, "price" => 10.00]])); |
Параметры в зависимости от типа оплаты:
Значение | Описание | |
phone | число | Телефон с кодом страны (например, 79520000000) |
operator | строка | Буквенный код оператора для SMS-биллинга. Для остальных систем оператор определяется автоматически |
Дополнительные параметры оплаты:
Значение | Описание | |
currency | строка | Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты |
locale | строка | Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя |
backUrl | строка | Адрес возврата пользователя с платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта. Примеры: "https://redirect.<домен проекта>/?someParams", "https://<домен проекта>/redirect/" |
subscription | true/false | Используйте данный флаг, если требуется создать подписку по карте плательщика. Идентификатор подписки (subscriptionId) будет передан в методе PAY на ваш обработчик платежа. Использование подписок возможно только после согласования с вашим курирующим менеджером |
subscriptionId | число | Идентификатор подписки, по которой требуется произвести списание средств. Данный параметр должен быть предварительно получен в методе PAY на ваш обработчик платежа |
Успешный ответ
{"result": { "message": "Платеж успешно создан.", "paymentId": "1400072", "type": "redirect", "redirectUrl": "http://unitpay.ru/pay/redirect/111-ab34c22" }}
Значение | Описание | |
message | строка | Информация о результате формирования платежа |
type | строка | redirect — требуется переадресация на шлюз платежной платформы invoice — счет создан автоматически, оплата производится пользователем посредством личного кабинета платежной системы |
paymentId | число | Номер платежа в системе UnitPay |
redirectUrl | строка | URL для переадресации пользователя на шлюз платежной платформы. Если платеж не требует переадресации, то данный параметр будет отсутствовать |
Ошибочный ответ
{"error": { "message": "Описание ошибки" }}
Значение | Описание | |
message | строка | Информация с описанием ошибки формирования платежа |