Подключение SMS-рассылок через Robokassa

13.11.2020

Подключив сервис SMS-сообщений, вы сможете оперативно получать информацию о платежах – и уведомлять клиентов о статусе заказов, отправляя до 3-х сообщений после каждой покупки.

Как подключиться, чтобы получать уведомления о заказах?

1. Активируйте ваш магазин. Активация проходит в 2 этапа. Первая – активация приема платежей: начнем с нее. Если вы закончили с настройками, переходите на главную страницу, в раздел «Мои магазины» - «Настройки» и отправляйте заявку на активацию приема платежей. Мы одобрим вашу заявку в течение суток – а если возникнут какие-либо проблемы, всегда поможем.


Для активации вывода нужно будет отправить 1 тестовый рубль по нашим реквизитам в разделе «Документы и шаблоны». Если платеж прошел без проблем, мы откроем вывод средств в течение суток.

2. Зайдите в главное меню: ваш нужен раздел «SMS-рассылки».

3. Выберите магазин из выпадающего списка.
4. Зайдите в его «Технические настройки» и добавьте номер телефона, на который хотите получать уведомления об оплате заказов. Готово!

Как подключиться, чтобы информировать покупателей?

1. Активируйте ваш магазин – как это сделать, мы описывали выше.
2. Далее вам необходимо подключить к магазину сервис, осуществляющий отправку сообщений. Это платная услуга – и составляет 2,5 рубля за каждое отправленноеSMS-сообщение: пожалуйста, следите, чтобы на вашем счету было достаточно средств, иначе уведомления не будут отправлены. За само подключение оплаты мы не берем.

Сам сервис расположен по адресу:https://services.robokassa.ru/SMSи принимает запросы методомGET. Пример такого запроса и коды ошибок для этого интерфейса можно посмотреть ниже.

Ссылка:
https://services.robokassa.ru/SMS/?login=demo_merchant&phone=79051234567&message=All%20work%20fine!&signature=6f0ed2dbb08da5a50124a3ee0581a7f6

Коды ошибок:

0–запрос обработан успешно;

1– отсутствует параметр запроса;

2– указанный партнер не найден;

3– партнер неактивен;

4– отправка SMS-сообщений для данного партнера недоступна (партнер не активировал данную услугу в Личном кабинете);

5– в данный момент отправка SMS-сообщенийуказанным партнером невозможна;

6– превышен лимит SMS-сообщений;

1000– неверная подпись запроса;

9999– внутренняя ошибка.

Расшифровка параметров запроса

Login
Это строка, содержащая Ваш Идентификатор магазинав Личном кабинете.

Phone
Строка, содержащая номер телефона в международном формате без символа «+» (79051234567).

Message
Строка в кодировке UTF-8 длиной до 128 символов, содержащая текст отправляемого SMS.

Signature
Строка, содержащая электронную подпись — хеш, рассчитываемый при отправке SMS-сообщения. Алгоритм расчётаможно посмотреть в «Технических настройках» магазина. Электронная подпись рассчитывается от строки, содержащей следующие параметры,разделенные символом ':'login:phone:message:Пароль#1,где Пароль#1—этот тот пароль, который вы придумали на этапе заполнения раздела«Технические настройки»). Внимание: не путайте параметр Signature с параметром SignatureValue.

Давайте посмотрим, как все это выглядит, на простом примере.

Допустим, необходимо отправить SMS для магазина с логином demo_merchant на номер 79051234567с текстом «All work fine!».

Пароль #1 находится в Личном кабинете клиента в Технических настройкахданного магазина. Например, значение Пароль #1будет Password1drowssaP.

Таким образом, строка для подписи будет выглядеть так:demo_merchant:79051234567:All work fine!:Password1drowssaP.

Подпись MD5 такого запроса будет следующей: 6f0ed2dbb08da5a50124a3ee0581a7f6.

Подпись SHA1 будет такой: 271f256595a8adc63438a3d75e14c20bc3fabe85.

Расшифровка значений возвращаемых данных

Result
Это значение логического типа, указывающее на общий успех или неуспех обработки запроса. Внимание: не путайте параметр с параметром ResultURL.

Count
Целочисленное значение, указывающее наколичество SMS, доступное после этого запроса(само значение заполняется только в случае успешного исполнения запроса).

errorCode
Это целочисленное значение кода ошибки обработки (0 – успешная обработка).

errorMessage
Текстовое описание ошибки, возникшей в процессе обработки запроса.

Запрос можно считать успешно исполненным, если поле result=true и errorCode=0.

Это вся необходимая информация. А если необходима помощь –мы всегда на связи!