1. Введение

1.1 Назначение

Paysto.Merchant —программный комплекс, который позволяет автоматизировать процесс оплаты счетов в Интернете, выставленных Вашим web-сайтом.

1.2. Описание

Данный интрефейс полностью совместим с API authorize.net Secure Hosted Payment Form. Если Ваш магазин поддерживает это способ оплаты Вы без труда сможете перейти на использование PAYSTO, расширив таким образом количество способов оплаты на своем сайте.

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

 

 

2. Упрощенная схема оплаты счета магазина    

2.1. Легенда

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

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

• Красная 1. – Пользователь отсылает форму оплаты в PAYSTO;
• Красная 2, Красная 3 – при необходимости пользователь отправляется в мерчант платежной системы;
• Зеленая 1 – PAYSTO оповещает Магазин об оплате;
• Красная 4 – Пользователь возвращается в Магазин;
• Зеленая 2 – При необходимости Магазин запрашивает статус счета в PAYSTO;

 

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

 

 

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

4.1. Запросы

Проверяется IP источника запроса (upBalance проверяет опционально, если IP ИС указан в настройках кабинета). Подпись (обязательно).

4.2. Ответы Merchant

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

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

 

 

5. Запросы для осуществления платежа    

5.1. Запрос на оплату счета

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

Параметры

Поле x_line_item должно содержать одну строку из оплачиваемой корзины пользователя состоящую из нескольких элементов разделенных разделителем <|> . Количество передаваемых полей должно соответствовать количеству элементов в корзине.

Формат поля x_line_item

Пример передаваемой корзины:

x_line_item=item1<|>golf balls<|><|>2<|>18.95<|>Y&
x_line_item=item2<|>golf bag<|>Wilson golf carry bag, red<|>1<|>39.99<|>Y&
x_line_item=item3<|>book<|>Golf for Dummies<|>1<|>21.99<|>Y&

 

5.2. Сведения об оплате    

Данный шаг оповещает Магазин о результатах оплаты счета.

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

Параметры

 

 

5.3. Возвращение Покупателя в Магазин    

На данном шаге Покупатель возвращается в Магазин.

Внимание! Данные этого запроса проходят через компьютер Покупателя и могут быть подделанными недобросовестным Покупателем. Поэтому не рекомендуется на страницах Success url и Fail Url устанавливать статус выставленному счету. Используйте для этого Result Url.

Рекомендуем Success url и Fail Url указывать адрес одной и той же страницы, где на основе сохраненных данных при обработке Result url (или, переспросив статус счета в PAYSTO) перенаправлять пользователя на итоговую страницу успешной (неуспешной) оплаты.

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

Параметры совпадают с описаннами в пукте 5.2

 

 

6. Сведения о платежах     

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

 

6.1. Выписка за период

Параметры

 

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

 

 

  6.2. Сведения об отправленном на оплату счете    

Параметры

 

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

 

 

 

7. Состояние счета     

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

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

Параметры

 

8. Аппендикс     

8.1. Данные получаемые из интерфейса Клиентского Кабинета.  
Рисунок 1 Определение PAYSTO_SHOP_ID - страница "Настройки магазина"