Взаимодействие платформы Flexibill.ru с проектами партнеров осуществляется по протоколу HTTP.
Скрипт-обработчик проекта вызывается, если транслитерированный текст SMS начинается с префиксов проекта.
Например, если пользователь отправляет SMS с текстом "привет" и у проекта есть префикс "pr" или "pri", то вызывается скрипт-обработчик данного проекта.
Скрипт - обработчик должен ответить в заданном формате в течение 3 секунд.
По умолчанию предполагается, что скрипт отвечает в кодировке CP1251.
Время ожидания ответа и кодировка могут быть изменены по запросу партнера.
uri?Date=?&MsgID=?&Operator=?&OperatorID=?&MSISDN=?&SN=?&Country=?&Text=?&test=?&cost_usd=?&cost_rur=?
| параметр | описание | пример |
| uri |
URI обработчика |
http://xxx.yyy.ru/sms.php |
| Date |
дата в формате YYYY-MM-DD HH:MI:SS |
2008-08-19 16:21:21 |
| MsgID |
уникальный идентификатор входящей SMS |
23207 |
| Operator |
короткое название оператора |
beeline |
| OperatorID |
цифровой идентификатор оператора |
117 |
| MSISDN |
номер абонента, пославшего запрос |
79289081234 |
| SN |
коротий номер |
1310 |
| Country |
Страна |
RUS |
| Text |
текст SMS |
hello, dear partner |
| cost_rur |
отчисления в RUR |
40.0 |
| cost_usd |
отчисления в USD |
1.60 |
Правила отправки смс в СНГ и Европе
Формат запроса от абонента в странах СНГ и Европе.
Белоруссия
7259 WM <сообщение>
7255 WM <сообщение>
7251 WM <сообщение>
7250 WM <сообщение>
Казахстан
3110 WM <сообщение>
4545 WM <сообщение>
5454 WM <сообщение>
Киргизия
4436 WM <сообщение>
8883 WM <сообщение>
8887 WM <сообщение>
Латвия
1897 WM1 <сообщение> , примерная стоимость = 1 евро
1897 WM2 <сообщение> , примерная стоимость = 2,2 евро
1897 WM3 <сообщение> , примерная стоимость = 3,6 евро
Литва
1337 WM1 <сообщение> , примерная стоимость = $1
1337 WM3 <сообщение> , примерная стоимость = $2,5
1337 WM5 <сообщение> , примерная стоимость = $3,5
Эстония
13015 WM <сообщение> , примерная стоимость = $3
13017 WM <сообщение> , примерная стоимость = $4
Израиль
4070 WM1 <сообщение> , примерная стоимость = 1 евро
4070 WM2 <сообщение> , примерная стоимость = 2 евро
4070 WM3 <сообщение> , примерная стоимость = 3 евро
4070 WM5 <сообщение> , примерная стоимость = 4 евро
Дополнительный префикс WM не зависит от регистра (не имеет значения маленькими буквами набрано сообщение или большими), а также не имеет значения, есть ли пробел после WM или его нет (мы рекомендуем использовать пробел).
Номера 1897, 4070 являются виртуальными. Стоимость сообщения для абонента зависит от префикса, который добавляется перед сообщением.
Например, если абонент отправляет сообщение на номер 4070 с текстом WM2 <сообщение>, то данное сообщение тарифицируется по ценам для номера 40702. А если на этот же номер отправлено сообщение с текстом WM5 <сообщение>, то оно тарифицируется по ценам для номера 40705.
У партнеров есть возможность получать уведомления об изменении статуса обработанных ранее сообщений. Для этого в настройках проекта необходимо задать URL обработчика для уведомлений по статусам.
Формат запроса по изменению статуса:
uri?MsgID=?&status=?
| параметр | описание | пример |
| uri |
URI обработчика |
http://xxx.yyy.ru/sms.php |
| MsgID |
уникальный идентификатор входящей SMS |
73354 |
| status |
Новый статус сообщения |
-68 |
Пример:
http://url.ru/sms.php?MsgID=23207&status=-68
Данный запрос уведомляет, что у сообщения с идентификатором 23207 изменен статус на "Неоплаченное" (-68).
Время между передачей запроса на оказание услуги и передачей запроса об изменении статуса может варьироваться в зависимости от
конкретного оператора, времени суток и других технических особенностей и может достигать 3-х суток.