Инструменты пользователя

Инструменты сайта


wallet_api

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Both sides previous revision Предыдущая версия
Следущая версия
Предыдущая версия
wallet_api [2017/07/05 04:59]
admin [Порядок работы API]
wallet_api [2018/05/22 09:16] (текущий)
admin [Описание API для кошелька wallet.onpay.ru (Beta)]
Строка 1: Строка 1:
-====== Описание API для кошелька wallet.onpay.ru ​(Beta)======+====== Описание API для кошелька wallet.onpay.ru======
  
  
 ==== Подключение платежной системы Onpay  v. 1.0 ==== ==== Подключение платежной системы Onpay  v. 1.0 ====
  
-Для подключения приема платежей необходимо на Вашем сайте или странице в соцсети разместить нашу платежную форму. Это можно сделать в виде простой ссылки или всплывающего модального окна.+Для подключения приема платежей необходимо на Вашем сайте или странице в соцсети разместить нашу платежную форму.\\ 
 +Это можно сделать в виде простой ссылки или всплывающего модального окна.
  
 **Простая ссылка:​**\\ **Простая ссылка:​**\\
-Самый короткий вариант ссылки:\\+Ссылка:\\
 https://​wallet.onpay.ru/​open_form?​value=100&​recipient_phone=79991111111\\ https://​wallet.onpay.ru/​open_form?​value=100&​recipient_phone=79991111111\\
 Обязательные параметры:​\\ Обязательные параметры:​\\
Строка 17: Строка 18:
 &​pay_for=test — наименование заказа\\ &​pay_for=test — наименование заказа\\
 &​comment=test — комментарий\\ &​comment=test — комментарий\\
- 
-Самый короткий вариант ссылки:​\\ 
-https://​wallet.onpay.ru/​open_form?​value=100&​recipient_phone=79991111111\\ 
- 
-**Всплывающее модальное окно:​**\\ 
-Для размещения всплывающего окна, необходимо подключить на сайте разместить скрипт:​\\ 
-//<​script src="​https://​secure.onpay.ru/​scripts/​wallet_frame.js"></​script>//​\\ 
-Далее нужно добавить к обработчику события оплаты (например,​ при нажатии кнопки «Оплатить» на вашем сайте) следующий JS код, указав требуемую сумму, номер телефона получателя платежа и получателя комиссии,​ если таковой имеется. 
- 
-{{:​фрейм_wallet.png?​nolink|}} 
- 
- 
-В случае,​ если вам известен номер телефона плательщика,​ его можно указать на этом шаге. Если номер не известен,​ плательщик введет его во фрейме. Вы можете передать описание товара и комментарий в полях pay_for и comment.\\ 
-Обязательные поля лишь:\\ 
-recipient_phone:​ 79991111111\\ 
-value: 100\\ 
  
 ==== Настройки API ==== ==== Настройки API ====
Строка 40: Строка 25:
 https://​wallet.onpay.ru/#/​business_card присутствуют настройки API: https://​wallet.onpay.ru/#/​business_card присутствуют настройки API:
  
-{{:​настройки_api.png?nolink|}}+{{:​настройки_api_2.png|Настройки API}}
  
 Логин — это номер телефона,​ на который зарегистрирован Личный Кабинет.\\ Логин — это номер телефона,​ на который зарегистрирован Личный Кабинет.\\
Строка 54: Строка 39:
  
 При создании платежа выполняется POST запрос в модуль по ссылке,​ которая находится в Настройках API в поле "​Ссылка на модуль"​.\\ При создании платежа выполняется POST запрос в модуль по ссылке,​ которая находится в Настройках API в поле "​Ссылка на модуль"​.\\
 +
 +Обработка PAY запроса. ​
 +После заполнения данных,​ на URL будет присылаться уведомления при выполнении операций на пополнение баланса.\\
 +Основные операции:​
 +  * Пополнение,​ оплата через форму.
 +  * Перевод от одного пользователя другому.
 +  * Оплата выставленного счета.
 +Отправляется POST запрос с параметрами:​
 +
 +''​{
 +"​order_id"​=>"​15491032",​ \\
 +"​value"​=>"​200.0",​ \\
 +"​recipient_phone"​=>"​79894444444",​ \\
 +"​sign"​=>"​50d757df7ae7b5535100f7e3697ad597",​ \\
 +"​type"​=>"​pay",​ \\
 +"​pay_type"​=>"​payin",​ \\
 +"​payer_phone"​=>"​+79034444444",​ \\
 +"​pay_for"​=>"​79894444444",​ \\
 +"​comment"​=>"​123123123",​ \\
 +"​timestamp"​=>"​2018-02-28 12:43:33 +0300" \\
 +}''​
 +
 +Существует 3 различных типа пополнений.\\
 +pay_type:
 +  - payin - Пополнение
 +  - invoice - Оплатили счёт
 +  - transfer - Перевод
 +
 +Формирование подписи выполняется следующим способом:​\\
 +Хэш MD5 "​wallet#​{order_id}#​{phone}#​{value}#​{user_api_key}"​
 +  - order_id - номер заказа (ордера)
 +  - phone - телефон получателя
 +  - value - сумма пополнения
 +  - user_api_key - Ключ пользователя
 +
 **Параметры запроса:​** **Параметры запроса:​**
  
Строка 75: Строка 95:
 "​wallet#​{order_id}#​{recipient_phone}#​{value}#​{user_api_key}"​ "​wallet#​{order_id}#​{recipient_phone}#​{value}#​{user_api_key}"​
  
-Параметры ответа:​+**Параметры ответа:​**
 ^ Название ​                               ^ Тип ​                                       ^ Описание ​                                           ^ ^ Название ​                               ^ Тип ​                                       ^ Описание ​                                           ^
 | order_id ​                               | integer (целое число) ​                     | Номер ордера в кошельке (например 1234567890) ​      | | order_id ​                               | integer (целое число) ​                     | Номер ордера в кошельке (например 1234567890) ​      |
Строка 82: Строка 102:
 | status ​                                 | string (текст до 20 знаков) ​               | Статус платежа:​ 0 — успех, все остальное отмена ​    | | status ​                                 | string (текст до 20 знаков) ​               | Статус платежа:​ 0 — успех, все остальное отмена ​    |
 | sign                                    | string (текст 32 знака) ​                   | Подпись (например 9c2c61f27b088b654e7c3194fabe6ab4) | | sign                                    | string (текст 32 знака) ​                   | Подпись (например 9c2c61f27b088b654e7c3194fabe6ab4) |
 +
 +Подпись хэш по алгоритму mb5 в шестнадцатеричной системы счисления,​ по строке:​\\
 +"​wallet#​{order_id}#​{phone}#​{status}#​{user_api_key}"​\\
 +
 +Статус 0 в случае успеха,​ любой другой - в случае неудачи.\\
 +Если статус 0 и подпись совпадает,​ то тогда идут последующие проверки и в случае удачи выполняется перевод.\\
 +
 +Перевод на основную сумму можно отменить или принять,​ перевод комиссии скрыт и принимается при создании.
 +
  
  
wallet_api.1499230764.txt.gz · Последние изменения: 2017/07/05 04:59 — admin