Различия

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

--- api-bills [2011/09/13 09:39]
admin
+++ api-bills [2014/09/26 11:13]
admin
@@ Строка 1: / Строка 1: @@
-Для того чтобы выставить счет за определенный товар на определенную сумму следует использовать механизм создания ссылок-счетов с использованием API Onpay.\\
+Для того чтобы автоматически выставить счет за определенный товар на определенную сумму можно использовать механизм создания ссылок-счетов с использованием API Onpay. А можно просто вручную сделать ссылку через интерфейс Кабинета продавца https://secure.onpay.ru/payment_links - для этого не потребуется никаких специальных знаний.\\
 \\
+==== Параметры ====
 Для получения ссылки (счета) необходимо отправить запрос (GET или POST) на адрес https://secure.onpay.ru/pay/make_payment_link со следующими параметрами:\\
-**pay_amount** - сумма счета\\
+^ Параметр ^ формат ^ Описание ^
-**pay_for** - назначение платежа\\
+| pay_amount | число, разделитель - точка, будет округлено до 2 знаков после разделителя | сумма счета |
-**currency** - тикер валюты оплаты\\
+| pay_for | строка | назначение платежа |
-**user_login** - логин пользователя\\
+| one_way | строка | форма оплаты одним способом (тикер валюты) (не обязательно) |
-user_email - адрес электронной почты плательщика (не обязательно)\\
+| ticker | строка | 3-символьное обозначение валюты оплаты(в верхнем регистре) |
-one_way - форма оплаты одним способом (тикер валюты) (не обязательно)\\
+| user_login | строка | логин магазина в системе Onpay |
-**price_final** - комиссию платежной системы взымать с продавца (true или false)\\
+| user_email | строка | адрес электронной почты плательщика (не обязательно) |
-**pay_type** - конвертировать все платежи в выбранную валюту (1 - да, 2 - нет)\\
+| price_final | "1" или "0"(по умолчанию "0") | если "1", комиссия платежной системы будет взыматься с продавца |
-**notify_by_api** - проверять возможность оплаты через API мерчанта\\
+| pay_type | 1 или 2 | конвертировать все платежи в выбранную валюту (1 - да, 2 - нет) |
-**md5** - строка, полученная вычислением MD5 от конкатенации pay_amount,pay_for,currency,user_login,one_way,price_final,pay_type,notify_by_api,api_in_key разделенных двоеточием (:)\\
+| notify_by_api | "1" или "0" | проверять возможность оплаты через API мерчанта (Если "1" - при оплате мерчант получит запрос через указанный им в зеленом кабинете URL API IN. Если на запрос не будет ответа или ответ будет негативным, оплата не пройдет) |
-\\
+| md5 | строка | строка, полученная вычислением MD5 от конкатенации pay_amount, pay_for, ticker, user_login, price_final, pay_type, notify_by_api, api_in_key, разделенных двоеточием (:) |
-!!! В запросе также обязательно должен присутствовать параметр **api_in_key** - пароль для API Мерчанта\\
+Все параметры, содержащие символы не относящиеся к ASCII должны быть переданы в кодировке utf8.\\
 \\
 В случае успеха статус ответа будет 200 и в теле ответа будет сгенерированная ссылка.\\
 В случае неудачи статус ответа будет 400 и в теле ответа будет объяснение причины.\\
-\\
-Причины могут быть следующие: неправильный md5 или ошибки при сохранении счета (зависит от валидации).\\
+==== Пример GET запроса ====
+  https://secure.onpay.ru/pay/make_payment_link?pay_amount=100&pay_for=Order%20342&user_email=user@pochta.ru&ticker=RUR&user_login=onpay&price_final=true&md5=cf653b4c4a7861b2224bd31eb3e3f291&pay_type=1&notify_by_api=true \\
+==== Пример POST запроса ====
+  POST https://secure.onpay.ru/pay/make_payment_link {
+  "price_final"=>"true",
+  "user_login"=>"onpay",
+  "notify_by_api"=>"true",
+  "pay_type"=>"1",
+  "pay_amount"=>"100",
+  "ticker"=>"RUR",
+  "md5"=>"cf653b4c4a7861b2224bd31eb3e3f291",
+  "pay_for"=>"Order 342",
+  "user_email"=>"user@pochta.ru"
+  }

Onpay.ru Wiki

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

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

Различия

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