смс сервис
сервисы
Смс агрегатор
 
Пример скрипта обработчика Протокол обмена данными с API (услуга СМС ПОДПИСКА)
версия 1.6, редакция: 26.08.2015

Техническая документация: Web API

 

ИНИЦИАЛИЗАЦИЯ ПОДПИСКИ

Инициализация подписки осуществляется посредством отправки HTTP-запроса методом GET или POST по адресу
https://cp.payy.ru/subscription/get.php



В запросе передаются следующие параметры:
Переменная Описание переменной Тип Пример значения
 id  ID проекта, одобренного в личном кабинете Партнера integer 12345
 number  Мобильный номер Абонента string 79859694999
 param  Массив данных, направленный Партнером при инициализации подписки array param=array('prm' => 'ind')
 method  Метод подписки string open
 md5  Дайджест запроса string d2c12fd82ddaa2da1e675c70228d33a1


Дайджест запроса рассчитывается из параметров запроса, которые задаются в строго указанном порядке:
md5 = id + number + secret_key;
Secret_key - секретное слово, указанное в личном кабинете.

В случае успешного проведения операции, Абонент переадресовывается на страницу Оператора, для подтверждения подписки.
После подтверждения подписки Абонент перенаправляется на страницу Партнера, указанную в личном кабинете.

 

В случае ошибки, передается код ошибки с кратким описанием. Возможные коды ошибки и их описание:

Номер ошибки Название ошибки Описание ошибки
400 Unknown id  Отсутствует, либо некорректно передан ID проекта, одобренного в личном кабинете Партнера
401 Unknown number  Отсутствует, либо некорректно передан номер Абонента
403 Unknown subscription  Подписка уже имеется на номере
404 Unknown md5  Не передан, либо неверный параметр дайджеста запроса
405 Service Unavailable  Сервис отсутствует, либо не одобрен/не активен
406 Error number  Невозможно определить Оператора Абонента / некорректный номер телефона Абонента
--- Unknown error  Сервисная ошибка

 

Дополнительная справочная информация:

Коды (ID) и валюты стран

Коды (ID) и валюты стран Коды (ID) и валюты стран
Коды (ID) операторов Коды (ID) операторов Коды (ID) операторов


 

 

 

УВЕДОМЛЕНИЕ ПАРТНЕРА ОБ ИЗМЕНЕНИИ СТАТУСА ПОДПИСКИ

В случае успешного проведения транзакции, на result-url Партнера отправляются следующие данные методом POST:
Переменная Описание переменной Тип Пример значения
 status  Статус подписки - create / update *
 pay  Доход Партнера (отчисления в валюте страны) float 0.00
 currency  Валюта страны string RUB
 subscription  ID подписки, подключенной на указанный номер integer 123
 number  Мобильный номер Абонента integer 79859694999
 country  Код страны integer 123
 operator  Код оператора integer 456
 param  Массив данных, направленных Партнером при инициализации array param=array('prm' => 'ind')
 hash  Дайджест запроса string d2c12fd82ddaa2da1e675c70228d33a1

* в случае открытия подписки - передается статус status=create, в случае списания средств с абонента и начисления дохода - status=update

 

Дайджест запроса рассчитывается из параметров запроса, которые задаются в строго указанном порядке:
md5 = subscription+ number + country + operator + secret_key
Secret_key - секретное слово, указанное в личном кабинете.


Ответ сервиса должен быть Content-Type text/plain и в кодировке utf-8.
Стандартная длина одного смс-сообщения составляет 159 латинских символов или 69 кириллических (юникод) символов.
В случае превышения ограничения, ответное смс-сообщение будет обрезано.
Полученное сообщение отсылается в ответном смс-сообщении абоненту на его подписку.

 

Пример обработчика с использованием секретного кода и проверкой целостности запроса:
Код - пример обработчика с использованием секретного кода и проверкой целостности запроса
1
2
3
4
5
6
7
8
9
10
11
12
13

<?php
if
(isset($_POST['subscription'], $_POST['number'], $_POST['country'], $_POST['operator'], $_POST['hash']))
{
  $secret_key = '6dfgmEW98vmWEbdfe3';

  $md5 = md5($_POST['subscription'].$_POST['number'].$_POST['country'].$_POST['operator'].$secret_key);

  if(strcasecmp($md5, $_POST['hash']) ==  0)
  {
    header("Content-Type: text/plain; charset=utf-8");
    exit('Благодарим за участие! Ваш код: 1234');
  }
}
?>

 

В случае, если отправлять Абоненту смс-сообщение не требуется, ответ должен содержать строку noreply.

Пример обработчика с использованием строки noreply:
Код - пример обработчика с использованием строки noreply
1
2
 header("Content-Type: text/plain; charset=utf-8");
 exit('noreply');


 

 

ЗАКРЫТИЕ ПОДПИСКИ

Инициализация закрытия подписки осуществляется посредством отправки HTTP-запроса методом GET или POST по адресу
https://cp.payy.ru/subscription/get.php

В запросе передаются следующие параметры:

Переменная Описание переменной Тип Пример значения
 id  ID проекта, одобренного в личном кабинете Партнера integer 12345
 number  Мобильный номер Абонента string 79859694999
 method  Режим работы string close
 md5  Дайджест запроса string d2c12fd82ddaa2da1e675c70228d33a1

 

Дайджест запроса рассчитывается из параметров запроса, которые задаются в строго указанном порядке:
md5 = id + number + secret_key;
Secret_key - секретное слово, указанное в личном кабинете.

В случае успешного закрытия подписки, Абонент перенаправляется на страницу Партнера, указанную в личном кабинете.

Вверх



Агрегатор трафика PAYY
© 2007-2017 Агрегатор трафика PAYY. HotLog Рейтинг@Mail.ru