Различия

Здесь показаны различия между двумя версиями данной страницы.

--- api-bills [2011/09/13 09:40]
admin
+++ api-bills [2011/09/16 10:20]
admin
@@ Строка 1: / Строка 1: @@
 Для того чтобы выставить счет за определенный товар на определенную сумму следует использовать механизм создания ссылок-счетов с использованием API Onpay.\\
 \\
+==== Параметры ====
 Для получения ссылки (счета) необходимо отправить запрос (GET или POST) на адрес https://secure.onpay.ru/pay/make_payment_link со следующими параметрами:\\
 **pay_amount** - сумма счета\\
 **pay_for** - назначение платежа\\
@@ Строка 12: / Строка 12: @@
 **pay_type** - конвертировать все платежи в выбранную валюту (1 - да, 2 - нет)\\
 **notify_by_api** - проверять возможность оплаты через API мерчанта\\
-**md5** - строка, полученная вычислением MD5 от конкатенации pay_amount,pay_for,currency,user_login,one_way,price_final,pay_type,notify_by_api,api_in_key разделенных двоеточием (:)\\
+**md5** - строка, полученная вычислением MD5 от конкатенации pay_amount, pay_for, currency, user_login, one_way, price_final, pay_type, notify_by_api, api_in_key, разделенных двоеточием (:) - после конкатенации через двоеточие строку перед вычислением MD5 надо перевести в верхний регистр.\\
 \\
 !!! В запросе также обязательно должен присутствовать параметр **api_in_key** - пароль для API [[http://wiki.onpay.ru/doku.php?id=merchant|Мерчанта]]\\
@@ Строка 19: / Строка 19: @@
 В случае неудачи статус ответа будет 400 и в теле ответа будет объяснение причины.\\
 \\
-Причины могут быть следующие: неправильный md5 или ошибки при сохранении счета (зависит от валидации).\\
+Причины могут быть следующие: неправильный MD5 или ошибки при сохранении счета (зависит от валидации).\\
+\\
+==== Форматы параметров ====
+**pay_amount**: число, будет округлено до 2 знаков после запятой\\
+**pay_for**: строка \\
+**user_email**: строка\\
+**currency**: 3-символьное обозначение валюты оплаты (тикер), строка\\
+**user_login**: строка, логин мерчанта в системе Onpay\\
+**one_way**: 3-символьное обозначение валюты для оплаты одним способом (тикер)\\
+**price_final**: булевское значение, значения '1', 'true', 'TRUE', 't', 'T' будут интерпретированы как "да", любые другие - как "нет" (в том числе, к примеру 'True' дает false)\\
+**pay_type**: 1 или 2, любое другое значение вызовет ошибку\\
+**notify_by_ap**i: булевское значение, значения '1', 'true', 'TRUE', 't', 'T' будут интерпретированы как "да", любые другие - как "нет" (в том числе, к примеру 'True' дает false)\\
+**md5 - строка**\\
+\\
+==== Пример GET запроса ====
+  https://secure.onpay.ru/pay/make_payment_link?pay_amount=100&pay_for=Order%20342&user_email=user@pochta.ru&currency=RUR&user_login=onpay&one_way=RUR&price_final=true&md5=cf653b4c4a7861b2224bd31eb3e3f291&pay_type=1&notify_by_api=true \\
+==== Пример POST запроса ====
+\\
+  POST https://secure.onpay.ru/pay/make_payment_link {
+  "one_way"=>"RUR",
+  "price_final"=>"true",
+  "user_login"=>"onpay",
+  "notify_by_api"=>"true",
+  "pay_type"=>"1",
+  "pay_amount"=>"100",
+  "currency"=>"RUR",
+  "md5"=>"cf653b4c4a7861b2224bd31eb3e3f291",
+  "pay_for"=>"Order 342",
+  "user_email"=>"user@pochta.ru"
+  }

Onpay.ru Wiki

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

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

Различия

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