Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия | Следущая версия Both sides next revision | ||
api-out [2011/12/18 15:27] admin |
api-out [2011/12/18 15:29] admin |
||
---|---|---|---|
Строка 31: | Строка 31: | ||
\\ | \\ | ||
Для получения баланса сайт пользователя выполняет POST запрос на адрес https://secure.onpay.ru/api/out_mbz со следующими параметрами: | Для получения баланса сайт пользователя выполняет 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" | |
- | operation | + | \\ |
- | строка 'balance' | + | Пример запроса на баланс:\\ |
- | Тип операции | + | POST https://secure.onpay.ru/api/out_mbz HTTP/1.0 |
- | Обязательный параметр, выбирает тип операции | + | operation: balance |
- | merchant | + | merchant: onpay |
- | строка | + | sign: CAFD1A5DD502758EF23851C05511C3AE61DBD3BC |
- | Плательщик | + | \\ |
- | Обязательный параметр, адрес платежной формы сайта в системе Onpay, с которого уйдут деньги | + | \\ |
- | sign | + | Onpay отвечает строкой, содержащей код ошибки (0 - успех), результат операции в текстовом виде, баланс и подписью, образованной из приведенной к верхнему регистру контрольной суммы в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением кода результата, результата, баланса и merchant_psk. В ответе может отсутствовать подпись, если запрос не позволяет идентифицировать мерчанта и получить его PSK. Если операция не успешна, баланса не будет ни в ответе, ни в подписи. Примеры ответов:\\ |
- | строка, SHA1 | + | 0;ОК;10000.0;6949CC86621AC1A9D831C51E65AB3B350DF5EFE1 |
- | Подпись | + | 10;Signature wrong;B31599FC8287A4A21AC79B3F5C69BDC32422A4C4 |
- | Приведенная к верхнему регистру контрольная сумма в шестнадцатиричном виде по алгоритму SHA1 от приведенной к верхнему регистру строки, полученной сложением строк operation, merchant, merchant_psk разделенных точкой с запятой. Пример строки - "balance;onpay;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 | + | |
**Ограничения**\\ | **Ограничения**\\ |