API activateTo
Интерфейс генерации и активации предоплаченных кодов для оплаты бонусов, скидок, премиум аккаунтов, расширенных функций приложений, а также ключей для компьютерных программ. Подробнее
ВАЖНО!
Любые работы по подключению приема платежей на Вашем сайте могут быть выполнены только специалистами с соответствующими знаниями в области программирования. Проведение работ на сайте без соответствующей подготовки могут вызвать нарушения работы Вашего сайта или веб-системы, полную или частичную потерю любых данных. Перед началом проведения работ рекомендуется выполнить архивацию (back-up) всех данных Вашего сайта/веб-системы, включая данные исполняемых файлов/скриптов. Любые работы с Вашим сайтом Вы производите на собственный страх и риск. Paysto не несет ответственность за любые повреждения или нарушения в работе Вашего сайта, а также утрату данных. Техническая поддержка по работе интерфейсов Paysto может быть оказана только в части взаимодействия на стороне Paysto.
Оглавление
- Введение
- Назначение
- Термины и понятия
- Подготовительные работы
- Процесс покупки Кода и оплата активацией Кода
- Обеспечение безопасности
- Запрос на активацию Кода
- Аппендикс
- Данные получаемые из интерфейса Клиентского Кабинета
- Тестирование
1. Введение 
1.1. Назначение.
Activate.to - сервис продажи кодов и активации бонусов, скидок, премиум аккаунтов, расширенных функций приложений, а также ключей для компьютерных программ.
1.2. Термины и понятия.
Термин |
Описание |
Шаблон |
Номинальная стоимость, представляющая ценность услуги или товара в у.е. |
Код |
Номинальная стоимость услуги/товара эмитента, включающая, пару Номер-Пин. Каждый Код может быть активирован только в пользу своего Эмитента. Обеспечение Шаблона переходит к эмитенту в момент активации Кода. |
Покупатель |
Покупатель Кода. |
Эмитент |
Лицо, выпустившее Код, в пользу которого идет активация карты c передачей ее обеспечения. |
ИС Эмитента |
Информационная система Эмитента. Например, система биллинга. |
1.3. Подготовительные работы 
Для того что бы начать эмиссию кодов и принимать их в качестве оплаты необходимо:
- Зарегистрироваться в системе PaySto.
- В кабинете PaySto, в основном меню выбрать закладку ActivateTo → "Шаблоны" → нажать кнопку "Новый шаблон".
- При необходимости согласиться с условиями публичной оферты.
- Создать Шаблон, выполнив следующие действия:
- Указать Название: краткое описание кода или его название. Например: Доступ на сайт mysite.com;
- Загрузить картинку. Например: логотип;
- Разместить подробное описание продаваемого кода;
- Выбрать категорию товара;
- Определить публичность продаваемого кода- открыть/закрыть для индексации поисковыми системами;
- Определить Разрядность: Длина генерируемого кода. Например: 8 (Получаем: ХХХХ-ХХХХ);
- Определить Цену - стоимость каждого кода. Выражается в базовой валюте.
- Указать количество кодов, которое будет продано. Пустое поле - неограниченное количество кодов в данном шаблоне.
- Keys.ly - поставьте галочку если планируете использовать данный сервис (создание индивидуальной формы активации). Рекомендуется, если у Вас нет собственного сайта или отсутствует в нем необходимость.
- URL переадресации после покупки кода: Укажите адрес страницы с размещенной формой активации. Если Вы используете сервис keys.ly, то данное поле будет заполнено автоматически.
- Разместить у себя в ИС форму активации Кода (см. "Запрос на активацию Кода"), пример которой Вы можете скопировать из соответствующего поля в конце формы создания шаблона.
- Сообщить Покупателю ссылку, по которой можно купить Код.
Ссылка будет показана после сохранения формы создания нового шаблона.
1.4. Процесс покупки Кода и оплата активацией Кода 
- Покупатель переходит на сайт Activate.to по специально созданной ссылке для покупки Кода.
- Указывает свой email и оплачивает Код.
- При получении оплаты, Покупателю демонстируется код на возвратной странице и высылается на его email Код, PIN и ссылка на сайт Пользователя с формой активации.
- Покупатель вводит Код и PIN в форме на стороне Пользователя.
- Система Пользователя отправляет запрос на верификацию кода по интерфейсу API ActivateTo. Максимальное количество попыток 5 шт. Если все они завершились неуспешно - Код блокируется.
- Если пришёл положительный ответ об успешной активации (ОК,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_Шаблона:

Article ID: 192, Created: September 20, 2018 at 11:48 AM, Modified: September 20, 2018 at 11:48 AM