API B2B-onlineMerchant

Позволяет удаленно создавать пользователей в системе PAYSTO, управлять всеми функциями в onlineMerchant и контролировать заявки на вывод средств.

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

Оглавление

  1. Термины и понятия
  2. Типы передаваемых данных
  3. Обеспечение безопасности
  4. Регистрация пользователя
  5. Создание магазина
  6. Вывод средств
    1. Создание реквизитов для вывода физлица
    2. Создание реквизитов для вывода юрлица
    3. Создание запроса на вывод
    4. Подтверждение запроса на вывод
    5. Получение списка доступных реквизитов для вывода
    6. Удаление реквизитов для вывода 
  7. Тестовая среда

 
 

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

Термин Описание
Магазин или Проект Информационная система Получателя. Например, корзина Плательщика на сайте Получателя и система биллинга Получателя.
Валюта Средство оплаты (например банковский платеж, WMR, WMZ и т.д.)

 

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

Название Описание Диапазон значений
Целое Целое От 0 до 2147483647
Длинное целое Длинное целое От 0 до 4294967296
Денежное Вещественное, разделитель целой и дробной части «.» (точка), разделителя разрядов нет, дробная часть с точностью до сотых. Наличие точки и двух цифр после нее – обязательно. Например, 10 должно быть записано как 10.00, 10.123 должно быть записано как 11.12 или 11.13 от 0.01 до 1000000.00
Строка Строка. Не может содержать символ «=» (равно) и символ «&» (амперсанд). Для каждого параметра длина строки определяется отдельно.
Дата время Всемирное координированное время (UTC). Представлено в формате yyyymmddhhnn где y – цифры для обозначения года, m – месяца, d – дня месяца, h – часа (hh – число от 0 до 23) n – минут. Например, 15 января 2010 17:04 201001151704 От 201001010000 до 205012312359
Булевский 0 – нет, 1 - да 0 или 1

 

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

3.1. Запросы

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

3.2. Ответы upBalance

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

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

IP-адрес сервера
23.102.21.72
137.135.207.41
23.102.17.162

 

4. Регистрация пользователя    

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/CreateAccount

Параметры

Название Описание Тип Обязательный
AdminLogin Логин партнера создающего кабинет    Строка     Да
AdminPassword Пароль партнера создающего кабинет   Строка   Да
Login Логин пользователя нового кабинета   Строка   Да
Email Адрес электронной почты нового кабинета   Строка   Да
Password Пароль пользователя нового кабинета   Строка   Да
LastName Фамилия   Строка   Да
FirstName Имя   Строка   Да
SecondName Отчество   Строка   Да
OfficialTitle Название организации   Строка   Да
HeadPosition Должность руководителя организации   Строка   Да
INN ИНН   Строка   Да
PassportSeries Серия паспорта   Строка   Да
PassportNumber Номер паспорта   Строка   Да
PassportIssued Кем выдан паспорт   Строка   Да
PassportCodeDivision Код подразделения   Строка   Да
PassportDateIssue Дата выдачи паспорта   Строка   Да
KPP КПП   Строка   Да
OGRN ОГРН   Строка   Да
OKVED ОКВЭД   Строка   Да
OKPO ОКПО   Строка   Да
VAT Плательщик НДС   Строка   Да
VATValue Размер НДС   Строка   Да
Phone Номер телефона в формате Х(ХХХ)ХХХ-ХХХХ   Строка   Да
MobilePhone Номер мобильного телефона в формате Х(ХХХ)ХХХ-ХХХХ   Строка   Да
Country Страна   Строка   Да
PostIndex Индекс   Строка   Да
Region Область   Строка   Да
City Город   Строка   Да
Street Улица   Строка   Да
House Дом   Строка   Да
Building строение   Строка   Да
EntranceNumber Подъезд   Строка   Да
Office Номер офиса/квартиры   Строка   Да
AccountName Название аккаунта   Строка   Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ будет пустым.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

5. Создание магазина    

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/Shop

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка   Да
CustomerPassword Пароль пользователя кабинета   Строка   Да
Name Название магазина   Строка   Да
ShortDesc Краткое описание   Строка   Да
PaymentsNote Комментарий платежа   Строка   Да
Desc Полное описание   Строка   Да
Domain Домен   Строка   Да
PubKey Секретный ключ   Строка   Да
CheckUrl Адрес проверки счета   Строка   Да
ResultUrl Адрес уведомления о результате оплаты   Строка   Да
SuccessUrl Адрес перехода в случае успешной оплаты   Строка   Да
FailUrl Адрес перехода в случае неуспешной оплаты   Строка   Да
IP IP – адрес сервера   Строка   Да
RequestNumber Номер запроса    Число     Да
DeliveryTime Срок доставки    Число     Да
CompatibilityModeMD5 Режим совместимости    Булевый     Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ будет содержать номер магазина.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6. Вывод средств    

6.1. Создание реквизитов для вывода Физ. лица

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/ PaymentDetailsCreateF

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка   Да
CustomerPassword Пароль пользователя кабинета   Строка   Да
Name Название реквизитов   Строка   Да
CurrencyId Номер валюты    Число     Да
RecipientForm    Форма собственности получателя     Строка   Да
AccountForm    Форма собственности отправителя     Строка   Да 
INN ИНН   Строка   Да
RS Номер счета   Строка   Да
BIK БИК   Строка   Да
BankName Название банка   Строка   Да
KS    Кор. счет     Строка   Да
ContactFirstName Имя   Строка   Да
ContactSecondName Отчество   Строка   Да
ContactLastName Фамилия   Строка   Да
CardNo Номер карты   Строка   Да
Details Реквизиты в свободной форме   Строка   Нет 
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ будет содержать номер магазина.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6.2. Создание реквизитов для вывода юр. лица     

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/ PaymentDetailsCreateU

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка   Да
CustomerPassword Пароль пользователя кабинета   Строка   Да
Name Название реквизитов   Строка   Да
CurrencyId Валюта   Строка   Да
RecipientForm     Строка   Да
RS Счет   Строка   Да
BIK БИК   Строка   Да
BankName Название банка   Строка   Да
KS Кор.счет   Строка   Да
OfficialName Название организации – получателя платежа   Строка   Да
VATValue Размер НДС   Число    Да
Details Реквизиты в свободной форме   Строка   Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ будет содержать номер магазина.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6.3. Создание запроса на вывод     

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/CreatePayout

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка Да
CustomerPassword Пароль пользователя кабинета   Строка Да
cid Номер реквизитов   Число  Да
amount Сумма    Денежный   Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если операция прошла успешно ответ будет содержать номер платежа.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6.4. Подтверждение запроса на вывод     

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/PayOutConfirm

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка Да
CustomerPassword Пароль пользователя кабинета   Строка Да
cid Номер платежа    Число   Да
code Код подтверждения   Строка Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ пустым.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6.5. Получение списка доступных реквизитов для вывода    

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/PaymentDetailsList

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка Да
CustomerPassword Пароль пользователя кабинета   Строка Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если операция прошла успешно ответ будет содержать список доступных реквизитов для вывода.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь

 

6.6. Удаление реквизитов для вывода    

Элемент адреса Значение
Протокол https
Метод POST
Путь https://paysto.com/api/B2B/PaymentDetailsDelete

Параметры

Название Описание Тип Обязательный
CustomerLogin Логин пользователя кабинета   Строка Да
CustomerPassword Пароль пользователя кабинета Строка   Да
Id Номер реквизитов для удаления    Число   Да
 
Ответ HTTP CODE 200 Сообщение об ошибке. Если регистрация прошла успешно ответ будет содержать номер магазина.
Значения ответа HTTP CODE 403 Нарушены условия безопасности. Проверьте передаваемые параметры и настройки.
Значения ответа HTTP CODE 404 Не найден пользователь
 

7. Тестовая среда    

Адрес test.paysto.com
Данные клиента для входа Необходима отдельная регистрация

 
ДРУГИЕ ИНТЕРФЕЙСЫ PAYSTO
OnlineMerchant - для магазинов
UpBalance - для биллинговых систем
PaymentGate - для массовых выплат
LinkCharge - удаленное высталение счетов на оплату
FundingTo - сбор средств и коллективное финансирование
ActivateTo - активация кодов
Общее - способы оплаты, курсы, тарифы, настройки
B2B - удаленное создание и управление магазинами/аккаунтами
 

Если у Вас возникли вопросы, обратитесь в службу поддержки PAYSTO.

Add Feedback