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

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


api-bills

Это старая версия документа.


Для того чтобы выставить счет за определенный товар на определенную сумму следует использовать механизм создания ссылок-счетов с использованием API Onpay.

Параметры

Для получения ссылки (счета) необходимо отправить запрос (GET или POST) на адрес https://secure.onpay.ru/pay/make_payment_link со следующими параметрами:
pay_amount - сумма счета
pay_for - назначение платежа
currency - тикер валюты оплаты
user_login - логин пользователя
user_email - адрес электронной почты плательщика (не обязательно)
one_way - форма оплаты одним способом (тикер валюты) (не обязательно)
price_final - комиссию платежной системы взымать с продавца (true или false)
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 надо перевести в верхний регистр.

!!! В запросе также обязательно должен присутствовать параметр api_in_key - пароль для API Мерчанта

В случае успеха статус ответа будет 200 и в теле ответа будет сгенерированная ссылка.
В случае неудачи статус ответа будет 400 и в теле ответа будет объяснение причины.

Причины могут быть следующие: неправильный 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_api: булевское значение, значения '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" 
}
api-bills.1316168419.txt.gz · Последние изменения: 2011/09/16 06:20 — admin