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

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

https://unitpay.money/api?
     method=initPayment 
     params[paymentType]=card
     params[account]=order413 
     params[sum]=100
     params[desc]=description
     params[projectId]=123456
     params[secretKey]=ключ

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

Значение

Описание

paymentType

строка

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

account

строка

Идентификатор абонента в системе партнера (например, логин или email абонента)

sum

число

Сумма платежа в USD

desc

строка

Описание заказа

projectId

число

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

secretKey

строка

Секретный ключ из настроек проекта

Значение 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 обработчика.

Успешный ответ

{
  "result": {
    "message": "Платеж успешно создан.",
    "paymentId": "1400072",
    "receiptUrl": "https://unitpay.money/pay/receipt/111-ab34c22",
    "type": "redirect",
    "redirectUrl": "http://unitpay.ru/pay/redirect/111-ab34c22" 
  }
}

Значение

Описание

message

string

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

paymentId

integer

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

type

string

Тип ответа:

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

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

redirectUrl

string

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

response

string

html код формы

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

invoiceId

string

id счета

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

{"error": {
    "message": "Описание ошибки"
}}

Значение

Описание

message

строка

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

Для взаимодействия с API вы можете использовать библиотеку Unitpay PHP-SDK.

Last updated