Onpay.ru Wiki

ВНИМАНИЕ. При использовании данного типа АПИ, платежи без обязательных параметров проходить не будут, для «свободных платежей используйте апи Https1 или Https2. ==== Порядок подключения ==== После регистрации зайти на страницу https://secure.onpay.ru/merchants/edit и произвести Настройки API IN, в процессе чего обязательно указать тип API - Interkassa. Следует обратить внимание на то, что если Вы принимаете уведомления по API, то Вам следует скопировать Ваш ik_status_url с формы запроса о платеже и указать Метод отправки запросов в API в соответствии с ik_status_method; эти поля можно удалять с формы запроса о платеже так как они будут игнорироваться при получении формы сервисом Onpay, а их значения будут браться из тех, что Вы укажете на https://secure.onpay.ru/merchants/edit. Пример: если нужны уведомления - скопировать value (без кавычек): <pre> <input type=«hidden» value=«http://name_of_my_site.com/status_url» name=«ik_status_url»> <input type=«hidden» value=«GET» name=«ik_status_method»> </pre> ==== Форма уведомления о платеже ==== Пусть, например, до перехода на Onpay.ru Ваша форма выглядела так: <pre> <form target=«_top» name=«payment» method=«post» action=«http://www.interkassa.com/lib/payment.php»> <input type=«hidden» value=«64C18529-4B94-0B5D-7405-F2752F2B716C» name=«ik_shop_id»> <input type=«text» value=«10.04» name=«ik_payment_amount»> <input type=«hidden» value=«84» name=«ik_payment_id»> <input type=«text» value=«iPod 80Gb черный» name=«ik_payment_desc»> <input type=«hidden» value=«webmoneyz» name=«ik_paysystem_alias»> <input type=«text» value=«email: mail@mail.com, tel: +9991114466» name=«ik_baggage_fields»> <input type=«hidden» value=«http://name_of_my_site.com/interkassa/success» name=«ik_success_url»> <input type=«hidden» value=«GET» name=«ik_success_method»> <input type=«hidden» value=«http://name_of_my_site.com/fail» name=«ik_fail_url»> <input type=«hidden» value=«GET» name=«ik_fail_method»> <input type=«hidden» value=«http://name_of_my_site.com/» name=«ik_status_url»> <input type=«hidden» value=«GET» name=«ik_status_method»> <input type=«hidden» value=«1» name=«ik_fees_payer»> <input type=«submit» value=«Оплатить» name=«process»> </form> </pre> И пусть Ваш логин в системе Onpay - my_login Тогда значение атрибута action тега <form> необходимо изменить на https://secure.onpay.ru/pay/<Ваш логин>, т. е. тег должен выглядеть: <pre> <form target=«_top» name=«payment» method=«post» action=«https://secure.onpay.ru/pay/my_login»> </pre> ==== Поля формы ==== Далее приведена таблица с замечаниями о полях формы: |Поле|Обязательный|Описание|Замечание| |ik_shop_id|Нет|Идентификатор магазина зарегистрированного в системе|Игнорируется, можно удалять. Идентификация магазина производится по логину в action| |ik_payment_amount|Да|Сумма платежа, которую продавец желает получить от покупателя|Округляется до второго знака после запятой| |ik_payment_id|Да|В этом поле продавец задает идентификатор покупки в соответствии со своей системой учета|-| |ik_payment_desc|Нет|Описание товара или услуги|-| |ik_paysystem_alias|Нет|Поле позволяет заранее определить способ оплаты для покупателя|По умолчанию: рубли| |ik_baggage_fields|Нет|Это поле передается на веб-сайт продавца после выполнения платежа.|Должно быть в формате: /email: .+ tel: \+([\d])+$/ Пример: email: mail@gmail.com, tel: +79638527744 Т.е телефон должен начинаться с »+«| |ik_success_url|Нет|URL (на интернет-магазине), на который будет переведен покупатель в случае успешного выполнения платежа|Не может содержать параметры запроса (все, что идет после «?» в ссылке). Должен начинаться с «http:» или «https:». По умолчанию используется значение, указанное в поле Адрес сайта (для посетителей) на странице https://secure.onpay.ru/merchants/edit| |ik_success_method|Нет|Метод передачи данных платежа, который будет использоваться при переходе на Success URL|Должен быть POST или GET. По умолчанию: GET. Внимание: мы не работаем с методом LINK, и он будет заменен на метод по умолчанию| |ik_fail_url|Нет|URL (на интернет-магазине), на который будет переведен покупатель в том случае, если платеж не был выполнен по каким-то причинам.|То же что и в ik_success_url| |ik_success_method|Нет|Метод передачи данных платежа, который будет использоваться при переходе на Success URL|То же что и в ik_success_method| |ik_status_url|Нет|URL оповещения по API|Игнорируется, можно удалять. Определяется в настройках на https://secure.onpay.ru/merchants/edit| |ik_status_method|Нет|Метод передачи оповещения по API|Игнорируется, можно удалять. Определяется в настройках на https://secure.onpay.ru/merchants/edit| *Внимание: новое опциональное поле:* |Поле|Обязательный|Описание|Замечание| |ik_fees_payer|Нет|Плательщик комиссии в момент создания платежа|Если равен «1», то плательщиком комиссии становится покупатель, иначе - продавец| === Контрольная подпись данных о платеже === Для формирования контрольной подписи с обеих сторон, по прежнему используется «Секретный ключ». Он указывается в настройках на https://secure.onpay.ru/merchants/edit в поле Пароль для API (secret_key)