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