=== 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 (без кавычек):
  
  <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)