UkrMoney.com — система Интернет-платежей
Быстро Удобно Надежно [http://card.ukrmoney.com/card/] Регистрация Забыли пароль? О системе Условия использования Партнёрам Подключение магазина Регистрация Работа с системой Работа со счетами Веб мастерам и разработчикам Получение карты Maestro Получение карты Visa FAQ Live Help Электронная почта Live Journal ICQ Веб-мастерам и Разработчикам Платёжная система UkrMoney.com позволяет проводить автоматизированные операции между UkrMoney.com и другими системами. Эта функция ориентирована на Интернет-магазины, платные Интернет сервисы, а также другие Интернет сервисы которым необходимо автоматизированное взаимодействие с системой UkrMoney.com. Взаимодействие осуществляется при помощи двух систем: "Click&Buy" – система позволяющая проводить операции оплаты товаров и услуг с использованием интерфейса сайта – клиента UkrMoney.com ; API UkrMoney.com – API интерфейс предусматривает почти полное дублирование функций основного WEB – интерфейса сайта UkrMoney.com . Этот интерфейс позволяет значительно увеличить количество возможных операций между и платёжной системой UkrMoney.com и другими системами, по сравнению с системой "Click&Buy". Для быстрого подключения системе, Вам предоставляется готовый модуль взаимодействия Вашего Интернет сервиса с API интерфейсом UkrMoney.com. Скачать модуль UkrMoney-API , а также прочитать его описание возможно перейдя по следующей ссылке: http://ukrmoney.com/API.pm Данный модуль написан на Perl. Вы можете самостоятельно написать свой, используя описания системы "Click&Buy" и интерфейса API UkrMoney.com , которые расположены далее по тексту. Описание процесса взаимодействия Интернет-ресурса с системой "Click&Buy" платёжной системы UkrMoney.com. Система "Click&Buy" позволяет производить оплату товаров и услуг посетителями со страниц сайта-клиента UkrMoney.com . Процесс предусматривает передачу параметров включенных в URL подтверждения покупки товара. Данный URL переадресовывает посетителя на страницу платёжной системы, где он вводит свой номер кошелька и пароль. После чего, посетитель переадресовывается на заранее определённый URL страницы Интернет-ресурса. При переадресации передаются параметры, определяемые на основании параметров ранее переданных Интернет-ресурсом маркером, основанным на технологии шифрования md5_hex позволяющих системе сайта-клиента UkrMoney.com удостоверится в подлинности переданных данных. Все параметры передаются по протоколу HTTPS. Операция проведения операции оплаты товара состоит из следующих этапов: На странице оплаты товара/услуги Интернет-ресурса находится кнопка. Нажимая на кнопку, пользователь переходит по динамически формируемому URL следующего вида: https://trans.ukrmoney.com/add_nologged/?benef_mail=… &amnt=…¤cy=…&wording=...&url_redirect=... Параметры: benef_mail - E-mail получателя платежа; amnt - сумма перевода средств. Целая дробная часть значения разделяются точкой. После точки не более двух цифр. Незначащие нули запрещены!; currency - валюта платежа. Может принимать значения: UAH | USD | EUR wording - назначение платежа (в кодировке UTF-8); url_redirect - ссылка, на которую переходит пользователь, при успешном проведении транзакции Обратный URL может содержать любые параметры, которые необходимо передать при переадресации пользователя. Пример: Допустим у вас есть свой Интернет-магазин. Покупатель должен заплатить за купленный товар: "Телевизор LG" , стоящий 1000 гривен . Деньги должны быть зачислены на счёт в системе UkrMoney.com , пользователю E-mail которого: admin@mysite.ua . После оплаты покупатель должен быть переадресован на страницу: http://www.mysite.ua/tovar_kuplen/ . Для быстрого проведения данной операции Вам необходимо выставить на сайт ссылку в виде следующего кода:
Нажмите сюда для оплаты Примечание: приведенная ссылка будет работать на странице с кодировкой UTF-8. На страницах с другими кодировками рекомендуем заменить русские буква на их латинские аналоги, в нашем примере вместо "wording=Телевизор LG" написать "wording=Televizor LG". Пользователь попадает на страницу сайта UkrMoney.com , где вводит номер своего кошелька и пароль. Пользователь переадресовывается на ранее переданный магазином URL со следующими параметрами: benef_mail - E-mail получателя; wording - назначение платежа (в кодировке UTF-8); ts - время транзакции; fee - комиссия; payee_order – номер кошелька плательщика; amnt – сумма транзакции. payee_mail – E-mail плательщика; currency – валюта; benef_order – кошелёк получателя; id - ID транзакции; marker - MD5_hex(id, benef_order, benef_mail, payee_order, payee_mail, amnt, fee, wording, ts, currency, benef_mail, MD5_hex(пароль получателя)) - маркер позволяющий проверить подлинность переданного подтверждения транзакции. Этот маркер является результатом шифрования параметров описанных выше и результата шифрования пароля пользователя. Для того чтобы проверить подлинность переданных параметров, необходимо параметры, переданные в URL, зашифровать при помощи MD5_hex, точно в таком порядке, в каком они указаны в скобках, отделяя один параметр от другого при помощи запятой, но без пробелов . Обратите внимание, что "Пароль получателя" не передаётся, и должен быть известен Вам! Также необходимо заметить, что "Пароль получателя" необходимо зашифровать отдельно, при помощи MD5_hex, и после этого зашифровать результат вместе с параметрами! Если результат шифрования совпадает с переданным маркером, транзакцию можно считать успешной. Инструкция по осуществлению взаимодействия Интернет - магазина с платёжной системой UkrMoney.com Взаимодействие осуществляется через API интерфейс являющейся частью платёжной системы UkrMoney.com . Интерфейс предусматривает почти полное дублирование функций основного WEB – интерфейса, таких как: Вход в систему; Проведение новой транзакции; Просмотр информации о транзакции; Просмотр информации о пользователе; Все операции через API осуществляются по протоколу HTTPS. Перед каждой операцией необходимо проводить операцию «Вход в систему». После каждого запроса, в ответ от API интерфейса приходит XML файл с параметрами, которые запрашивались, либо сообщением об ошибке. Описание параметров передаваемых магазином API интерфейсу u_mail - E-mail пользователя; u_pwd - пароль пользователя; pcsl_session_id - ID сессии; p_um - UM ID; t_id - ID транзакции t_benef_mail – E-mail получателя; t_benef_order - порядковый номер кошелька получателя в данной валюте, необходим для проведения транзакции в конкретный кошелёк. Параметр является необязательным, по умолчанию принимает значение "1"; t_amnt – сумма. Целая дробная часть значения разделяются точкой. После точки не более двух цифр. Незначащие нули запрещены!; t_wording – описание (в кодировке UTF-8); t_currency - валюта (UAH - гривна, USD - доллар, EUR - евро); start_date - параметр сортировки списка транзакции по времени, указывает, начиная с какой даты отображать транзакции; stop_date - параметр сортировки списка транзакции по времени, указывает по какую дату отображать транзакции; Описание тегов и параметров XML файлов, передаваемых API интерфейсом магазину в ответ на запрос
- сообщение об ошибке; - ID сессии; - транзакция; user_id – ID пользователя; email – E-mail пользователя; - отправитель платежа; - получатель платежа; user_id – ID пользователя; email – E-mail пользователя; - кошелёк; number – номер кошелька; name – имя кошелька; < amnt> - сумма платежа. Целая дробная часть значения разделяются точкой. После точки не более двух цифр. Незначащие нули запрещены!; - статус транзакции; - информация о пользователе; id - ID пользователя; - электронный адрес; - фамилия пользователя; - имя пользователя; ИЛИ …. © 2006 ЗАО "Купуй", все права защищены