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

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


api-out

Автоматизация выплат через API

Автоматизация выплат через API
API используется для генерации платежных поручений от имени пользователя Onpay на перевод денег на любой кошелек moybiz.
Для создания заявки на вывод в кошелек moybiz сайт пользователя выполняет POST запрос на адрес https://secure.onpay.ru/api/out_mbz со следующими параметрами:

Поле запроса Тип и возможные значение Назначение Комментарий
operation строка 'pay' Тип операции Обязательный параметр, выбирает тип операции
amount Число с плавающей запятой Сумма Обязательный параметр, сумма перечисления
pay_for строка Назначение платежа Обязательный параметр, назначение платежа, UTF8
recipient строка, e-mail Получатель платежа Обязательный параметр, email получателя платежа, служащий идентификатором в moybiz
merchant строка Плательщик Обязательный параметр, адрес платежной формы сайта в системе Onpay, с которого уйдут деньги
protection строка Код протекции Обязательный параметр - код протекции перевода в кошельке
days число Количество дней протекции Обязательный параметр - количество дней действия протекции
sign строка, SHA1 Подпись Приведенная к верхнему регистру контрольная сумма в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением строк operation, merchant, merchant_psk разделенных точкой с запятой. Пример строки - «balance;onpay;uXeito3jeihe»


Пример запроса на выплату:

POST https://secure.onpay.ru/api/out_mbz HTTP/1.0
operation: pay
amount: 123.0
pay_for: Заказ №170838
recipient: Vasily.Pupkin@mail.ru
merchant: onpay
protection: secret123
days: 30
sign: 402BE2A3753421510F327EFFA82333EEA66F08FE


Onpay отвечает строкой, содержащей код ошибки (0 - успех), результат операции в текстовом виде и подписью, образованной из приведенной к верхнему регистру контрольной суммы в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением кода результата, результата и merchant_psk. В ответе может отсутствовать подпись, если запрос не позволяет идентифицировать мерчанта и получить его PSK. Примеры ответов:

0;ОК;2D9E1AA59520BAC0D74D65ABED1A78A7502654EC
10;Signature wrong;B31599FC8287A4A21AC79B3F5C69BDC32422A4C4
5;Not enough money;949EE6AABC4E449B8D035F91C336747A36B37987



Для получения баланса сайт пользователя выполняет POST запрос на адрес https://secure.onpay.ru/api/out_mbz со следующими параметрами:

Поле запроса Тип и возможные значение Назначение Комментарий
operation строка 'pay' Тип операции Обязательный параметр, выбирает тип операции
merchant строка Плательщик Обязательный параметр, адрес платежной формы сайта в системе Onpay, с которого уйдут деньги
sign строка, SHA1 Подпись Приведенная к верхнему регистру контрольная сумма в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением параметров operation, amount, pay_for, recipient, merchant, protection, days, merchant_psk разделенных точкой с запятой. Здесь merchant_psk - секретный ключ мерчанта, который он вводит в зеленом кабинете. Пример строки - «pay;123.0;Заказ №170838;Vasily.Pupkin@mail.ru;onpay;secret123;30;uXeito3jeihe»


Пример запроса на баланс:

POST https://secure.onpay.ru/api/out_mbz HTTP/1.0
operation: balance
merchant: onpay
sign: CAFD1A5DD502758EF23851C05511C3AE61DBD3BC



Onpay отвечает строкой, содержащей код ошибки (0 - успех), результат операции в текстовом виде, баланс и подписью, образованной из приведенной к верхнему регистру контрольной суммы в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением кода результата, результата, баланса и merchant_psk. В ответе может отсутствовать подпись, если запрос не позволяет идентифицировать мерчанта и получить его PSK. Если операция не успешна, баланса не будет ни в ответе, ни в подписи. Примеры ответов:

0;ОК;10000.0;6949CC86621AC1A9D831C51E65AB3B350DF5EFE1
10;Signature wrong;B31599FC8287A4A21AC79B3F5C69BDC32422A4C4

Ограничения
1. API не будет работать, если у мерчанта не авторизован мобильный телефон. На странице настроек будет предложено авторизовать мобильный телефон, а все элементы управления будут серые.
2. Все изменения в настройках, касающиеся этого API в зеленом кабинете проходят процедуру подтверждения через мобильный телефон мерчанта.
3. Запрос пришел не с IP адреса, указанного в настройках API в Кабинете Продавца
4. Платеж через API подвержен такой же модерации, как и остальные, т.е. лимитам за сутки и лимитам по задержке
5. За 3 ошибки в контрольной сумме, аккаунт блокируется на 30 минут
6. Денег на счету должно быть достаточно
7. Не превышена сумма в 1018 рублей за последние сутки
8. Вывод в выбранную ПС должен быть разрешен мерчанту в синем кабинете

api-out.txt · Последние изменения: 2013/09/19 13:25 — admin