Требования к интерфейсу провайдера
Интерфейс провайдера должен принимать запросы по протоколу HTTPS с IP адреса, предоставленного
компанией CITY-PAY.
Интерфейс должен обрабатывать параметры, передаваемые системой методом GET. Порядок
передачи параметров не имеет значения.
Интерфейс должен формировать ответ системе в формате XML (в кодировке UTF-8, если ответ
содержит символы национальных алфавитов).
Обмен информацией ведётся в режиме запрос-ответ, при этом задержка ответа не должна превышать
60 секунд, в противном случае система разрывает соединение по таймауту.
Если предполагаемое количество платежей на подключаемого провайдера ожидается достаточно
большим (более 10-ти платежей в минуту), желательно, чтобы интерфейс поддерживал многопоточный
обмен, до 10-20 одновременных соединений.
Провайдер возвращает ответ на запросы системе в формате XML со следующей структурой:
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<TransactionId></TransactionId>
<TransactionExt></TransactionExt>
<Amount></Amount>
<ResultCode></ResultCode>
<Comment></Comment>
</Response>
Response – тело ответа
TransactionId – уникальный номер транзакции в системе, который передается провайдеру
TransactionExt – уникальный номер операции пополнения баланса абонента в базе
провайдера (целое число длиной до 20 знаков). Этот элемент должен возвращаться провайдером после
запроса на пополнение баланса (запроса «pay»). При ответе на запрос проверки состояния абонента
(запрос «check») не возвращается
Amount – сумма платежа, передаваемая провайдеру (возвращается на запрос «pay»)
ResultCode – код завершения запроса
Comment – комментарий завершения операции (необязательный элемент)
