Unitpay
ru
ru
  • Главная
  • Начало работы
    • Регистрация
    • Добавление проекта
      • Добавление сообщества VK
      • Добавление канала / супергруппы Telegram
    • Модерация проекта
      • Помощник по модерации
    • Перенос проекта
  • Платежи
    • Создание платежа (простой способ)
    • Создание платежа
    • Создание платежа (виджет)
    • Создание ссылок на оплату в личном кабинете
    • Обработчик платежа
    • Информация о платеже
    • Возврат платежа
    • Двухстадийные платежи (платежи с преавторизацией)
    • Подписки API
      • Создание подписки
      • Получение списка активных подписок
      • Получение информации о подписке
      • Закрытие подписки
  • Массовые выплаты
    • Создание выплаты
    • Информация о выплате
    • Информация о карте по BIN
    • Информация о комиссии на выплаты
    • Дополнительно: выплаты на основе CSV-реестра
    • Автовыплаты
  • Онлайн-кассы
    • Юнит.Чеки
    • Подключение Онлайн-кассы
    • Параметры для формирования чека
    • Типы позиций для формирования чека
    • Просмотр чека
    • Чек зачета аванса
  • Готовые модули
    • Unitpay SDK
    • Базовый обработчик платежа
    • CMS модули
      • 1C Bitrix
      • Amiro CMS
      • AmoCRM
      • BILLmanager
      • Bitrix24
      • CMS NWICODE
      • CMS-S3
      • CS-Cart
      • DIAFAN.CMS
      • Drupal 8, 9 (commerce)
      • Drupal 7 (ubercart 3)
      • Drupal 7 (commerce)
      • Ecwid от Lightspeed
      • HostCMS
      • InSales
      • Joomshopping 4 (joomla 3)
      • LogicBoxes
      • MODX (miniShop2)
      • Magento
      • Magento 2
      • Netcat CMS
      • OpenCart
      • osCommerce
      • PHPShop
      • Prestashop
      • RetailCRM
      • ReadyScript
      • SellerGames
      • Senler
      • Simpla
      • ShopCMS
      • Tilda
      • Taplink
      • UMI.CMS
      • UCoz
      • VamShop 2
      • Virtuality CMS
      • VirtueMart 3 (joomla 3)
      • Webasyst Shop Script 7 (8)
      • Wix
      • Zen Cart
  • Личный кабинет
    • Telegram бот
    • Инструкция по интерфейсу
      • Регистрация юридических лиц
      • Новый проект и модерация
      • Настройка проекта и прием платежей
      • Подключение стран
      • Выплаты
      • Онлайн-кассы и «Юнит.Чеки»
      • Документы и отчетность
      • Роли и сотрудники
    • Пакет документов для ИП
    • Пакет документов для ООО
    • Смена расчётного счета для выплат
    • Подключение PayPal
    • Текущий баланс (API)
    • Комиссии проекта (API)
    • Курсы конвертации валют (API)
    • Способы оплаты на проекте (API)
  • Справочник
    • IP адреса системы
    • Внешний вид формы оплаты
    • Статусы и ошибки платежей
    • Коды операторов
    • Коды платежных систем
    • Получение справочника банков-участников СБП (API)
    • Буквенные коды валют
  • Реферальная программа
    • Интерфейс кабинета реферера (агента)
  • Другие возможности
    • Использование тестового API
    • Получение информации по БИН
    • Темная тема
  • Служба поддержки
  • FAQ
    • Как перейти на ИП с физического лица
    • Регистрация юр. лица или ИП
    • Модерация проекта
    • Интеграция платежного решения
    • Прием платежей
    • Возврат платежей
    • Выплаты юр. лицам
    • Неттинг
    • Подключение стран для оплаты банковской картой
    • Массовые выплаты
    • Оплата по ссылке
    • Тарифы и лимиты
    • Онлайн-кассы
    • Юридические вопросы
    • Чеки
  • Обновления
Powered by GitBook
On this page

Was this helpful?

  1. Платежи

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

PreviousСоздание платежа (простой способ)NextСоздание платежа (виджет)

Last updated 8 months ago

Was this helpful?

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

https://unitpay.ru/api?
     method=initPayment 
     params[paymentType]=card
     params[account]=order413 
     params[sum]=100.00
     params[desc]=description
     params[projectId]=123456
     params[secretKey]=ключ
     params[cashItems]=значение
     params[customerEmail]=Email плательщика

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

Значение

Описание

paymentType

строка

account

строка

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

desc

строка

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

sum

число

Сумма платежа в рублях (например, 10.00)

projectId

число

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

secretKey

строка

Секретный ключ, доступен в настройках проекта

Если вы используете онлайн кассу, в ссылку на оплату необходимо передавать обязательные параметры. Подробнее в этой .

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

Значение

Описание

currency

строка

locale

строка

Принудительное указание языка платежной формы, допустимые значения: ru, en. По умолчанию язык формы определяется исходя из страны, к которой относится IP адрес пользователя

ip

строка

IP адрес плательщика

resultUrl

строка

backUrl

строка

Адрес возврата пользователя с платежной формы без совершения покупки, по умолчанию используется адрес проекта. В адресе обязательно должен использоваться домен проекта. Примеры: "https://redirect.<домен проекта>/?someParams", "https://<домен проекта>/redirect/"

subscription

true/false

Используйте данный флаг, если требуется создать подписку по карте плательщика. Идентификатор подписки (subscriptionId) будет передан в методе PAY на ваш обработчик платежа. Использование подписок возможно только после согласования с вашим курирующим менеджером

subscriptionId

число

Идентификатор подписки, по которой требуется произвести списание средств. Данный параметр должен быть предварительно получен в методе PAY на ваш обработчик платежа

preauth

true/false

Используйте этот флаг для создания платежа с преавторизацией, по умолчанию флаг выключен и значение равно 0

preauthExpireLogic

число

Поле для логики блокировки платежей с преавторизацией 0 - При отсутствии запроса на подтверждение или отмену, платеж по истечении срока блокировки на стороне банка-эквайера (~114 часов после создания платежа) будет подтвержден 1 - При отсутствии запроса на подтверждение или отмену, платеж по истечении срока блокировки на стороне банка-эквайера (~114 часов после создания платежа) будет отменен. Если параметр не будет использован, платеж будет отменен по истечении срока.

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

{
  "result": {
    "message": "Платеж успешно создан.",
    "paymentId": "1400072",
    "receiptUrl": "https://unitpay.ru/pay/receipt/111-ab34c22",
    "type": "redirect",
    "redirectUrl": "http://unitpay.ru/pay/redirect/111-ab34c22" 
  }
}
{
  "result": {
    "message": "Платеж успешно создан.",
    "paymentId": "1400072",
    "receiptUrl": "https://unitpay.money/pay/receipt/111-ab34c22",
    "type": "response",
    "response": "<form>...</form>" 
  }
}
{
  "result": {
    "message": "Платеж успешно создан.",
    "paymentId": "1400072",
    "receiptUrl": "https://unitpay.money/pay/receipt/111-ab34c22",
    "type": "response",
    "response": {
      "success": 1,
      "orderId": "123",
      "appleResponse": {
        /* объект */
      },
      "approveUrl": "url"
    }
  }
}
{
  "result": {
    "message": "Платеж успешно создан.",
    "paymentId": "1400072",
    "receiptUrl": "https://unitpay.money/pay/receipt/111-ab34c22",
    "type": "invoice",
    "invoiceId": "123" 
  }
}

Значение

Описание

message

string

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

paymentId

bigint

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

receiptUrl

string

Ссылка на чек Примечание: возвращается, если подключена касса Юнит.Чеки, Атол или e-comm.

type

string

Тип ответа:

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

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

redirectUrl

string

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

response

string

html код формы, а если ApplePay, то json

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

json - необходимо направить пользователя по approveUrl

invoiceId

string

id счета

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

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

Значение

Описание

message

строка

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

, через которую будет идти оплата

Валюта заказа по стандарту ISO 4217 (RUB, UAH, BYN, EUR, USD итд. ). Если платежная система не поддерживает требуемую валюту, то сумма будет сконвертирована в валюту системы оплаты

Полный URL адрес перехода пользователя после оплаты (например, ) Важно: домен не должен отличаться от домена проекта. Если параметр не задан, то будет использован адрес страницы чека платежа.

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

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

В ответе на запрос ссылка будет создана с параметрами . Поскольку запрос формируется на конкретный метод оплаты (paymentType) и не подразумевает переключения на другие методы из сформированной ссылки.

Если ваш сайт создан с помощью CMS, ознакомьтесь со списком . Для взаимодействия с API вы можете использовать библиотеку .

статье
отправляя GET запросы на URL обработчика
Узнать подробнее
hideMenu, hideOtherMethods
готовых модулей
Unitpay PHP-SDK
Код платежной системы
Полный список валют
http://вашсайт.ru