ИНСТРУКЦИЯ ПО РАБОТЕ С SMS

ИНСТРУКЦИЯ ПО РАБОТЕ С SMS-ПРОГРАММОЙ ПО ПРОВЕДЕНИЮ
ПЛАТЕЖЕЙ
При работе с программой смс-платежей доступны следующие функции:

Проведение платежей

Проверка статуса платежей

Отправка запроса на отмену платежа

Получение статистики платежей
При выполнении любой вышеописанной операции необходимо отправлять смс-запрос в
соответствующем формате на номер 9091.
Проведение платежа
Для проведения платежа отправляется смс в виде:
0772123456*5
где
0772123456 - номер телефона, на который проводится платеж
5 – сумма платежа
После отправки сообщения, на телефон должно прийти смс-уведомление о принятии
платежа к обработке с указанием номера телефона и суммы платежа для оплаты, а также
присвоенного ему номера (номер транзакции). Например:
T: 0772123456,,N: 13157160,S:5,K1:0,K2:2. Plateg obrabatyvaetsya
где
T: 0772123456 – номер телефона, на который проводился платеж
N:13157160 – номер платежа (номер транзакции)
S:5 – сумма платежа
K1:0 – сумма комиссии клиента
K2:2 – сумма комиссии агента
Plateg obrabatyvaetsya – статус состояния обработки платежа
После обработки платежа приходит уведомление с результатом его проведения (платеж
прошел или не прошел). Например:
T: 0772123456,,N: 13157160,S: 5,K1:0,K2:0. Plateg OK
где
T: 0772123456 – номер телефона, на который проводился платеж
N:13157160 – номер платежа (номер транзакции)
S:5 – сумма платежа
K1:0 – сумма комиссии клиента
K2:2 – сумма комиссии агента
Plateg OK – статус платежа, означающий, что платеж успешно проведен
1
В том случае, если платеж не был проведен, текст полученного сообщения будет другим
(в зависимости от причины, по которой платеж не был проведен).
Проверка статуса платежа за текущий день
Для проверки статуса платежа за текущий день отправляется смс в виде:
?0772123456*5
где
«?» – означает команду проверки статуса платежа
0772123456 – номер телефона, на который был проведен платеж
5 – сумма платежа
В результате выполнения данного запроса на телефон придет смс-ответ, содержащий в
себе статусы всех найденных платежей на указанный номер с указанной суммой,
проведенных этой точка за текущие сутки. Например:
T: 0772123456, S:5
N 13158322, D: 03.09.14 13:08, Status: Ok
N 13157160, D:05.09.14 12:21, Status: Osh. Platej otmenen
K1:0, K2:2
где
T: 0772123456 – номер телефона, на который производились платежи
S: 5 – сумма платежей
N 13158322 – номер второго платежа
D: 03.09.14 13:08 - дата и время второго платежа
Status: Ok – статус второго платежа
K1:0- размер клиентской комиссии за 2-й платеж
K2:2 – размер агентской комиссии за 2-й платежN 13157160 – номер первого
платежа
D:05.09.14 12:21 – дата и время первого платежа
Status: Osh. Platej otmenen – статус первого платежа
K1:0- размер клиентской комиссии за 1-й платеж
K2:2 – размер агентской комиссии за 1-й платеж
Проверка статуса платежа за прошедший день
Для проверки статуса платежа, проведенного в один из предыдущих дней, отправляется
смс в виде:
?0772123456*5 03.09.14
где
«?» – означает команду проверки статуса платежа
0772123456 – номер телефона, на который был проведен платеж
5 – сумма платежа
03.09.14 – дата, когда был проведен платеж, статус которого необходимо
проверить (вводится в формате дд.мм.гг (день, месяц, год). В данном случае
проверяется статус платежа за 3 сентября 2014 г.
В результате выполнения данного запроса на телефон придет смс-ответ, содержащий в
себе статусы всех найденных платежей на указанный номер с указанной суммой,
2
проведенных этой точка за указанную дату. Формат ответа и смысл соответствующих
полей идентичен результату запроса статуса платежа за текущий день.
Запрос на отмену
Для отправки запроса на отмену платежа отправляется смс в виде:
-0772123456*5
где
«-» - означает команду отмены платежа
0772123456 – номер телефона платежа для отмены
5 – сумма платежа
Внимание! Для отмены доступны только платежи, проведенные за текущие сутки!
Если платежей на поданный номер для отмены и на указанную сумму было несколько в
течение текущих суток, то для отмены будет принят более ранеий по времени платеж,
проведенный этой точкой. При отправке еще одного запроса на отмену платежа с таким
же номером и суммой, для отмены будет принят следующий по времени подходящий
платеж и т.д. После обработки запроса на отмену будет получено смс-уведомление с
результатом отмены платежа (платеж был отменен или не отменен. Если платеж не смог
быть отменен, то будет указана причина, по которой он не был отменен).
Получение статистики за текущий день
Для получения статистики за текущий день отправляется смс в виде:
@
где
@ - означает команду получения статистики платежей
В результаты ответа на такой запрос будет получен смс-ответ, содержащий в себе
количество и сумму успешно проведенных платежей этой точкой за текущие сутки,
размеры комиссий, а также текущий баланс точки.
Za den`: 2 platehey, na summu 11.K1:0, K2: 4. Itogovaya summa: 15. Balans 144
где
2 – количество успешно проведенных платежей за текущие сутки
11 – общая сумма успешно проведенных платежей
K1:0 – общая сумма комиссий клиента за успешно проведенные платежи
K2:2 – общая сумма комиссий агента за успешно проведенные платежи
Itoglovaya summa: 15 – итоговая сумма, списанная с баланса за текущие
сутки
144 – текущий баланс точки
Получение статистики за один определенный день
Для получения статистики за какой-либо прошедший день, отправляется смс в виде:
@ 03.09.14
где
@ - означает команду получения статистики платежей
3
03.09.14 – дата, за которую будет получена статистика платежей, (вводится в
формате дд.мм.гг (день, месяц, год). В данном случае будет отправлена
статистика платежей за 3 сентября 2014 г.
В результаты ответа на такой запрос будет получен смс-ответ, содержащий в себе
сведения об успешно проведенных платежей этой точкой за указанный день, размеры
комиссий, а также текущий баланс точки.
Za 03.09.14: 2 platehey, na summu 11.K1:0, K2: 4. Itogovaya summa: 15. Balans 144
Ответ означает, что в ответе содержатся данные о платежах за указанную дату (в данном
случае за 3 сентября 2014 г). Смысл остальных полей ответа идентичны тем же полям в
ответе по статистике за текущий день (см. выше).
Получение статистики за несколько дней
Для получения статистики за какой-либо период прошедших дней, отправляется смс в
виде:
@ 03.09.14 05.09.14
где
@ - означает команду получения статистики платежей
03.09.14 – начальная дата периода, за который будет получена статистика
платежей, (вводится в формате дд.мм.гг (день, месяц, год).
05.09.14- конечная дата периода, за который будет получена статистика
платежей (вводится в формате дд.мм.гг (день, месяц, год).
В данном случае будет отправлена статистика платежей за период с 00:00:00 3-го сентября
по 23:59:59 5-го сентября 2014 г.
При этом вторая дата должна быть обязательно больше, чем первая дата, иначе будет
отправлен ответ с ошибкой.
В результаты ответа на такой запрос будет получен смс-ответ, содержащий в себе
сведения об успешно проведенных платежей этой точкой за указанный период дней, а
также текущий баланс точки.
Za period s 03.09.14 po 05.09.14: 2 platehey, na summu 11.K1:0, K2: 4. Itogovaya summa: 15.
Balans 144
Означает, что в ответе содержатся данные о платежах за указанный период (в данном
случае с 3-го сентября по 5 сентября 2014 включительно). Смысл остальных полей ответа
идентичны тем же полям в ответе по статистике за текущий день (см. выше).
ВАЖНО!!!
В одном смс допустимо отправлять на оплату до 4-х платежей. При этом платежи
отделаются друг от друга символом «#». Например:
0772123456*10#0555987654*20
Ставить символ «#» перед первым платежом и после последнего необязательно.
4
Если при отправке смс на оплату сразу нескольких платежей для одного из платежа будет
допущена ошибка в формате ввода, то этот платеж не будет проведен (на него придет
сообщение о неверном формате ввода). Другие платежи из этого смс-сообщения будут
приняты к обработке.
Внимание! Недопустимо в одном смс запросе несколько платежей на отмену или
проверку статусов. Для них действует правило: одна смс – один запрос.
Недопустимо также в одной смс отправлять разнородные запросы, например, на
проведение платежа и на отмену. В случае отправки таких сообщений запросы на
проведение платежей будут приняты к обработке, тогда как иные запросы, содержащиеся
в данном смс (отмена платежа, проверка статуса, получение статистики) будут
проигнорированы и на них будут отправлены ответы о неверном формате запроса.
Внимание! Для всех ранее перечисленных запросов. Если отправляемое смс-сообщение
будет содержать недопустимые символы, сообщение составлено в неверном формате (или
же в неверном формате будет часть сообщения) в ответе на это смс-сообщение будет
содержаться фрагмент, в котором была допущена ошибка при вводе.
Во время отключения Компанией приема платежей по какой-либо услуге по техническим
причинам при попытке проведения платежей по ней будет приходит смс-уведомление о
временной приостановке платежей по данной услуге.
Если для какой-то точки, ее субагента или же агента не была назначена какая-то услуга, то
при попытке проведения платежа по ней будет приходить смс-уведомление о
недоступности этой услуги.
Также на попытку проведения платежа может прийти один из следующих ответов:
Ошибка в формате команды (Oshibka v formate komandy): - неверно составлен формат
смс-запроса. Возможно, были пропущены какие-либо символы или введены лишние. При
получении данного сообщения в конце приводится текст отправленной команды, в
котором была допущена ошибка.
Ошибка при проведении платежа, отправьте платеж еще раз (Oshibka pri provedenii
plateja, otpravte platej eshe raz) – при проведении платежа возникла техническая ошибка,
и платеж не был проведен. При необходимости отправить платеж заново.
Платёж не найден для отмены (platej ne naiden dlya otmeny) – данное сообщение может
прийти в качестве ответа на запрос на отмену платежа. Этот ответ означает, что за
текущие сутки не было произведено ни одного платежа на реквизит и сумму, указанные в
отправленном запросе на отмену
Не найдена услуга по префиксу (ne naidena usluga po prefiksu) – префикс,
содержащийся в номере телефона (реквизита) на проведение платежа не соответствует ни
одному из сотовых провайдеров, платежи по которым доступны в системе
Прием по данной услуге временно приостановлен (priem po dannoi usluge vremenno
proistanovlen) – по техническим причинам прием платежей по услуге, на которую был
произведен платеж, временно приостановлен
5
Услуга не доступна (usluga ne dostupna) – отсутствует разрешение на прием платежей по
данному поставщику для точки (или ее агента/субагента), с которой был произведен
данный платеж
Не опознан номер команды (ne opoznan nomer komandy) – неверно составлен формат
смс-закроса
Сумма для осуществления операции равна нулю (summa dlya osushestvleniya
ooperatsii ravna nulyu) – сумма к оплате не может равняться нулю.
Сумма для осуществления операции больше предела в (sum dlya osushestvleniya
operatsii bolshe predela v) – сумма платежа превышает максимально разрешенную сумму
Неизвестный канал обработки (nevernyi kanal obrabotki) – внутренняя ошибка системы
Ошибка при обработке платежа (oshibka pri obrabotke plateja) – при проведении
платежа произошла какая-либо ошибка. Для получения достоверной информации
необходимо проверить статус платежа.
Дубликат запроса на платёж (dublikat zaprosa na platej) – повторный платеж на один и
тот же реквизит и ту же сумму в течении определенного промежутка времени (в данный
момент данный промежуток составляет 30 мин).
Ошибка: дата 1 больше даты 2 в тексте (Oshibka: data 1 bol`she daty 2 v tekste):
ошибка в указании периода, для которого делается запрос получения статистики по
платежам.
6