Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия Последняя версия Both sides next revision | ||
wallet_api [2017/07/05 05:19] admin [Пошаговый процесс успешной оплаты] |
wallet_api [2018/05/22 09:15] admin [Пошаговый процесс успешной оплаты] |
||
---|---|---|---|
Строка 4: | Строка 4: | ||
==== Подключение платежной системы 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 - Ключ пользователя | ||
**Параметры запроса:** | **Параметры запроса:** | ||
Строка 92: | Строка 111: | ||
Перевод на основную сумму можно отменить или принять, перевод комиссии скрыт и принимается при создании. | Перевод на основную сумму можно отменить или принять, перевод комиссии скрыт и принимается при создании. | ||
- | ==== Пошаговый процесс успешной оплаты ==== | ||
- | |||
- | Шаг 1 Клиент вводит свой номер телефона. Шаг пропускается, если телефон плательщика (payer_phone) уже указан в ссылке. | ||
- | |||
- | {{:оплата_шаг_1.png?nolink|}} | ||
- | |||
- | Шаг 2 Клиент вводит свой пароль от личного кабинета Wallet.Onpay.ru (Минимум 8 символов) | ||
- | |||
- | {{:оплата_шаг_2.png?nolink|}} {{:оплата_шаг_2b.png?nolink|}} | ||
- | |||
- | Шаг 3 Сообщение об успехе! | ||
- | {{:оплата_шаг_3.png?nolink|}} | ||