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

Описание обработчика сервиса на стороне партнера

Наш сервис вызывает обработчик партнера следующим образом:
http://mysite.com/handler.php?date=2012-02-08+12%3A33%3A39&msg=792A51&msg_trans=792A51&operator_id=116&operator=megafon_severo_zapad&user_id=792193XXXXX&smsid=7528917&cost=97.85&cost_usd=3.24&cost_rur=97.85&test=0&num=4012 где
http://mysite.com/handler.php - это URL обработчика

Параметр Описание
date дата получения смс
msg оригинальный текст смс
operator_id ИД мобильного оператора в системе контент провайдера
operator имя мобильного оператора в транслите
user_id номер телефона абонента
smsid смс id в системе
cost доход партнера в рублях
num короткий номер
test тестовая ли смс (0 - не тестовая)

На стороне партнера обработчик должен вернуть код HTTP 200

Подписки

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

Для инициализации подписи следует выполнить GET запрос на адрес http://espay.ru/sms/subscription с параметрами:

Параметр Описание Пример
project_id ID проекта 1
skey Секретный ключ abcdef
phone Номер телефона 79037454678
operator Оператор. возможные значения: beeline, mts, megafon mts
ip ip адрес абонента 127.0.0.1
ua ua абонента Mozilla/5.0 (X11; Linux i686)

Ответом на такой вызов будет JSON:
{"id":"123456789","errors":[]}

Псевдо подписки

Псевдо подписка - это разновидность смс-оплаты без ребилов. Выглядит так: абонент вводит номер своего телефона на сайте, ему приходит сообщение с короткого платного номера с просьбой подтвердить действие путем отправки ответного смс. Абонент отвечает на смс, после чего с его счета списывается определенная сумма согласно выбранному тарифу.

Для инициализации псевдоподписи следует выполнить GET запрос на адрес http://espay.ru/sms/initPseudo с параметрами:

Параметр Описание Пример
project_id ID проекта 1
skey Секретный ключ abcdef
phone Номер телефона 79037454678
num Короткий номер 1200

Для некоторых проектов можно указать дополнительный параметр &text=СООБЩЕНИЕ_ДЛЯ_ПОЛЬЗОВАТЕЛЯ. В результате абоненту будет выслано не стандартное текстовое сообщение, а пришедшее при вызове.

Ответом на такой вызов будет JSON:
{"id":"123456789","errors":[]}

Мобильный платеж

На сайте магазина вводится номер телефона (на стадии заполнения профиля при регистрации или в форме заказа товара). Через агрегатора платежей магазин направляет запрос с суммой и номером телефона. Абоненту (покупателю в магазине) поступит SMS сообщение с данными о покупке: указывается товар, сумма к оплате. Если абонент соглашается с оплатой, то он отвечает на SMS. Система магазина получает запрос от агрегатора на успешное выполнение операции оплаты с помощью мобильного платежа.

Для инициализации платежа следует выполнить GET запрос на адрес http://espay.ru/sms/initMC с параметрами:

Параметр Описание Пример
project_id ID проекта 1
skey Секретный ключ abcdef
phone Номер телефона 79037454678
amount сумма платежа для абонента в рубляхn 10

Ответом на такой вызов будет JSON:

{"status":1}

В случае ошибки ответ будет содержать JSON-объект вида:

{"errors": ["Error1", "Error2"]}