API Interkassa

ВНИМАНИЕ. При использовании данного типа АПИ, платежи без обязательных параметров проходить не будут, для «свободных платежей используйте апи 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 Ваша форма выглядела так:

<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)