Onpay.ru Wiki

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Описание API для кошелька wallet.onpay.ru (Beta)======


==== Подключение платежной системы Onpay  v. 1.0 ====

Для подключения приема платежей необходимо на Вашем сайте или странице в соцсети разместить нашу платежную форму. Это можно сделать в виде простой ссылки или всплывающего модального окна.

**Простая ссылка:**\\
Самый короткий вариант ссылки:\\
https://wallet.onpay.ru/open_form?value=100&recipient_phone=79991111111\\
Обязательные параметры:\\
value=100&recipient_phone=79991111111 (сумма руб. и получатель)\\
Не обязательные параметры:\\
&commissioner_phone=79992222222 - получатель комиссии\\
&payer_phone=79993333333 - плательщик\\
&commission=10 — комиссия в процентах не более 50%\\
&pay_for=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 ====
//(Только если хотите настроить на сайте автоматическую обработку платежей)//

В личном кабинете кошелька Onpay на странице платежной ссылки.\\
https://wallet.onpay.ru/#/business_card присутствуют настройки API:

{{:настройки_api.png?nolink|}}

Логин — это номер телефона, на который зарегистрирован Личный Кабинет.\\
Для включения API нужно указать ключ и ссылку на модуль, взаимодействующий с API на вашем сайте. Эти же логин и ключ нужно указать в модуле.

Ключ — это произвольная строка, при помощи который ваш модуль будет подписывать ответы по API. Вы можете его сгенерировать при помощи кнопки «Изменить».\\
Поле «Ссылка на модуль» будет содержать ссылку на метод API на вашем сайте который будет отвечать на запрос подтверждения проведения перевода.

Ссылка на модуль — это ссылка на модуль на вашем сайте, который будет получать и отвечать на запросы API в формате POST.\\
Внимание! Если вы включили, но не настроили API платежи в Ваш адрес будут отклоняться!

==== Порядок работы API ====

При создании платежа выполняется POST запрос в модуль по ссылке, которая находится в Настройках API в поле "Ссылка на модуль".\\
**Параметры запроса:**

^ Название                                ^ Тип                                        ^ Описание                                            ^
| order_id                                | integer (целое число)                      | Номер ордера в кошельке (например 1234567890)       |
| payer_phone                             | string (текст 11 цифр)                     | Телефон плательщика  (например 79991111111)         |
| value                                   | float (число с двумя знаками после запятой)| Сумма в рублях (например 100.00)                    |
| recipient_phone                         | string (текст 11 цифр)                     | Номер получателя (например 79992222222)             |
| commission (может быть пустым)          | float (число с двумя знаками после запятой)| Комиссия в процентах (например 3 или 3.00)          |
| commissioner_phone (может быть пустым)  | string (текст 11 цифр)                     | Телефон комиссионера (например 79993333333)         |
| pay_for (может быть пустым)             | string (текст 40 знаков)                   | Артикул или заказ (например Туфли АА243-17)         |
| comment (может быть пустым)             | string (текст 40 знаков)                   | Комментарий (например Привезите завтра с 11)        |
| sign                                    | string (текст 32 знака)                    | Подпись (например 9c2c61f27b088b654e7c3194fabe6ab4) |
| timestamp                               | string (Формат %Y-%m-%d %H:%M:%S)          | Дата Время (например 2017-01-01 11:22:33)           |

В качестве подписи используется хэш по алгоритму md5 в шестнадцатеричной системе счисления, по строке:\\
order_id — Номер ордера в кошельке\\
recipient_phone — Номер получателя\\
valye — Сумма\\
user_api_key — Ключ который находиться в настройках API в кошельке\\
"wallet#{order_id}#{recipient_phone}#{value}#{user_api_key}"

Параметры ответа:
^ Название                                ^ Тип                                        ^ Описание                                            ^
| order_id                                | integer (целое число)                      | Номер ордера в кошельке (например 1234567890)       |
| pay_for                                 | string (текст 40 знаков)                   | Артикул или заказ (например Туфли АА243-17)         |
| phone                                   | string (текст 11 цифр)                     | Телефон плательщика  (например 79991111111)         |
| status                                  | string (текст до 20 знаков)                | Статус платежа: 0 — успех, все остальное отмена     |
| sign                                    | string (текст 32 знака)                    | Подпись (например 9c2c61f27b088b654e7c3194fabe6ab4) |
Onpay.ru Wiki

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

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

Инструменты страницы
