- •1. Введение
- •2. Общие понятия и подключение к системе «interkassa».
- •2.1. Общая схема работы шлюза.
- •2 .3. Регистрация в системе.
- •2 .4. Настройка магазина в системе.
- •3. Описание интерфейса ipi (Interkassa Payment Interface)
- •4. Формы html
- •4.1. Форма запроса платежа
- •4.2. Форма оповещения о платеже
- •4.3. Форма выполненного платежа
- •4.4. Форма невыполненного платежа
- •5. Проверка информации о платеже
- •Запустить бизнес-логику вашего приложения
- •5.1. Проверка источника данных
- •5.2. Проверка целостности данных
- •5.3. Контрольная подпись данных о платеже
- •5.4. Проверка суммы платежа
- •5.5. Проверка кошелька продавца
- •5.6. Проверка статуса проведения платежа
- •5.7. Запустить бизнес-логику вашего приложения
- •6. Полезные ссылки
2 .4. Настройка магазина в системе.
Для полной интеграции вашего магазина в систему «INTERKASSA» вам необходимо провести предварительную настройку всех свойств вашего магазина. Для этого в админ-панели, в разделе «Управление магазинами» вам необходимо перейти в «Настройки магазина».
После регистрации в «INTERKASSA» для приема платежей через сервис IPI (Interkassa Payment Interface) администратор интернет-магазина должен настроить ряд параметров, регулирующих порядок приема платежей и оповещения продавца о факте проведения платежа. Настройка параметров выполняется на странице «Настройки магазина»
Полный перечень параметров и их назначение приведено ниже:
Название свойства |
Формат |
Описание |
Название магазина |
Char(255) |
Название магазина |
URL магазина |
text [URL] (case sensitive) |
URL вашего интернет-магазина |
Описание магазина |
text |
Описание магазина, которое будет использоваться в каталогах и тегах HTML - Description |
Success URL |
text [URL] (case sensitive) |
URL (на интернет-магазине), на который будет переведен покупатель в случае успешного выполнения платежа в сервисе IKI. URL должен иметь префикс "http://" или https:// (полный путь). |
Метод передачи Success URL*1 |
LINK / GET / POST |
Метод передачи данных платежа (POST, GET или LINK), который будет использоваться при переходе на Success URL.
|
Fail URL |
text [URL] (case sensitive) |
URL (на интернет-магазине), на который будет переведен покупатель в том случае, если платеж в сервисе IKI не был выполнен по каким-то причинам. URL должен иметь префикс "http://" или https:// (полный путь). |
Метод передачи Fail URL*1 |
LINK / GET / POST |
Метод передачи данных платежа (POST, GET или LINK), который будет использоваться при переходе на Fail URL. |
Status URL |
text [URL] (case sensitive) |
URL (на интернет-магазине), на который сервис IKI посылает HTTP GET или POST оповещение о совершении платежа с его детальными реквизитами. Если вы определили метод передачи Status URL (см. ниже) как “OFF”, то он не будет оповещаться сервисом о совершенных платежах. URL должен начинаться с префикса "http://", "https://" (полный путь). |
Метод передачи Status URL*1 |
OFF / GET / POST |
Метод передачи данных платежа (POST, GET или OFF), который будет использоваться при переходе на Status URL. Выберите вариант 'OFF', если вы не желаете использовать Status URL. |
Почтовые ящики для уведомлений о платежах |
text [e-mail] |
На эти e-mail адреса будет приходить оповещение о совершении платежа с его детальными реквизитами. Для надежности вы можете указать несколько адресов.
|
Номера ICQ для уведомлений о платежах |
digit [0-9] |
На эти ICQ номера будет приходить оповещение о совершении платежа с его детальными реквизитами. Для надежности вы можете указать несколько ICQ номеров. |
Текст уведомления |
text |
Текст уведомления отображаться покупателю в графе «важная информация» при переходе на сервис IKI. |
Плательщик комиссии |
PAYER / PAYEE / BOTH |
Выбор плательщика комиссии «INTERKASSA» (комиссия – 3%). Существует 3 варианта: комиссию платит магазин, комиссию платит покупатель, комиссия делится поровну между магазином и покупателем. Пример: если товар стоит 100 $ и в настройках магазина выбран вариант «за счет покупателя», то стоимость товара для оплаты будет составлять 103 $, если «за счет магазина» - 100 $, если «50% / 50%» - 101.50 $. |
Валюта |
[SELECT] |
Валюта, в которой магазин передает сумму платежа на сервис IKI. Название валюты отображается рядом с ценой при совершении платежа через сервис IKI |
Курс валюты |
float |
Курс валюты для вашего интернет-магазина относительно американского доллара США (USD). Поле может принимать дробные числа. |
Ваш текущий секретный ключ (secret_key) *2 |
Char(32) |
Секретный ключ – это строка символов, добавляемая к реквизитам платежа, высылаемым продавцу вместе с оповещением. Предназначен для проверки и формирования подписи данных. Эта строка используется для повышения надежности идентификации высылаемого оповещения. Содержание строки известно только сервису IKI и продавцу! Секретный ключ хранить обязательно в строгой секретности! |
Сгенерировать новый секретный ключ*2 |
—
|
В целях повышения безопасности секретный ключ (secret_key) может генерироваться только на стороне «INTERKASSA» для невозможности использования простых и коротких ключей. |
Примечание:
1 - Детально по методам передачи данных по HTTP смотрите тут: http://ru.wikipedia.org/wiki/HTTP
2 – Описание алгоритма формирования подписи см. ниже в разделе «Контрольная подпись данных о платеже»
