API Interkassa

Порядок подключения

После регистрации зайти на страницу 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)