Описание

Введение

Данная документация освящает вопросы программной автоматизации приема платежей. Предполагается, что читатель ознакомлен с базовой документацией.

Описание механизма автоматизации

Механизм автоматизации заключается в регистрации заказа в системе Telegate и получении сайтом уведомлений об оплате заказа. После оплаты заказа Telegate посылает запрос на STATUS URL. STATUS_URL, тип запроса (POST или GET) указывается в настройках магазина (см. Базовую документацию).

Получение информации по  платежным методам.

Если вам необходимо получать данные по платежным методам в виде xml, воспользуйтесь интерфейсом по адресу:
http://telegate.ru/secure/order.php?xml

Интерфейс имеет два обязательных параметра:

Параметр	Описание	Пример
WS_ID	Идентификатор торговой точки	3452
AMOUNT	Сумма платежа	250

На выходе будет сгенерирован xml файл для вашего текущего сайта и данной суммы (куда входят все текущие комиссии системы) для каждого платежного метода:

<root>
    <payment_methods>
    <payment_method>
     <code>ANELIK_RUB</code>
     <logo>http://telegate.ru/img/p_logos/60245qkaf6.gif</logo>
     <name>Anelik (RUB)</name>
     <currency>Российский рубль</currency>
     <currency_code>RUR</currency_code>
     <currency_symbol>руб.</currency_symbol>
     <amount>135.49</amount>
    </payment_method>
...

Подробное описание полей ноды payment_method:

Параметр	Описание	Пример
code	код платежного метода	ANELIK_RUB
logo	урл иконки платежного метода	http://telegate.ru/img/p_logos/60245qkaf6.gif
name	имя платежного метода	Anelik (RUB)
currency	название валюты	RUR
currency_code	код валюты	Российский рубль
currency_symbol	символическое название валюты	руб.
amount	сумма платежа с комиссией системы	135.49

Создание формы заказа

Регистрация заказа в системе Telegate происходит при помощи HTML-формы
Формы заказов делятся на 2 типа:

1. Форма заказа определенного товара
2. Форма с произвольной суммой

Форма заказа определенного товара должна использоваться в том случае, если клиенту предлагается купить определенный товар, зарегистрированный в платежной системе Telegate. Процедура создания товара описана в базовой документации.
Форма с произвольной суммой используется с целью приема платежа за нестандартный товар или услугу, цена которого заранее неизвестна. Для этой формы вы можете воспользоваться xml интерфейсом, для получения суммы платежа по конкретному платежному методу. (раздел:Получение информации по  платежным методам.)

Пример формы заказа определенного товара:

<form action="http://www.telegate.ru/secure/order.php" method="post">
<input type="hidden" name="PRODUCT_ID" value="53">
<input type="hidden" name="INV_ID" value="123">
<input type="hidden" name="COMMENTS" value="Оплата заказа № 123">
<input type="hidden" name="PAY_METHOD" value="">
<input type="hidden" name="USER_FIRST_NAME" value="">
<input type="hidden" name="USER_SECOND_NAME" value="">
<input type="hidden" name="USER_LAST_NAME" value="">
<input type="hidden" name="USER_COUNTRY" value="">
<input type="hidden" name="USER_CITY" value="">
<input type="hidden" name="USER_ZIP" value="">
<input type="hidden" name="USER_ADDRESS" value="">
<input type="hidden" name="USER_PHONE" value="">
<input type="hidden" name="USER_EMAIL" value="">
<input type="submit" value="Оплатить" title="Оплатить с помощью платежной системы TELEGATE">
</form>

Пример формы с произвольной суммой:

<form method="post" action="http://www.telegate.ru/secure/order.php">
<input type="hidden" name="WS_ID" value="3406">
<input type="hidden" name="AMOUNT" value="250">
<input type="hidden" name="INV_ID" value="123">
<input type="hidden" name="COMMENTS" value="Оплата заказа № 123">
<input type="hidden" name="PAY_METHOD" value="">
<input type="hidden" name="USER_FIRST_NAME" value="">
<input type="hidden" name="USER_SECOND_NAME" value="">
<input type="hidden" name="USER_LAST_NAME" value="">
<input type="hidden" name="USER_COUNTRY" value="">
<input type="hidden" name="USER_CITY" value="">
<input type="hidden" name="USER_ZIP" value="">
<input type="hidden" name="USER_ADDRESS" value="">
<input type="hidden" name="USER_PHONE" value="">
<input type="hidden" name="USER_EMAIL" value="">
<input type="submit" name="submit" value="Оплатить!" title="Сделать оплату при помощи платежной системы TELEGATE!">
</form>

Таблица с пояснениями к полям формы:

Название	Описание	Пример
WS_ID	ID сайта	4652
PRODUCT_ID	ID товара. Можно узнать в списке товаров сайта (заполняется только при использовании формы заказа определенного товара).	43
AMOUNT	Сумма заказа в валюте сайта (только при использовании формы с произвольной суммой).	250
INV_ID	ID заказа в системе магазина	53
COMMENTS	Комментарии к заказу (текст)	Оплата заказа № 53
PAY_METHOD	Желаемый способ оплаты. Если параметр задан, то пользователю будет доступен на выбор только этот способ оплаты. Примите во внимание, что установка этого параметра не гарантирует то, что пользователь будет использовать именно указанный способ оплаты. Возможные варианты этого параметра даны в разделе Коды методов платежей
USER_FIRST_NAME	Имя плательщика (не обязательно к заполнению)	Иван
USER_SECOND_NAME	Отчество плательщика (не обязательно к заполнению)	Иванович
USER_LAST_NAME	Фаилия плательщика (не обязательно к заполнению)	Иванов
USER_COUNTRY	Страна плательщика	Россия
USER_CITY	Город плательщика	Москва
USER_ZIP	Почтовый код плательщика	195000
USER_ADDRESS	Адрес плательщика	ул. Ленина, дом 1
USER_PHONE	Телефон плательщика	+74951234567
USER_EMAIL	E-mail плательщика	customer@mail.com

Сallback от Telegate

После успешной оплаты заказа, Telegate отправит запрос на STATUS_URL с уведомлением. На этот запрос, в случае успеха, надо ответить словом ОК, если данные не сошлись по каким-либо причинам отвечать не нужно. Ниже указана таблица с полями отсылаемыми на STATUS_URL с их описанием:

Название	Описание	Пример
SYS_TRANS_ID	ID заказа в системе Telegate	3452
AMOUNT	Сумма заказа в валюте сайта	250
CURRENCY	Валюта сайта	USD
DATE_INT	Дата и время оплаты заказа в виде unix timestamp	1210259314
PAY_METHOD	Способ оплаты	WMZ
USER_FIRST_NAME	Имя плательщика	Иван
USER_SECOND_NAME	Фамилия плательщика	Иванов
USER_LAST_NAME	Отчество плательщика	Иванович
USER_COUNTRY	Страна плательщика	Россия
USER_CITY	Город плательщика	Москва
USER_ZIP	Почтовый код плательщика	195000
USER_ADDRESS	Адрес плательщика	ул. Ленина дом 1
USER_PHONE	Телефон плательщика	+74951234567
USER_EMAIL	E-mail плательщика	customer@mail.com
USER_IP	IP плательщика	127.0.0.1
HASH	Цифровая подпись запроса. Используется для проверки данных пришедших в запросе. Подробнее описано в разделе Формирование подписи	d41d8cd98f00b204e9800998ecf8427e
INV_ID	ID заказа в системе магазина	1244

Коды методов платежей.

Метод платежа	Код
Moneygram	MONEYGRAM
Банковский счет (RUB)	BANK_RUB
Western Union (USD)	WU_USD
Contact (USD)	CONTACT_USD
Аллюр (RUB)	ALLUR_RUB
Аллюр (USD)	ALLUR_USD
Anelik (RUB)	ANELIK_RUB
Банкомат / карта	BANKOMAT_KARTA
Migom (RUB)	MIGOM_RUB
Migom (USD)	MIGOM_USD
Касса ВТБ24	VTB
Moneymail	MMAIL
E-Gold	EGOLD
Терминалы Элекснет	EL_NAL
Contact (RUB)	CONTACT_RUB
Western Union (RUB)	WU_RUB
Сбербанк Блиц	SBRF_BL
WMU	WMU
WMZ	WMZ
WMR	WMR
Почта России	RU_POSTOFFICE
Сбербанк квитанция	SBRF

Формирование подписи.

Подпись запроса формируется следующим образом:

Параметры передаваемые на STATUS_URL конкатенируются в следующей последовательности:

SYS_TRANS_ID+ INV_ID+AMOUNT+CURRENCY+ PAY_METHOD+WEBSITE_SECRET_WORD, где WEBSITE_SECRET_WORD — секретное слово, установленное в настройках сайта.

От полученной строки берется md5. Результирующая строка будет являться цифровой подписью.