API activateTo - генерация и активация предоплаченных кодов

API activateTo

Интерфейс генерации и активации предоплаченных кодов для оплаты бонусов, скидок, премиум аккаунтов, расширенных функций приложений, а также ключей для компьютерных программ. Подробнее

 

 

ВАЖНО!
Любые работы по подключению приема платежей на Вашем сайте могут быть выполнены только специалистами с соответствующими знаниями в области программирования. Проведение работ на сайте без соответствующей подготовки могут вызвать нарушения работы Вашего сайта или веб-системы, полную или частичную потерю любых данных. Перед началом проведения работ рекомендуется выполнить архивацию (back-up) всех данных Вашего сайта/веб-системы, включая данные исполняемых файлов/скриптов. Любые работы с Вашим сайтом Вы производите на собственный страх и риск. Paysto не несет ответственность за любые повреждения или нарушения в работе Вашего сайта, а также утрату данных. Техническая поддержка по работе интерфейсов Paysto может быть оказана только в части взаимодействия на стороне Paysto.

 


Оглавление

  1. Введение
    1. Назначение
    2. Термины и понятия
    3. Подготовительные работы
    4. Процесс покупки Кода и оплата активацией Кода
    5. Обеспечение безопасности
  2. Запрос на активацию Кода
  3. Аппендикс
    1. Данные получаемые из интерфейса Клиентского Кабинета
    2. Тестирование

   
1. Введение    

1.1. Назначение.

Activate.to - сервис продажи кодов и активации бонусов, скидок, премиум аккаунтов, расширенных функций приложений, а также ключей для компьютерных программ.

1.2. Термины и понятия.

Термин Описание
Шаблон Номинальная стоимость, представляющая ценность услуги или товара в у.е.
Код Номинальная стоимость услуги/товара эмитента, включающая, пару Номер-Пин. Каждый Код может быть активирован только в пользу своего Эмитента. Обеспечение Шаблона переходит к эмитенту в момент активации Кода.
Покупатель Покупатель Кода.
Эмитент Лицо, выпустившее Код, в пользу которого идет активация карты c передачей ее обеспечения.
ИС Эмитента Информационная система Эмитента. Например, система биллинга.

 

1.3. Подготовительные работы    

Для того что бы начать эмиссию кодов и принимать их в качестве оплаты необходимо:

  1. Зарегистрироваться в системе PaySto.
  2. В кабинете PaySto, в основном меню выбрать закладку ActivateTo → "Шаблоны" → нажать кнопку "Новый шаблон".
  3. При необходимости согласиться с условиями публичной оферты.
  4. Создать Шаблон, выполнив следующие действия:
    1. Указать Название: краткое описание кода или его название. Например: Доступ на сайт mysite.com;
    2. Загрузить картинку. Например: логотип;
    3. Разместить подробное описание продаваемого кода;
    4. Выбрать категорию товара;
    5. Определить публичность продаваемого кода- открыть/закрыть для индексации поисковыми системами;
    6. Определить Разрядность: Длина генерируемого кода. Например: 8 (Получаем: ХХХХ-ХХХХ);
    7. Определить Цену - стоимость каждого кода. Выражается в базовой валюте.
    8. Указать количество кодов, которое будет продано. Пустое поле - неограниченное количество кодов в данном шаблоне.
    9. Keys.ly - поставьте галочку если планируете использовать данный сервис (создание индивидуальной формы активации). Рекомендуется, если у Вас нет собственного сайта или отсутствует в нем необходимость.
    10. URL переадресации после покупки кода: Укажите адрес страницы с размещенной формой активации. Если Вы используете сервис keys.ly, то данное поле будет заполнено автоматически.
  5. Разместить у себя в ИС форму активации Кода (см. "Запрос на активацию Кода"), пример которой Вы можете скопировать из соответствующего поля в конце формы создания шаблона.
  6. Сообщить Покупателю ссылку, по которой можно купить Код.
    Ссылка будет показана после сохранения формы создания нового шаблона.

 

1.4. Процесс покупки Кода и оплата активацией Кода    

  1. Покупатель переходит на сайт Activate.to по специально созданной ссылке для покупки Кода.
  2. Указывает свой email и оплачивает Код.
  3. При получении оплаты, Покупателю демонстируется код на возвратной странице и высылается на его email Код, PIN и ссылка на сайт Пользователя с формой активации.
  4. Покупатель вводит Код и PIN в форме на стороне Пользователя.
  5. Система Пользователя отправляет запрос на верификацию кода по интерфейсу API ActivateTo. Максимальное количество попыток 5 шт. Если все они завершились неуспешно - Код блокируется.
  6. Если пришёл положительный ответ об успешной активации (ОК,ID_шаблона) – оплата состоялась, Код верифицирован. Шаблон активации определяется из пришедшего Идентификатора активации. Связь между ID_шаблона и шаблоном можно определить в кабинете Клиента Paysto (см Данные получаемые из интерфейса Клиентского Кабинета.)  

 

1.5. Обеспечение безопасности.

ВНИМАНИЕ! Во избежание DNS подлогов, при запросе по API активации Кода, необходимо проверять SSL сертификат и IP ответившего сервера.

 

2. Запрос на активацию Кода     

Элемент адреса Значение
Протокол https
Метод Post
Путь https://www.activate.to/api/card
Кодировка UTF8

Параметры

Название Описание Тип Обязательный
CardNo Номер Кода строка Да
Pin Пин кода строка Да

Значения ответов

Ответ Значение Описание
HTTP CODE 200 ОК,ID_шаблона,Время_ активации Активирован в этой сессии. OK – константа, ID_шаблона - длинное целое, определяется для каждого кода из кабинета Клиента. Время активации – UTC в виде yyyyMMddHHmm (например 201102312305)
HTTP CODE 200 NO Не оплачен или неверный Пин
HTTP CODE 200 DATE,ID_шаблона,Время_ активации Активирован ранее. DATE – константа, ID_шаблона - длинное целое, определяется для каждого кода из кабинета Клиента. Время активации – UTC в виде yyyyMMddHHmm (например 201102312305)
HTTP CODE 200 XX Не существует
HTTP CODE 200 BLOCK Код заблокирован (превышен лимит попыток по его активации)
HTTP CODE (иное) Timeout Считается, что сервис ActivateTo не доступен и не может выполнить свои обязательства перед Эмитентом. Операцию следует повторить через некоторое время, сообщив о проблеме в тех. поддержку.

 

3. Аппендикс    

3.1. Данные получаемые из интерфейса Клиентского Кабинета.

Рисунок 1 Ссылка на страницу покупки Кода:

 

Рисунок 2 ID_Шаблона:

 

Add Feedback