Протоколы взаимодействия с сервисами партнеров

Спецификация подключения к платформе SMS биллинга Openbill.ru

Подключение к платформе происходит с помощью скрипта-обработчика. При получении sms наша платформа отправляет смс по http протоколу на ваш скрипт- обработчик с параметрами этой sms. Ваш скрипт-обработчик должен ответить на запрос в заданном формате.

Протокол взаимодействия:

http://yoururl.ru/sms.php?date=2009-01-15+23%3A18%3A40&msg=abra&msg_trans=abra &operator_id=105&operator=mts&user_id=79119444291&smsid=232610&cost_rur=37.84&test=0&num=7250&country_alias=RU&skey=xxxxxx

date=2009-01-15 23:18:40 - дата и время получения sms системой
msg=abra - текст сообщения
msg_trans=abra - транслит текста сообщения
operator_id=105 - ID оператора
operator=mts - текстовое обозначение оператора
user_id=79119444291 - номер абонента
smsid=232610 - уникальный номер sms в системе
cost_rur=37.84 - ваша комиссия за данную sms
test=0 - параметр тестирования (0-настоящая sms, 1 - тестовая смс)
num=7250 - короткий номер на который отправлена sms
country_alias=RU - псевдоним страны абонента

skey=xxx - если в параметрах проекта задан "Секретный ключ", то при запросе формируется атрибут skey, который принимает значение md5(smsid.skey) (md5-хеш от конкатенации smsid и параметра "Секретный ключ")"

Если сервис предусматривает формирование регулярной подписки на услуги с возможностью атвоматического продления, то в запросе передаются дополнительные параметры:

sub_id=61 - внутренний идентификатор подписки - целое число
sub_expire=2010-04-04 19:21:08 - дата окончания периода подписки
sub_action=CREATE - CREATE => создание новой подписки, UPDATE => продление существующей подписки

Ответ на запрос:
Вы должны ответить нам одной строкой.
Пример:
Vash parol - hjbvs783r

Правила обработки SMS с МТ тарификацией:
На данный момент это действует только для оператора Киевстар, Украина.

При получении от оператора сообщения о том, что ответная СМС не доставлена до абонента, и соотвественно не будет оплачена, система OpenBill вызывает сервис партнера, чтобы уведомить его об этом. Данный механизм позволяет сделать откат оказываемой абоненту услуги.

Формат оповещения сервиса партнера:
http://yoururl.ru/sms.php?action=status&smsid={ID}&status=rejected

Пример:
http://funky.service.us/sms.php?action=status&smsid=9997788&status=rejected