Инструменты пользователя
Это старая версия документа.
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)