–  увеличь прибыль! Услуги SMS-биллинга, SMS-платежи, SMS-оплата!
  Регистрация  
 
 

Документация

  1. Спецификация подключения к платформе
  2. Формат запроса
  3. Пример запроса на обработчик партнера
  4. Формат ответа
  5. Пример скрипта-обработчика на PHP
  6. Правила отправки смс в СНГ и Европе
  7. Особенности обработки SMS сообщений

Спецификация подключения к платформе

Взаимодействие платформы 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

Пример запроса на обработчик партнера

http://url.ru/sms.php?Date=2008-08-19 16:58:18&MsgID=23207&Operator=MTS& OperatorID=117
&MSISDN=79287922990&SN=1310&Text=hello& test=0&cost_usd=1.60&cost_rur=40.1


Формат ответа

MsgID=?
ResponseText=?

параметрописаниепример
MsgID уникальный идентификатор SMS 23207
ResponseText текст ответа vash parol dlya dostupa: 1432

Пример скрипта-обработчика на PHP

<?php
echo "MsgID={$_REQUEST[MsgID]}\nResponseText=hello user {$_REQUEST[MSISDN]}";
?>

Правила отправки смс в СНГ и Европе

Правила отправки смс в СНГ и Европе Формат запроса от абонента в странах СНГ и Европе.
Белоруссия
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.


Особенности обработки SMS сообщений

У партнеров есть возможность получать уведомления об изменении статуса обработанных ранее сообщений. Для этого в настройках проекта необходимо задать 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-х суток.

      НОВОСТИ

  30.12.2011
  Временное ограничение по Украине
  подробнее
  19.12.2011
  Изменения в алгоритме работы оператора Life
  подробнее
  26.11.2011
  Проблема с Украиной решена
  подробнее
 
 
О компании Тарифы Помощь Контакты В личный кабинет

      © 2009 ООО «Медиа интерактив»