Интерфейс приема платежей для интернет-проектов в виде пополнения на произвольную сумму внутреннего счета пользователя в системе клиента.
Разработан для проектов имеющих систему учета пользователей и прочих биллинговых систем.
 

 

Оглавление

1. Введение
   1. Назначение
   2. Описание
   3. Термины и понятия
   4. Подготовительные работы
   5. Принцип работы
      1. Легенда
      2. Порядок шагов при успешной оплате
2. Типы передаваемых данных
3. Обеспечение безопасности
   1. Запросы
   2. Ответы Billing
   3. Адреса отвечающих серверов
4. Запросы
   1. Переход плательщика в Billing
   2. Проверка ID плательщика
   3. Оповещение ИС о платеже
   4. Список принятых платежей
   5. Проверка баланса
5. Рекуррентные (периодические) платежи
6. Аппендикс
   1. Данные получаемые из интерфейса Клиентского Кабинета
   2. Тестирование

---

1. Введение

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

Прием платежей для пополнения счета/баланса. В отличие от Merchant с сайта Клиента приходит информация только об Id плательщика, а сумма и номер счета формируется на стороне Billing.

1.2. Описание

Система представляет собой магазин, который формирует счета для оплаты в Paysto, и оповещает Клиента о приеме платежа. Взаимодействие с Paysto происходит посредством API Billing для магазинов. Клиентские настройки для приема платежей происходят в кабинете Клиента Paysto на странице «Настройки магазина». Информация о принятых платежах отображается в кабинете Клиента Paysto на странице «История».

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

 

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

Порядок подключения проекта описан здесь.

 

1.5. Принцип работы

1.5.1. Легенда

• Красные стрелки – переходы Плательщика;
• Зеленые стрелки – запросы между Billing и ИС;
• Сплошные – обязательные;
• Точечные – опциональные.

1.5.2. Порядок шагов при успешной оплате.

• Красная 1. – Пользователь переходит в Billing;
• Зеленая 1, Зеленая 2 - PaySto запрашивает у ИС подтверждение Id Плательщика;
• Красная 2, Красная 3 – при необходимости пользователь отправляется в мерчант платежной системы;
• Зеленая 3 – Billing оповещает ИС об оплате;
• Красная 4 – Пользователь возвращается в Магазин;
• Зеленая 4 – При необходимости ИС запрашивает историю платежей в Billing.

 

2. Типы передаваемых данных    

 

 

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

3.1. Запросы

Проверяется IP источника запроса (Billing проверяет опционально, если IP ИС указан в настройках кабинета). Подпись MD5 (обязательно).Счетчик запроса, делает невозможным получить ответ с данными при повторе запроса без увеличения номера и пересчета подписи (опционально, если указан). Обращаем внимание, текущие значения счетчика от ИС и от Billing разные. Настоятельно рекомендуется для запросов GET, особенно если возможны запросы, где остальные параметры не меняются (например, при запросе баланса).

3.2. Ответы Billing

Проверяйте SSL сертификат ответившего сервера.

3.3. Адреса отвечающих серверов

 

4. Запросы    

4.1. Переход плательщика в Billing

Данный шаг начинает процедуру пополнения баланса через Billing.

Данные проходят через компьютер Плательщика. Сумма к получению и Id Плательщика проверяются на последующих шагах.

Параметры

 

4.2. Проверка ID плательщика    

Billing спрашивает у ИС о существовании ID плательщика.

Внимание! Магазин должен при данном запросе проверять IP, с которого пришел запрос (он должен быть IP Billing - узнайте в технической поддержке возможные значения), подпись.
Отказ от данных проверок может серьезно ослабить защиту от мошенников.

Параметры

Ответы

 

4.3. Оповещение ИС о платеже    

Billing оповещает ИС о принятии средств от Плательщика.

Внимание! Магазин должен при данном запросе проверять IP, с которого пришел запрос (он должен быть IP Paysto - узнайте в технической поддержке возможные значения), подпись.
Отказ от данных проверок может серьезно ослабить защиту от мошенников.

Следите за тем, что PAYSTO_PAYMENT_ID – уникальное значение. Перед увеличением баланса Плательщика убедитесь в том, что до этого, баланс на основании платежа с переданным PAYSTO_PAYMENT_ID не увеличивался.

Параметры

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

 

4.4. Список принятых платежей    

ИС запрашивает Billing о принятых средствах от Плательщиков.

Внимание! При запросе рекомендуется проверить SSL сертификат ответившего сервера для предотвращения DNS подлогов.

Максимальный период, задаваемый параметрами, FROM и TO 31 день.

Параметры

Ответы

Описание столбцов

 

4.5. Проверка баланса    

Внимание! При данных запросах рекомендуется проверять SSL сертификат ответившего сервера для предотвращения DNS подлогов.

Параметры

Ответы

 

5. Рекуррентные (периодические) платежи    

Повторяющиеся платежи позволяют производить автоматическое списание с кредитной карты плательщика и зачисление на счет продавца денежных средств с заданной периодичность. При использовании этого способа оплаты необходимо в запросе 4.1 передать параметр PAYSTO_PERIOD. При формировании такого платежа в случае оплаты кредитной картой плательщику будет предложено автоматически осуществлять оплату с заданной периодичностью. В случае согласия плательщика в системе будет создана подписка по которой будет осуществляться списание с заданной периодичностью такой же суммы. Отменить подписку может как пользователь системы в кабинете пользователя, так и плательщик в кабинете плательщика.

ВНИМАНИЕ! Возможность использования повторяющихся платежей включается индивидуально для каждого проекта по запросу в службу поддержки.

 

6. Аппендикс    

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

Рисунок 1 Определение PAYSTO_SHOP_ID - страница "Настройки магазина" 

 

6.2. Тестирование    

Для тестирования используйте способ оплаты "Тестовый рубль" - включение и отключение производится в Карточке магазина.