Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия Следущая версия Both sides next revision | ||
wallet_api [2017/07/05 04:58] admin [Порядок работы API] |
wallet_api [2018/03/05 05:41] admin [Порядок работы API] |
||
---|---|---|---|
Строка 4: | Строка 4: | ||
==== Подключение платежной системы Onpay v. 1.0 ==== | ==== Подключение платежной системы Onpay v. 1.0 ==== | ||
- | Для подключения приема платежей необходимо на Вашем сайте или странице в соцсети разместить нашу платежную форму. Это можно сделать в виде простой ссылки или всплывающего модального окна. | + | Для подключения приема платежей необходимо на Вашем сайте или странице в соцсети разместить нашу платежную форму.\\ |
+ | Это можно сделать в виде простой ссылки или всплывающего модального окна. | ||
**Простая ссылка:**\\ | **Простая ссылка:**\\ | ||
Строка 40: | Строка 41: | ||
https://wallet.onpay.ru/#/business_card присутствуют настройки API: | https://wallet.onpay.ru/#/business_card присутствуют настройки API: | ||
- | {{:настройки_api.png?nolink|}} | + | {{:настройки_api_2.png|Настройки API}} |
Логин — это номер телефона, на который зарегистрирован Личный Кабинет.\\ | Логин — это номер телефона, на который зарегистрирован Личный Кабинет.\\ | ||
Строка 54: | Строка 55: | ||
При создании платежа выполняется 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: | Строка 111: | ||
"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) | | ||
| pay_for | string (текст 40 знаков) | Артикул или заказ (например Туфли АА243-17) | | | pay_for | string (текст 40 знаков) | Артикул или заказ (например Туфли АА243-17) | | ||
- | | phone | string (текст 11 цифр) | Телефон плательщика (например 79991111111) | | + | | payer_phone | string (текст 11 цифр) | Телефон плательщика (например 79991111111) | |
| 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 и подпись совпадает, то тогда идут последующие проверки и в случае удачи выполняется перевод.\\ | ||
+ | |||
+ | Перевод на основную сумму можно отменить или принять, перевод комиссии скрыт и принимается при создании. | ||
+ | |||
+ | ==== Пошаговый процесс успешной оплаты ==== | ||
+ | |||
+ | Шаг 1 Клиент вводит свой номер телефона. Шаг пропускается, если телефон плательщика (payer_phone) уже указан в ссылке. | ||
+ | |||
+ | {{:оплата_шаг_1.png?nolink|}} | ||
+ | |||
+ | Шаг 2 Клиент вводит свой пароль от личного кабинета Wallet.Onpay.ru (Минимум 8 символов) | ||
+ | |||
+ | {{:оплата_шаг_2.png?nolink|}} {{:оплата_шаг_2b.png?nolink|}} | ||
+ | |||
+ | Шаг 3 Сообщение об успехе! | ||
+ | |||
+ | {{:оплата_шаг_3.png?nolink|}} | ||