Экспресс-платежи
Цель:
Дать возможность владельцам карточек платежной системы NCC оплачивать услуги телефонных и коммунальных организаций в банкоматах платежной системы без предварительных заявлений и договоров с немедленным пополнением абонентского или лицевого счета.
Описание услуги:
В меню банкомата добавлен пункт экспресс платежи, по выбору этого пункта меню высвечивается перечень сервисных организаций, для которых реализована эта услуга. После выбора конкретной организации запрашивается идентификационный код клиента сервисной организации (для телефонных компаний номер телефона). После ввода идентификационного кода выполняется запрос к сервисной организации. Ответ должен содержать информацию, позволяющую клиенту проверить правильность введенного кода (для клиентов СМАРТС первые буквы фамилии имени отчества). Ответ не должен содержать какой-либо информации о личности клиента в целях безопасности. Ответ может содержать наряду с информацией идентифицирующей клиента состояние абонентского или лицевого счета. Если клиент подтверждает полученную от предприятия сервиса информацию, он вводит сумму, на которую требуется выполнить платеж. Сумма платежа находится в пределах оговоренных договором между NCC и предприятием. После проведения платежа данная сумма списывается с карточного счета клиента, а информация о платеже передается предприятию сервиса для учета на лицевом или абонентском счете.
Файл отчета о проведенных платежах формируются во время ночной обработки в процессинговом центре NCC, а периодичность и способ доставки предприятию оговаривается договором. Формат данного файла приведен в приложении 1. Эти отчеты должны быть использованы для проверки проведенных платежей, на основании проверки возможна корректировка этих платежей. Сравнение платежей производится по содержимому поля 9 в файле отчета и по значению тэга reference_number в сообщении при выполнении экспресс-оплаты.
Деньги предприятию переводятся по графику расчетов, оговоренному в договоре между NCC и предприятием.
Предприятие, заключающее договор с NCC, должно принимать сообщения о платежах клиентов в круглосуточном режиме.
Дополнительные сведения о формате сообщений, используемых при обмене информации, способе связи и т. д. предоставляются и оговариваются с соответствующими специалистами предприятия.
Формат сообщений
Запрос информации о клиенте (пример 1):
Наименование | Назначение | Примечание |
smpay_client_req | Головной тэг. Внутри него представлен список параметров | |
requester_id | Идентификатор запрашивающей стороны (NCC) | |
responder_id | Идентификатор отвечающей стороны (SMARTS-GSM) | |
transaction_id | Идентификатор транзакции | |
client_id | Идентификатор клиента (№телефона) |
Передача информации о клиенте (пример 1):
Наименование | Назначение | Примечание |
smpay_client_resp | Головной тэг. Внутри него представлен список параметров | |
requester_id | Идентификатор запрашивающей стороны (NCC) | Поля копируются из smpay_client_req |
responder_id | Идентификатор отвечающей стороны (SMARTS-GSM) | |
transaction_id | Идентификатор транзакции. | |
client_id | Идентификатор клиента (№телефона) | |
result | Результат выполнения запроса | TRUE – норма FALSE – ошибка(нет такого абонента …) |
client_info | Информация о клиенте | |
message | Информация, выводимая на экране банкомата при значении тэга result - FALSE, описывающая причину отказа | Необязательный тэг. MAX длина сообщения 38 символов. Допускается передача только русских букв и спец. символов (кавычки, скобки и т. д.) |
Запрос на выполнение платежа (пример 2):
Наименование | Назначение | Примечание |
smpay_payment_req | Головной тэг. Внутри него представлен список параметров | |
requester_id | Идентификатор запрашивающей стороны (NCC) | |
responder_id | Идентификатор отвечающей стороны (SMARTS-GSM) | |
transaction_id | Идентификатор транзакции | |
reference_number | Номер транзакции | |
client_id | Идентификатор клиента (№телефона) | |
summ | Сумма платежа | В копейках |
Результат выполнения платежа (пример 2):
Наименование | Назначение | Примечание |
smpay_payment_resp | Головной тэг. Внутри него представлен список параметров | |
requester_id | Идентификатор запрашивающей стороны (NCC) | Поля копируются из smpay_payment_req |
responder_id | Идентификатор отвечающей стороны (SMARTS-GSM) | |
transaction_id | Идентификатор транзакции | |
reference_number | Номер транзакции | |
client_id | Идентификатор клиента (№телефона) | |
summ | Сумма платежа | В копейках |
result | Результат выполнения платежа | TRUE – норма FALSE – ошибка |
client_info | Информация о клиенте (Инициалы) | |
message | Информация, выводимая на экране банкомата при значении тэга result-FALSE, описывающая причину отказа | Необязательный тэг. MAX длина сообщения 38 символов. Допускается передача только русских букв и спец. символов (кавычки, скобки и т. д.) |
Все сообщения ограничиваются 0х03. Пример 1
Запрос NCC у SMARTS информации об абоненте телефона 407415:
<smpay_client_req>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<client_id>407415</client_id>
</smpay_client_req>
Ответ SMARTS.
Номер 407415 зарегистрирован и на нем возможен прием платежей. Инициалы абонента, на который зарегистрирован данный номер “П. В.И.”:
<smpay_client_resp>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<client_id>407415</client_id>
<result>TRUE</result>
<client_info>П. В.И.</client_info>
</smpay_client_resp>
Либо платеж по номеру 407415 не возможен:
<smpay_client_resp>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<client_id>407415</client_id>
<result>FALSE</result>
<client_info></client_info>
<message>Абонент не найден</message>
</smpay_client_resp>
Пример 2
Запрос NCC у SMARTS об оплате за номер 407415 платежа в сумме 1000коп:
<smpay_payment_req>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<reference_number></reference_number>
<client_id>407415</client_id>
<summ>1000</summ>
</smpay_payment_req >
Ответ SMARTS.
Оплата за номер 407415 в сумме 1000коп. принята и проведена по счету клиента:
<smpay_payment_resp>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<reference_number></reference_number>
<client_id>407415</client_id>
<summ>1000</summ>
<result>TRUE</result>
<client_info>П. В.И.</client_info>
</smpay_payment_resp>
Оплата за номер 407415 в сумме 1000коп. не принята:
<smpay_payment_resp>
<requester_id>NCC</requester_id>
<responder_id>SMARTS-GSM</responder_id>
<transaction_id>001001</transaction_id>
<reference_number></reference_number>
<client_id>407415</client_id>
<summ>1000</summ>
<result>FALSE</result>
<client_info></client_info>
<message>Техническое обслуживание</message>
</smpay_payment_resp>
Приложение 1
Формат файла оплаченных счетов предоставляемого NCC предприятию сервиса
№ | Наименование | Формат | Описание поля |
1. | Код процессора | 3N | Код процессора. Постоянное значение для предприятия сервиса. |
2. | Номер рабочего места | 8N | Номер рабочего места в системе NCC. Может иметь несколько значений. Например, одно значение для экспресс-оплаты, другое для выставленных счетов |
3. | Шифр плательщика | 20AN | Уникальный идентификатор клиента у получателя платежа (№телефона, код квартиросъемщика и т. д.) |
4. | Номер счета | 16N | Если получатель платежа выставляет номерные счета, то данное поле содержит номер оплаченного счета, иначе содержит произвольный номер. |
5. | Сумма платежа | 12N | Сумма оплаченная (в копейках без разделителя) |
6. | Дата оплаты счета | ггггммдд | Дата оплаты счета |
7. | Время оплаты счета | ччмм | Время оплаты счета |
8. | Описание счета | 40AN | Свободная информация. Поле может быть пустым. Пример: “Иванов д.1 кв.11”. |
9. | Номер операции | 20N | Ссылочный номер операции (содержит: 8 знаков - код рабочего места, где была произведена оплата и 12 знаков - номер чека – квитанции). |
Примечание.
При работе в системе экспресс-оплаты содержимое данного файла соотносится с содержимым сообщений при выполнении платежа следующим образом:
- содержимое тэга client_id сообщения передается в поле 3;
- содержимое тэга reference_number сообщения передается в поле 9.
