Содержание

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)