Это старая версия документа.
ВНИМАНИЕ. При использовании данного типа АПИ, платежи без обязательных параметров проходить не будут, для «свободных платежей используйте апи 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 (без кавычек):
<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">
Пусть, например, до перехода на Onpay.ru Ваша форма выглядела так:
<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>
И пусть Ваш логин в системе Onpay - my_login Тогда значение атрибута action тега <form> необходимо изменить на https://secure.onpay.ru/pay/<Ваш логин>, т. е. тег должен выглядеть:
<form target="_top" name="payment" method="post" action="https://secure.onpay.ru/pay/my_login">
Далее приведена таблица с замечаниями о полях формы:
Поле | Обязательный | Описание | Замечание |
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)