Здесь показаны различия между двумя версиями данной страницы.
| Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия | ||
|
wallet_api [2017/07/05 05:05] 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 - Ключ пользователя | ||
| **Параметры запроса:** | **Параметры запроса:** | ||
| Строка 90: | Строка 109: | ||
| Если статус 0 и подпись совпадает, то тогда идут последующие проверки и в случае удачи выполняется перевод.\\ | Если статус 0 и подпись совпадает, то тогда идут последующие проверки и в случае удачи выполняется перевод.\\ | ||
| - | Перевод на основную сумму можно отменить или принять, перевод с комиссией скрыт и принимается при создании. | + | Перевод на основную сумму можно отменить или принять, перевод комиссии скрыт и принимается при создании. |
| + | |||
| + | |||