Здесь показаны различия между двумя версиями данной страницы.
Следущая версия | Предыдущая версия Следущая версия Both sides next revision | ||
description_of_the_old_api [2014/10/20 07:14] admin создано |
description_of_the_old_api [2015/01/29 11:06] admin |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ======Описание запросов====== | + | ========API 1.0======== |
- | ====check запрос==== | + | ========Описание запросов======== |
+ | |||
+ | ======Сheck запрос====== | ||
+ | |||
+ | ====Запрос к мерчанту==== | ||
На URL отправляется Post запрос со следующими параметрами: | На URL отправляется Post запрос со следующими параметрами: | ||
Строка 25: | Строка 29: | ||
md5=* | md5=* | ||
+ | ====Ответ мерчата==== | ||
Сервер магазина на check-запрос возвращает следующие данные: | Сервер магазина на check-запрос возвращает следующие данные: | ||
Строка 39: | Строка 44: | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
<result> | <result> | ||
- | <code><code>0</code></code> | + | <code>0</code> |
<pay_for>123456</pay_for> | <pay_for>123456</pay_for> | ||
<comment>OK</comment> | <comment>OK</comment> | ||
Строка 45: | Строка 50: | ||
</result> | </result> | ||
+ | === Возможные коды завершения операции === | ||
+ | |||
+ | ^ Код ^ Значение ^ | ||
+ | | 0 | ОК – означает, что “платеж может быть принят” | | ||
+ | | 2 | Платёж отклонён. Onpay не примет этот платеж. | | ||
+ | | 3 | Ошибка в параметрах. Onpay не примет этот платеж. | | ||
+ | | 7 | Ошибка авторизации. MD5 подпись неверна. Onpay не примет этот платеж. | | ||
+ | | 10 | Временная ошибка. Onpay не примет этот платеж. | | ||
+ | |||
+ | ======pay запрос====== | ||
- | ====pay запрос==== | + | ====Запрос к мерчанту==== |
На URL отправляется Post запрос со следующими параметрами: | На URL отправляется Post запрос со следующими параметрами: | ||
Строка 91: | Строка 106: | ||
day_to_expiry=* - срок действия кода протекции | day_to_expiry=* - срок действия кода протекции | ||
paid_amount=* - сумма, которую должен был заплатить плательщик | paid_amount=* - сумма, которую должен был заплатить плательщик | ||
+ | |||
+ | ====Ответ мерчанта==== | ||
Сервер магазина на pay-запрос возвращает следующие данные: | Сервер магазина на pay-запрос возвращает следующие данные: | ||
Строка 117: | Строка 134: | ||
- | ==== Возможные коды завершения операции ==== | + | === Возможные коды завершения операции === |
^ Код ^ Значение ^ | ^ Код ^ Значение ^ | ||
- | | 0 | ОК – означает, что “уведомление о платеже принято” если тип запроса был “pay” или “может быть принято” если тип запроса был “check” | | + | | 0 | ОК – означает, что “уведомление о платеже принято” | |
- | | 2 | Только для запросов типа “check” Платёж отклонён. В этом случае Onpay.ru не примет платёж от Клиента. | | + | | 3 | Ошибка в параметрах. Onpay.ru не будет пытаться повторно послать это уведомление в систему Продавца и отметит этот платёж статусом “уведомление не доставлено в API” если тип запроса “pay” | |
- | | 3 | Ошибка в параметрах. Onpay.ru не будет пытаться повторно послать это уведомление в систему Продавца и отметит этот платёж статусом “уведомление не доставлено в API” если тип запроса “pay”. Если тип запроса “check” – Onpay не примет этот платеж. | | + | |
| 7 | Ошибка авторизации. MD5 подпись неверна. | | | 7 | Ошибка авторизации. MD5 подпись неверна. | | ||
| 10 | Временная ошибка. Onpay.ru попробует повторно послать это уведомление несколько раз в течение следующих 72 часов после чего пометит платёж статусом “уведомление не доставлено в API” | | | 10 | Временная ошибка. Onpay.ru попробует повторно послать это уведомление несколько раз в течение следующих 72 часов после чего пометит платёж статусом “уведомление не доставлено в API” | | ||
- | ==== Упрощенный формат ==== | + | ====== Упрощенный формат ====== |
Для ответов на запросы, сервер магазина может использовать упрощенный формат. | Для ответов на запросы, сервер магазина может использовать упрощенный формат. | ||
Строка 152: | Строка 168: | ||
====== Справочная информация ====== | ====== Справочная информация ====== | ||
- | |||
- | ====Недоступность сервера магазина==== | ||
- | |||
- | Если сервер магазина недоступен для “check” запроса или возвращает какой-либо код кроме “0”, система Onpay не примет платёж от Клиента. | ||
- | |||
- | Если сервер магазина недоступен для “pay” запроса, система Onpay будет повторно отправлять запрос несколько раз в течение следующих 72 часов. Повторяющиеся запросы посылаются с увеличивающимися интервалами. | ||
- | |||
- | ====Возвращаемые ошибки==== | ||
- | |||
- | На стороне сервера Onpay в зависимости от ответа сервера магазина могут быть сгенерированы следующие ошибки (и в дальнейшем показаны в личном кабинете): | ||
- | |||
- | 7.1.1. С сервером магазина нет соединения. http://wiki.onpay.ru/doku.php?id=oshibki#7.1.1 | ||
- | 7.1.2. Платеж отклонен получателем. http://wiki.onpay.ru/doku.php?id=oshibki#7.1.2 | ||
- | 7.1.3. Ошибка авторизации - подпись не совпадает. http://wiki.onpay.ru/doku.php?id=oshibki#7.1.3 | ||
- | 7.1.4. Магазин возвращает неверные данные - pay_for не совпадает. http://wiki.onpay.ru/doku.php?id=oshibki#7.1.4 | ||
- | 7.1.5. Магазин возвращает неверные данные - неверное значение поля (code). http://wiki.onpay.ru/doku.php?id=oshibki#7.1.5 | ||
- | 7.2.1. С сервером мерчанта нет соединения. http://wiki.onpay.ru/doku.php?id=oshibki#7.2.1 | ||
- | 7.2.2. Ошибка авторизации - подпись не совпадает. http://wiki.onpay.ru/doku.php?id=oshibki#7.2.2 | ||
- | 7.2.3. Магазин возвращает неверные данные - pay_for не совпадает. http://wiki.onpay.ru/doku.php?id=oshibki#7.2.3 | ||
- | 7.3.1. Магазин возвращает данные в некорректном формате (требуется XML или упрощенный текстовый формат). http://wiki.onpay.ru/doku.php?id=oshibki#7.3.1 | ||
- | 7.3.2. Магазин возвращает неверные данные - отсутствует обязательный параметр (code). http://wiki.onpay.ru/doku.php?id=oshibki#7.3.2 | ||
- | 7.3.3. Магазин возвращает неверные данные - отсутствует обязательный параметр (pay_for). http://wiki.onpay.ru/doku.php?id=oshibki#7.3.3 | ||
- | 7.3.4. Магазин возвращает неверные данные - отсутствует обязательный параметр (md5). http://wiki.onpay.ru/doku.php?id=oshibki#7.3.4 | ||
- | 7.3.5. Ошибка в параметрах запроса. http://wiki.onpay.ru/doku.php?id=oshibki#7.3.5 | ||
- | 7.3.6. Ошибка авторизации. http://wiki.onpay.ru/doku.php?id=oshibki#7.3.6 | ||
- | 7.3.7. Временная ошибка. http://wiki.onpay.ru/doku.php?id=oshibki#7.3.7 | ||
- | 7.2.5. Если возвращен код отличный от 0, сообщение ошибки берется из поля "comment". | ||
====Значения полей, содержащих информацию о суммах и платежных системах(на примере)==== | ====Значения полей, содержащих информацию о суммах и платежных системах(на примере)==== | ||
Строка 232: | Строка 221: | ||
В платеж и в pay запрос к серверу магазина попадает сумма, вычисленная по новому курсу на момент создания платежа. В pay запросе к серверу магазина приходит старый курс, который был на момент создания ордера. | В платеж и в pay запрос к серверу магазина попадает сумма, вычисленная по новому курсу на момент создания платежа. В pay запросе к серверу магазина приходит старый курс, который был на момент создания ордера. | ||
- | |||