Формирование ссылки или формы (UkrMoney)

Ссылка сервиса: https://trans.ukrmoney.com/add_nologged/.
Метод передачи параметров: GET или POST.
Параметры:
benef_mail - E-mail получателя платежа;
amnt - сумма перевода средств. Целая и дробная часть значений разделяются точкой. После точки не более двух цифр. Незначащие нули запрещены!;
currency - валюта платежа. Может принимать значения: UAH USD EUR
wording - назначение платежа (в кодировке UTF-8), не более 255 байт;
benef_order- не обязательный параметр, порядковый номер счета получателя в данной валюте, если не задан, то будет использоваться первый счет. Если задан несуществующий номер, то будет сгенерирована ошибка.
url_redirect - ссылка, на которую переходит пользователь, при успешной оплате и при отмене оплаты. Параметр может быть не обязательным если вы указали «URL оповещения при возврате» в настройках merchant (cм. далее).
payment_id – не обязательный параметр, идентификатор оплаты, который потом используется в «маркере».
Пример:
Допустим, у вас есть свой Интернет-магазин. Покупатель должен заплатить за купленный товар: "Телевизор LG", стоящий 1000 гривен. Деньги должны быть зачислены на ваш аккаунт, в системе UkrMoney.com, с E-mail-ом admin@example.com. После оплаты покупатель должен быть переадресован на страницу: http://www.example.com/tovar_kuplen/.

Либо кнопку находящуюся в форме:

admin@example.com” />

Примечание: приведенная ссылка будет работать на странице с кодировкой UTF-8. На страницах с другими кодировками рекомендуем заменить русские буквы на их латинские аналоги, в нашем примере вместо "wording=Телевизор LG" можно написать "wording=Televizor LG".
Настройка параметров (настройки merchant)
Настройка параметров «Click&Buy» производится на сайте UkrMoney.com в разделе Настройки > Другие настройки > Настройки Merchant:· секретный ключ - не обязательный параметр, если задан то он будет подставляться в «маркер» вместо вашего пароля;
· URL оповещения, при возврате – не обязательный параметр, если не был задан url_redirect параметр, то пользователь переходит на эту ссылку после удачной оплаты или отмены оплаты, параметры передаются GET методом;
· URL оповещения, об удачной оплате - не обязательный параметр, посылать запрос по данному адресу, в обход пользователя, об удачной оплате, параметр result принимает значение Success;
· URL оповещения, об удачной оплате, метод оповещения - метод оповещения POST или GET для запроса об удачной оплате.
· URL оповещения, о неудачной оплате - не обязательный параметр, посылать запрос по данному адресу, в обход пользователя, при неудачной оплате (пользователь отменил оплату), параметр result принимает значение Fail;
· URL оповещения, о неудачной оплате, метод оповещения - метод оповещения POST или GET для запроса о неудачной оплате.
· Для каждого счета галочка «Показывать имя счета при Click&buy» - если галочка выбрана, то человеку который совершает оплату на данный счет будет показываться еще и название этого счета, если же галочка не выбрана – то название счета не будет показываться;

Возврат после оплаты или отмены оплаты, оповещенияПри переходе на url_redirect (или на URL оповещения, при возврате), на URL оповещения, об удачной оплате, на URL оповещения, о неудачной оплате передаются следующие параметры:
· id - идентификатор транзакции;
· benef_mail - E-mail получателя;
· benef_order – порядковый номер счета получателя в данной валюте;
· payee_mail – E-mail плательщика;
· payee_order – порядковый номер счета плательщика в данной валюте;
· amnt – сумма транзакции.
· fee - комиссия;
· wording - назначение платежа (в кодировке UTF-8);
· ts - время транзакции, формат в виде MySQL datetime, пример «2006-12-31 23:59:59»;
· currency – валюта;
· result – Success если оплата удачная, Fail – оплата неудачная (не произведена);
· payment_id – этот тот же параметр который передается в запросе, он может отсутствовать если его не было в запросе.
· marker – маркер, специальное значение, позволяет проверить параметры на подлинность (что запрос пришел от UkrMoney.com) и целостность (что данные не были искажены при передаче по сети).
Примечание: Для совместимости со старой версией маркера в случае удачной оплаты переход url_redirect(или URL оповещения, при возврате) не содержит параметра result и маркер не использует этот параметр, см. формулу 1)
Формула для расчета маркера:
signature – это подпись. Если человек задал секретный ключ то подпись равна этому секретному ключу, иначе подпись это MD5_hex(benef_password), где benef_password – это пароль от аккаунта получателя.
1) Маркер удачной оплаты для url_redirect(или URL оповещения, при возврате) считается по следующей формуле:
MD5_hex(id, benef_order, benef_mail, payee_order, payee_mail, amnt, fee, wording, ts, currency, benef_mail, signature, payment_id)
2) Маркер неудачной оплаты для url_redirect(или URL оповещения, при возврате) считается по следующей формуле:
MD5_hex(benef_order, benef_mail, payee_mail, amnt, fee, wording, ts, currency, benef_mail, signature, result, payment_id)
3) Маркер для URL оповещения, об удачной оплате считается по следующей формуле:
MD5_hex(id, benef_order, benef_mail, payee_order, payee_mail, amnt, fee, wording, ts, currency, benef_mail, signature, result, payment_id)
4) Маркер для URL оповещения, о неудачной оплате считается по следующей формуле:
По той же формуле что и 2)
MD5_hex() – функция которая возвращает MD5 хеш в виде шестнадцатеричного числа от аргумента этой функции. Аргумент – это строчка, которая составляется из параметров точно в таком порядке, в котором они указаны в скобках, отделяя один параметр от другого при помощи запятой, но без пробелов. Если вы в запросе не передавали параметр payment_id, то маркер будет сформирован без него и без запятой перед ним.