Разработчикам
Документация (4.0.4)
Download OpenAPI specification:Download
Номер версии | Раздел | Описание | Дата изменения |
---|---|---|---|
v 4.0.4 | Тестирование выплат Коды ответов на запрос авторизации Подключение сабмерчантов |
Добавлены специфические суммы операций для выплат СБП в тестовом контуре. Обновлен список кодов ответов. Описано добавление реестра сабмерчантов. |
28.04.2025 |
v 4.0.3 | API Выплат на карту/через СБП | Убрали обязательность передачи реквизитов отправителя для выплаты | 25.04.2025 |
v 4.0.2 | CMS | Актуализирован список CMS | 12.03.2025 |
- Покупатель создает заказ(корзину) на торговой площадке
- Маркетплейс отправляет в YPMN запрос на оплату указывая продавца каждого из товаров
- YPMN распределяет денежные суммы по указанным продавцам
- Сайт Продавца запрашивает у YPMN уникальную ссылку на заказ
- Сайт Продавца отправляет ссылку покупателю (e-mail, SMS, мессенджеры)
- Покупатель переходит на платежную страницу YPMN
- YPMN уведомляет Сайт Продавца об успешной авторизации
- Проверочная операция
- Сайт Продавца отправляет в YPMN запрос на сохранение карты
- YPMN возвращает магазину токен и маску карты
- Сайт Продавца отправляет в YPMN запрос на оплату с использованием сохраненной карты
- Покупатель формирует корзину(заказ) на сайте Продавца и нажимает на кнопку "Оплатить".
- Система Продавца формирует запрос к YourPayments.
- Система YourPayments формирует уникальную операцию и предоставляет URL защищенной страницы для ввода данных карты.
- Продавец перенаправляет покупателя на предоставленную в п.3. страницу.
- Покупатель вводит данные карты и подтверждают оплату.
- YourPayments перенаправляет покупателя в банк выпустивший карту.
- Банк идентифицирует покупателя посредством технологии 3D Secure / MirAccept, анализируя параметры его браузера, устройства и при необходимости запрашивая ввод одноразового пароля, отправляемого через SMS или PUSH сообщение.
- Покупатель вводит в форму пароль.
- Если идентификация завершена успешно - Банк утверждает платеж и отправляет покупателя обратно в YourPayments.
- YourPayments в свою очередь, отправляет покупателя на адрес, предоставленный Продавцом для возврата после попытки оплаты.
- Система Продавца сопоставляет полученную при возврате клиента с имеющимся заказом и отображает информацию о результате оплаты.
- После завершения операции(клиринга), денежные средства поступают в YourPayments.
- YourPayments перенаправляет средства на счет продавца.
- Покупатель формирует корзину(заказ) на сайте Торговой площадки и нажимает на кнопку "Оплатить".
- Система Торговой площадки формирует запрос к YourPayments, обогащая каждую товарную позицию идентификатором ее продавца.
- Система YourPayments формирует уникальную операцию и предоставляет URL защищенной страницы для ввода данных карты.
- Торговая площадка перенаправляет покупателя на предоставленную в п.3. страницу.
- Покупатель вводит данные карты и подтверждают оплату.
- YourPayments перенаправляет покупателя в банк выпустивший карту.
- Банк идентифицирует покупателя посредством технологии 3D Secure / MirAccept, анализируя параметры его браузера, устройства и при необходимости запрашивая ввод одноразового пароля, отправляемого через SMS или PUSH сообщение.
- Покупатель вводит в форму пароль.
- Если идентификация завершена успешно - Банк утверждает платеж и отправляет покупателя обратно в YourPayments.
- YourPayments в свою очередь, отправляет покупателя на адрес, предоставленный Торговой площадкой для возврата после попытки оплаты.
- Система Торговой площадки сопоставляет полученную при возврате клиента с имеющимся заказом и отображает информацию о результате оплаты.
- После завершения операции(клиринга), денежные средства поступают в YourPayments.
- YourPayments дробит поступившие средства (основываясь на данных, которые пришли в запросе, п.2).
- Средства отправляются на счета Продавцов.
Перейти к техническому описанию процесса оплаты с рaзделением платежа
- Физическое лицо (Получатель) обращается к Торгово-Сервисному предприятию (Плательщик) с заявлением на выплату
- Система Плательщика формирует запрос к YourPayments на ссылку для верификации карты Получателя
- Система YourPayments формирует уникальную операцию и предоставляет URL защищенной страницы для ввода данных карты.
- Плательщик перенаправляет получателя на предоставленную в п.3. страницу.
- Получатель вводит данные карты и подтверждают блокировку тестовой суммы.
- YourPayments перенаправляет Получателя в банк выпустивший карту.
- Банк идентифицирует Получателя посредством технологии 3D Secure / MirAccept, анализируя параметры его браузера, устройства и при необходимости запрашивая ввод одноразового пароля, отправляемого через SMS или PUSH сообщение.
- Получатель вводит в форму пароль.
- Если идентификация завершена успешно - Банк утверждает платеж и отправляет Получателя обратно в YourPayments.
- YourPayments в свою очередь, отправляет Получателя на адрес, предоставленный Плательщиком для возврата верификации.
- Система Плательщика сопоставляет полученную при возврате Получателя с имеющимся заявлением на выплату и отображает информацию о верификации.
- Система Плательщика отправляет запрос на сохранение карты на основе верификационной операции. В ответ получает токен карты, использованной при верификации.
- Система Плательщика отменяет блокировку верификационной суммы.
- Система Плательщика формирует запрос к YourPayments на выплату с использованием токена карты Получателя (п.12).
- Система YourPayments инициирует перевод.
Доступ к панели управления YourPayments предоставляется после регистрации Сайта Продавца в системе.
Панель управления представляет собой веб-интерфейс, который позволяет:
- управлять платежами Продавца, обрабатываемыми через YourPayments;
- настраивать вид платежной формы;
- создавать учетные записи пользователей панели управления и управлять полномочиями доступа;
- вести БД товаров, платежи за которые обрабатываются через систему.
Навигация внутри панели управления обеспечивается панелью слева. Кроме того, если на юридическое лицо оформлено несколько учетных записей (интегрировано несколько Сайтов), в веб-интерфейсе отображается несколько вкладок, каждая из которых соответствует одному из Сайтов Продавца.
Подтверждение платежа в Личном кабинете Продавца
В панели управления предусмотрено два способа подтверждения доставки заказов: подтверждение одного заказа или нескольких заказов одновременно. Рассмотрим оба случая.
Чтобы подтвердить один заказ:
- Найдите его базе данных заказов.
- Щелчком по номеру заказа раскройте информацию о нем в отдельном окне.
Обратите внимание также, что в дополнительной вкладке окна заказа представлены подробные сведения о клиенте - Нажмите на кнопку “Подтверждение платежей”, чтобы подтвердить доставку заказа.
- Подтвердите действие (кнопка “ОК” во всплывающем окне).
- Закройте окно заказа.
Чтобы подтвердить несколько заказов сразу:
- В навигационной панели слева выберите “Заказы и отчеты” > “Подтверждения платежей”.
- Установите флаги в строках заказов, ожидающих подтверждения. Обратите внимание на возможность поиска по номеру в верхней части экрана.
- Нажмите на кнопку “Подтверждение платежей” под списком заказов.
- Подтвердите действие (кнопка “ОК” во всплывающем окне сверху).
Отмена платежей в Личном кабинете Продавца
Для выполнения возврата:
- Найдите необходимый заказ через меню “Заказы и отчеты” пункт ”Отчеты по продажам”
- Перейдите к заказу, по которому требуется выполнить возврат.
- Нажмите на кнопку “Запрос о возвращении/отмене”.
- Выберите вариант возмещения. Например, простое возмещение. Доступность других опций зависит, в частности, от статуса платежа.
- Укажите причину отмены заказа (обязательно).
- Нажмите на кнопку “Запрос об отмене”.
- Подтвердите действие (кнопка “ОК” во всплывающем окне браузера)
- Закройте окно заказа
Данные обо всех возвратах по заказу отображаются на вкладке Возвраты
, которая появляется в окне данных заказа
Панели управления после выполнения хотя бы одной такой операции.
- Для выполнения возврата по операциям старше трех месяцев, необходимо обратиться в службу поддержки. Невозможность выполнить операцию напрямую через интерфейс Панели управления связана не с техническими проблемами/особенностями, а с правилами МПС. Наличие подобного ограничения уменьшает количество сбоев при управлении средствами.
- На счете Продавца может не быть необходимой суммы для возврата: комиссия за обработку платежей снимается немедленно (если иное не предусмотрено договором), перечисление средств в пользу Продавца выполняется по стандартному графику. Когда средства перечислены, средств на возврат может не быть. Также, подобная ситуация возникает при использовании учетной записи Продавца для действий, не связанных со списанием средств, либо если Продавец больше не сотрудничает с YourPayments, но хочет выполнить возврат по старой операции.
- Возвраты не производятся для систем ЮMoney, Евросеть и Связной (это не предусмотрено системами).
- За саму операцию возврата средств комиссия не взимается. Что касается комиссии за обработку исходной транзакции, ее возврат зависит от типа IRN-запроса: при отмене блокировки средств на счете покупателя в процессе подтверждения заказа ("реверс") комиссия возвращается, при отмене платежа по выполненному и обработанному заказу ("рефанд") - нет, если иное не оговорено договором.
- Если Продавцу требуется функция автоматического возврата платежей, то Продавец может использовать возможности протокола IRN и самостоятельно написать скрипт для автоматизации процедуры.
- Чтобы узнать, когда будет выполнен возврат/каков статус запроса, необходимо отслеживать транзакцию через Панель управления. Если отмена выполнена на стадии первичного подтверждения заказа ("реверс"), транзакция просто отменяется, если же выполняется возврат платежа по завершенному заказу ("рефанд"), создается отдельная транзакция с аналогичным ссылочным номером (см. видео ниже).
- Время обработки зависит от нескольких факторов, в частности, наличие средств, давность исходной операции, или, напротив, запрос на возврат средств менее, чем через 24 часа после оплаты (платформа отмечает подобные запросы как подозрительные).
Ввод параметров учетной записи
Для того чтобы начать работу с YourPayments, Магазину необходимо настроить учетную запись и параметры отправки IPN (уведомления об оплате). Это ключевые параметры для обработки заказа.
Для этого выполните следующие шаги:
- Перейдите в меню
Настройки учетные записи
навигационной панели слева. Первое подменюДанные учетной записью
позволяет настроить учетные данные Магазина (не пользователя). Здесь вы можете как ввести данные, так и обновить их в любой момент.
Обратите внимание на поле Почта для отчетов
. В него можно ввести несколько адресов электронной почты, если
использовать следующий формат: test@test.com; test2@test.com. (точка с запятой и пробел).
- Перейдите в подменю
Редактирование настроек
, чтобы настроить параметры IPN и сообщений клиентам. - На закладке
Редактирование настроек
этого окна (открывается по умолчанию) вы можете выбрать формат IPN, а также выбрать, для каких статусов заказа следует использовать данный тип уведомления. Для одобренных заказов IPN отправляется всегда. - Для настройки содержания IPN и URL для их приема, перейдите на соседнюю вкладку экрана
Настройки IPN
. - Введите/измените адрес для приема IPN уведомлений. По умолчанию поле пустое.
- Введите/измените адрес для приема вебхука по операциям выплат. По умолчанию поле пустое.
- Чтобы сохранить настройки, нажмите на кнопку
Проверка и сохранение URL
. - В нижней части экрана представлен набор всех возможных полей уведомления. Устанавливая и снимая флаги напротив названий полей, вы можете сформировать собственный набор.
- Чтобы уточнить значение поля, поднесите курсор к знаку
?
возле его названия. - Если изменения были внесены, нажмите на кнопку
Сохранить настройки
внизу экрана, чтобы применить выбранные параметры, если внесены изменения. Обратите внимание на возможность восстановления исходных настроек - Система сохраняет учетные данные Магазина, вы можете приступать к работе
Создание ролей и учетных записей пользователей
Административная панель управления YourPayments позволяет создавать учетные записи пользователей и роли с различными полномочиями доступа.
Для управления учетными записями пользователей используются роли. Поэтому, прежде чем создавать новые учетные записи, необходимо создать набор ролей.
Обратите внимание, что по умолчанию в Панели управления нет ролей. Учетная запись администратора с максимальными правами создается при предоставлении Продавцу доступа к Панели управления.
Настройка выполняется в меню Настройка Учетной записи
> Доступ пользователей к ЛК
панели управления cлева.
Для того чтобы создать роль:
- Находясь в меню
Доступ пользователей к ЛК
, нажмите на кнопкуДобавить новую роль
в верхней части экрана. - Введите название новой роли.
- Используя флаги напротив названий групп функций и функций, назначьте права для новой роли.
- Сохраните настройки (кнопка
Сохранить роль
).
Вы можете в любой момент отредактировать любую роль. Для этого нажмите на кнопку Редактировать
напротив
названия роли в списке. Обратите внимание, что удалить роль невозможно. Форма редактирования аналогична форме
создания новой роли.
Далее вы можете перейти к управлению учетными записями пользователей. Список существующих учетных записей
находится в этом же окне, на соседней вкладке Посмотреть пользователей
.
Для того чтобы создать новую учетную запись пользователя:
- Нажмите на кнопку
Добавить нового пользователя
в верхней части экрана. - Заполните все поля блока
Информация о пользователе
: имя, фамилия, пароль, адрес электронной почты (рис. 2 Форма ввода нового пользователя).
Для перехода между полями, удаления и копирования данных, используйте стандартные клавиши и комбинации клавиш Windows (Tab, Ctrl+C, Ctrl+V, и т.д.)
При вводе пароля и подтверждения обратите внимание на требования.
- Установите флаг
Включить
, чтобы активировать учетную запись сразу после создания. - Привяжите к учетной записи одну или несколько ролей, устанавливая флаги возле названий ролей.
- Нажмите на кнопку
Сохранить
, чтобы сохранить данные.
Вы можете в любой момент отредактировать данные о пользователе.
Удаление учетной записи невозможно.
Щелчок по кнопке Редактировать
напротив имени нужного пользователя открывает форму, аналогичную форме ввода исходных данных.
Панель управления позволяет управлять платежными операциями (подтверждать их, отменять, отслеживать). Жизненный цикл стандартной платежной операции описан во вводном разделе, однако в панели управления приняты собственные обозначения статуса (этапа обработки), описанные ниже.
Поиск заказа
Перейдите в меню
Заказы и отчеты
навигационной панели слева.Выберите пункт
Отчеты по продажам
, чтобы найти нужный заказОткрывшаяся форма позволяет выполнять поиск заказов по самым разным параметрам. Для примера применим несколько фильтров:
- заказы за последние 7 дней;
- оплаченные картой;
- все заказы.
Нажмите на кнопку “Сформировать отчет”, чтобы получить выборку.
Через эту же форму выполняется поиск для подтверждений, запросов возврата и большинства других операций с заказом (см. в подразделах ниже).
Обратите внимание, что сформировав поиск, вы можете выгрузить результат в формате .csv.
Статусы платежей в панели управления
СТАТУС | ОПИСАНИЕ |
---|---|
Закончен | Заказ оплачен, средства успешно списаны (COMPLETE) |
Обрабатывается | Средства успешно заблокированы, ожидается подтверждение возможности выполнения (IDN) (PAYMENT_AUTHORIZED) |
Не оплачен | Заказ не оплачен (пока еще). Этот статус указывает на различные ошибки |
Верификация | Заказ находится на рассмотрении. Оплата подтверждена банком, однако не рекомендуются никакие действия до утверждения YourPayments (FRAUD) |
Возвращен | Отмена блокировки или возврат оплаты по IRN (REVERSED/REFUND) |
Оценивается | Заказ не прошел через фильтры защиты от мошенничества YourPayments. Он будет одобрен после завершения аутентификации клиента (FRAUD) |
Тест | Тестовый заказ (TEST) |
Сроки поступления средств обратно на счет клиента зависят от скорости межбанковского взаимодействия. Как правило, сроки не превышают пяти рабочих дней.
Для выполнения возврата:
- Найдите необходимый заказ через меню
Заказы и отчеты
пунктОтчеты по продажам
- Перейдите к заказу, по которому требуется выполнить возврат.
- Нажмите на кнопку
Запрос о возвращении/отмене
. - Выберите вариант возмещения. Например, простое возмещение. Доступность других опций зависит, в частности, от статуса платежа.
- Укажите причину отмены заказа (обязательно).
- Нажмите на кнопку
Запрос об отмене
. - Подтвердите действие (кнопка
ОК
во всплывающем окне браузера) - Закройте окно заказа
Данные обо всех возвратах по заказу отображаются на вкладке Возвраты
, которая появляется в окне данных заказа
Панели управления после выполнения хотя бы одной такой операции.
Для выполнения возврата по операциям старше трех месяцев, необходимо обратиться в службу поддержки (ops@ypmn.ru). Невозможность выполнить операцию напрямую через интерфейс Панели управления связана не с техническими проблемами/особенностями, а с правилами МПС. Наличие подобного ограничения уменьшает количество сбоев при управлении средствами.
На счете Продавца может не быть необходимой суммы для возврата: комиссия за обработку платежей снимается немедленно (если иное не предусмотрено договором), перечисление средств в пользу Продавца выполняется по стандартному графику. Когда средства перечислены, средств на возврат может не быть. Также, подобная ситуация возникает при использовании учетной записи Продавца для действий, не связанных со списанием средств, либо если Продавец больше не сотрудничает с YourPayments, но хочет выполнить возврат по старой операции.
Возвраты не производятся для систем ЮMoney, Евросеть и Связной (это не предусмотрено системами).
За саму операцию возврата средств комиссия не взимается. Что касается комиссии за обработку исходной транзакции, ее возврат зависит от типа IRN-запроса: при отмене блокировки средств на счете покупателя в процессе подтверждения заказа ("реверс") комиссия возвращается, при отмене платежа по выполненному и обработанному заказу ("рефанд") - нет, если иное не оговорено договором.
Если Продавцу требуется функция автоматического возврата платежей, то Продавец может использовать возможности протокола IRN и самостоятельно написать скрипт для автоматизации процедуры. YourPayments не оказывает данной услуги.
Чтобы узнать, когда будет выполнен возврат/каков статус запроса, необходимо отслеживать транзакцию через Панель управления. Если отмена выполнена на стадии первичного подтверждения заказа ("реверс"), транзакция просто отменяется, если же выполняется возврат платежа по завершенному заказу ("рефанд"), создается отдельная транзакция с аналогичным ссылочным номером (см. видео, отображается на отдельной вкладке окна заказа). Время обработки зависит от нескольких факторов, в частности, наличие средств, давность исходной операции, или, напротив, запрос на возврат средств менее, чем через 24 часа после оплаты (платформа отмечает подобные запросы как подозрительные).
В системе не предусмотрена функция отмены запроса по IRN, но это может быть возможно при немедленном обращении в службу поддержки YourPayments.
В панели управления предусмотрено два способа подтверждения доставки заказов: подтверждение одного заказа или нескольких заказов одновременно. Рассмотрим оба случая.
Чтобы подтвердить один заказ:
- Найдите его базе данных заказов.
- Щелчком по номеру заказа раскройте информацию о нем в отдельном окне.
- Обратите внимание также, что в дополнительной вкладке окна заказа представлены подробные сведения о клиенте
- Нажмите на кнопку
Подтверждение платежей
, чтобы подтвердить доставку заказа. - Подтвердите действие (кнопка
ОК
во всплывающем окне). - Закройте окно заказа.
Чтобы подтвердить несколько заказов сразу:
- В навигационной панели слева выберите
Заказы и отчеты
>Подтверждения платежей
. - Установите флаги в строках заказов, ожидающих подтверждения. Обратите внимание на возможность поиска по номеру в верхней части экрана.
- Нажмите на кнопку
Подтверждение платежей
под списком заказов. - Подтвердите действие (кнопка
ОК
во всплывающем окне сверху).
Панель управления YourPayments позволяет создавать стандартные и персонализированные отчеты/шаблоны отчетов.
Центр отчетов Панели управления содержит несколько шаблонов стандартных отчетов, а также позволяет формировать различные отчеты с индивидуальными настройками, используя доступную в системе статистику.
Каждый отчет формируется в графическом формате и в виде таблицы.
Обратите внимание, что, используя контекстное меню (щелчок правой кнопкой мыши), можно сохранить график в виде рисунка или распечатать его.
Отчет по анализу бизнеса
Отчет по анализу бизнеса - это "мастер" для создания собственных аналитических отчетов. Созданные отчеты можно сохранять для последующего использования.
Готовые шаблоны отчетов
В панели управления предусмотрено три типа шаблонов отчетов (ежемесячные суммы, ежемесячные продажи, отчет по странам).
Ежемесячные продажи позволяет формировать график продаж за год до текущего момента, демонстрирующий месячную динамику продаж. Отчет формируется в графическом (столбцы) и табличном форматах. Суммы разбиваются на полученные и ожидаемые к получению.
Учитываются подтвержденные и ожидающие подтверждения заказы.
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
).
Также предусмотрена возможность сравнения с аналогичным периодом предыдущего года (флаг Сравните с предыдущим периодом
). В этом случае каждый месяц сравнивается с аналогичным месяцем годом ранее. Например, июль 2017 года с
июлем 2016 года.
При этом таблица показывает прирост в процентах, а на графике отображается соотношение переведенных и ожидаемых сумм для анализируемых 12 месяцев.
Ежемесячные суммы - отчет, дающий более точную картину о динамике выручки за год до текущего момента. Отчет позволяет сформировать отчет по выручке в следующих форматах:
- только чистая выручка
- только сбор за обработку (комиссия)
- только НДС
- все суммы, с разбиением на графике (столбцы) и таблице
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
).

Суммы, полученные от возобновлений - отчет, позволяющий отследить возобновляемость подписок на продукты соответствующего типа и их долю в общей выручке Продавца. На графике отображается две линии, одна из которых показывает общую сумму выручки, другая - выручку от возобновлений. Период отчета - 12 месяцев до текущей даты.
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
).
Отчеты для руководства
Отчет по товару
позволяет выявлять наиболее коммерчески успешные продукты. Формируется в графическом (круговая
диаграмма) и табличном формате.
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
).
Кроме того, пользователь может задать произвольный период отчета, используя календарь. Также есть возможность
сформировать отчет на основе проданного количества продуктов, или на основе полученных сумм от продаж продукта
(поля Сортировка по
).
Отчет по рекламным предложениям
предназначен для сравнения результатов продаж продуктов по прямому предложению и
перекрестному (круговая диаграмма и таблица).
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
). Кроме того, пользователь
может задать произвольный период отчета, используя календарь.
Отчет по странам
позволяет определить, из какой страны/стран поступает наибольшее количество заказов или доходов.
Отчет также формируется в формате круговой диаграммы и таблицы за выбранный пользователем период.
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
). Кроме того, пользователь
может задать произвольный период отчета, используя календарь.
Отчет возобновлений/прекращений
позволяет определить возобновляемость подписок/контрактов на соответствующие
продукты/услуги за прошедший год (за 12 месяцев до текущей даты). Отображается отчет в формате графика (две линии
для сравнения) и таблицы.
Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments, система позволяет
сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
). Кроме того, пользователь
может задать произвольный период отчета, используя календарь.
Статистика заказов
На сегодня в Панели управления существует три типа отчетов для отслеживания динамики заказов.
Дни месяца
- позволяет выявлять дни наиболее активных продаж и возобновлений за период (предыдущий месяц,
текущий месяц, 12 месяцев до текущей даты). Отчет включает одобренные и выполненные заказы, но не возвраты. Данные
отображаются в виде графика и таблицы. Вы можете выбрать отображение абсолютных (кумулятивных) показателей, или
усредненных цифр за месяцы. Если на одно юридическое лицо зарегистрировано несколько учетных записей YourPayments,
система позволяет сформировать единый отчет по всем им (флаг Кумулятивный отчет по моим учетным записям
).
Дни недели
- этот отчет аналогичен предыдущему, но показывает динамику заказов по дням недели. Не включает возобновлений.
Часы дня
- этот отчет аналогичен предыдущим, но показывает динамику заказов по времени суток. Не включает возобновлений.
Раздел Трансферы и инвойсы панели управления (Заказы и отчеты
>
Трансферы и инвойсы
) позволяет формировать несколько типов отчетности по платежам в пользу Продавца.
Трансферы
На вкладке Трансферы
отображается текущая статистика переводов в пользу Продавца. Вы можете отфильтровать список
по статусу трансфера (оплачен, частично оплачен, не оплачен), а также посмотреть подробную информацию о каждом
переводе. По умолчанию отображаются все операции.
Предусмотрена возможность экспорта данных в разрезе товаров или заказов в формате MS Excel.
Обратите внимание, что в верхней части экрана отображается общий текущий баланс. Также итоговые суммы по товарам и заказам отображаются напротив ссылок файлов для скачивания.
Отчет оператора
На вкладке Отчет оператора
отображается список отчетов YourPayments в пользу Продавца за каждый отчетный месяц.
Отчеты доступны для скачивания в формате pdf.
Баланс для выплат
Баланс меняется, когда YourPayments получает от Продавца средства по специальному договору. Операционный специалист вносит полученные средства на счет в системе YourPayments.
В случае сбоев (например, связанных с работой банка) возможна блокировка средств.
Как правило, платежи осуществляются в понедельник, среду и пятницу, средства обычно поступают на счет Продавца через 3 дня после платежа. В случае возникновения вопросов/затруднений, следует обратиться в YourPayments по электронной почте: ops@ypmn.ru.
Панель управления YPMN позволяет:
- настраивать набор полей платежной формы (предустановленные поля и дополнительные, созданные пользователем);
- редактировать шаблон платежной формы (оформление, логотипы, и т.д.);
- создавать дополнительные поля для описания товаров.
Для того чтобы использовать свой логотип на страницах платежной формы,
- Зайдите на страницу Настройки учетной записи в панели управления (
Настройки учетной записи
>Редактирование настроек
). - Загрузите логотип в разделе
Логотип компании
(в нижней части страницы). - Нажмите на кнопку
Обновить настройки
.
Логотип отобразится на платежной странице, а также в верхнем правом углу панели Личного кабинета.
В некоторых случаях бывает удобно отправить покупателю отдельную ссылку на оплату, которая не привязана к сайту. В YourPayments есть инструменты, которая позволяют создать такую ссылку.
Инструкция
- В Личном кабинете YourPayments необходимо зайти в меню "Товары" - "Добавить товар" (ссылка на страницу добавления товара https://secure.ypmn.ru/cpanel/product_add.php)
- Заполнить поля "Имя товара", "Цена товара", "Ставка НДС". Остальные поля заполнять не обязательно. Пример заполнения ниже
- Нажать кнопку "Добавить товар" внизу страницы.
- На открывшейся странице товара перейти по ссылке "Генерация ссылки на оплату для данного продукта"
- В результате вы попадёте на страницу генерации ссылок на оплату (ссылка на страницу генерации ссылок https://secure.ypmn.ru/cpanel/integration.php)
- В поле "Проверка ссылки" отобразится ссылка на оплату, готовая для отправки клиенту.
После входа в ЛК, на главной странице Вы можете видеть список из 5 последних транзакций.
Для более расширенной информации Вам следует зайти в Отчет по продажам
, нажав соответствующую ссылку справа внизу.
В подгрузившемся меню Вы можете увидеть фильтры, с помощью которых сможете сформировать необходимый Вам отчет.
Период для поиска
– выберите необходимый Вам диапазон.
Имя товара
– соответствует тому наименованию товара, которое вы указываете для транзакции.
Поиск
– введите данные, которые Вас интересуют, а справа из выпадающего списка выберите категорию, по которой
будет происходить поиск.
Способ оплаты
– позволяет сформировать отчет по определенным методам оплаты.
Например, выбираем период
, проставляем статус
Любой статус заказа, плюс выбираем по сколько транзакций будет
отображаться на странице, и нажимаете кнопку Сформировать отчет
.
Рядовые случаи, которые Вы можете выявить через ЛК
Чтобы уточнить информацию по той или иной транзакции необходимо зайти в саму транзакцию, кликнув по ее номеру.
После того, как наша Система отправляет Вам ссылку на платежную страницу, вы перенаправляете физ. лицо на нее.
Он вводит все необходимые данные, и нажимает Оплатить
, за тем происходит редирект на проверку 3DS. Причин не
пройти проверку 3DS несколько, например:
не пришло сообщение с кодом, или клиент ушел со страницы 3DS, или страница 3DS перестала быть актуальной (т.к. временной интервал действия страницы истек).
Если плательщик предоставляет выписку, обращайтесь в поддержку YP
Так же есть ответы с ошибками. У каждой ошибки есть свой код
Код ответа | Значение | Описание |
---|---|---|
GW_ERROR_GENERIC | An error occurred during processing. Please retry the operation | При обработке произошла ошибка. Пожалуйста, повторите операцию |
GW_ERROR_GENERIC_3D | An error occurred during 3DS processing | Произошла ошибка при обработке 3DS |
GWERROR_-19 | Authentication failed | Ошибка аутентификации |
GWERROR_-18 | Error in CVC2 or CVC2 Description fields | Ошибка в CVC2 или его описании |
GWERROR_-10 | Error in amount field | Ошибка в сумме операции (недопустимо значение 0, может быть отказ со стороны эмитента по транзакциям меньше 1 руб) |
GWERROR_-9 | Error in card expiration date field | Ошибка в поле срока действия карты |
GWERROR_-8 | Invalid card number | Номер карты не корректен |
GWERROR_-3 | Call acquirer support call number | Позвоните в службу поддержки эквайера (отказ без указания причины, комментарий может дать только банк, обслуживающий операцию |
GWERROR_-2 | An error occurred during processing. Please retry the operation | Ошибка обработки. Пожалуйста, повторите операцию |
GWERROR_01 | Card type not active or incorrect PIN | Карта не поддерживается или неверный PIN-код |
GWERROR_02 | Refer to card issuer, special condition | Обратитесь к эмитенту карты, отказ с по особым условиям |
GWERROR_03 | Invalid merchant | Неверно указан продавец |
GWERROR_04 | Restricted card | Функционал карты ограничен эмитентом |
GWERROR_05 | Authorization declined | В авторизации отказано |
GWERROR_06 | Error - retry | Ошибка. Повторите попытку |
GWERROR_07 | Password incorrect or card disabled | Неверный пароль или карта отключена |
GWERROR_08 | Invalid amount | Недопустимая сумма |
GWERROR_12 | Amount exceeds card ceiling | Данная сумма превышает допустимую и не может быть проведена с данной карты |
GWERROR_13 | Invalid amount | Недопустимая сумма |
GWERROR_14 | No such card | Нет такой карты |
GWERROR_15 | No such card/issuer | Нет такой карты/эмитента |
GWERROR_17 | Customer cancellation | Отменено плательщиком |
GWERROR_19 | Re-enter transaction | Повторно ввести транзакцию |
GWERROR_20 | Invalid response | Неверный ответ банка |
GWERROR_22 | Suspected Malfunction | Подозрение на неисправность |
GWERROR_30 | Format error | Ошибка формата |
GWERROR_34 | Credit card number failed the fraud | Система защиты от мошенничества блокировала операцию по данной карте |
GWERROR_36 | Credit restricted | Кредит ограничен |
GWERROR_41 | Lost card | Карта утеряна |
GWERROR_43 | Stolen card, pick up | Украдена карта |
GWERROR_51 | Insufficient funds | Недостаточно средств |
GWERROR_54 | Expired card | Срок действия карты истек |
GWERROR_55 | Incorrect PIN | Неверный PIN-код |
GWERROR_57 | Transaction not permitted on card | Транзакция по карте не разрешена |
GWERROR_58 | Not permitted to merchant | Не разрешено торговцу |
GWERROR_59 | Suspected fraud | Подозрение на мошенничество |
GWERROR_61 | Exceeds amount limit | Превышает лимит суммы |
GWERROR_62 | Restricted card | Ограничение по карте |
GWERROR_63 | Security violation | Нарушение правил безопасности |
GWERROR_65 | Exceeds frequency limit | Превышен предел частоты платежей с данной карты |
GWERROR_68 | Response received too late | Ответ получен слишком поздно, время ожидания ответа истекло |
GWERROR_75 | PIN tries exceeded | Количество попыток ввести ПИН-код превышено |
GWERROR_76 | Wrong pin, tries exceeded | Неверный пин-код, количество попыток превышено |
GWERROR_78 | Reserved | В случае, когда контракт эмитента и держателя карты расторгнут или приостановлен. |
GWERROR_82 | Time-out at issuer | Тайм-аут со стороны эмитента карты |
GWERROR_83 | Unable to verify PIN | Не удалось подтвердить PIN-код |
GWERROR_84 | Invalid cvv | Неверный CVV |
GWERROR_89 | Authentication failure | Ошибка аутентификации |
GWERROR_91 | A technical problem occurred. Issuer cannot process | Техническая ошибка. Эмитент не может обработать операцию |
GWERROR_93 | Violation of law | Нарушение законодательства (в некоторых странах законодательно запрещено платить локальными картами в зарубежных магазинах) |
GWERROR_94 | Duplicate transmission | Отказ в проведении операции по причине срабатывания контроля дубликатов |
GWERROR_95 | Reconcile error | Ошибка реконсиляции (сверки) на стороне банка-эквайера или банка-эмитента |
GWERROR_96 | System malfunction | Неисправность системы |
GWERROR_98 | Error during canceling transaction | Ошибка при отмене транзакции |
GWERROR_99 | Incorrect card brand | Неверный бренд карты |
GWERROR_102 | Acquirer timeout | Тайм-аут на стороне банка-эквайера |
GWERROR_105 | 3DS authentication error | Ошибка аутентификации 3DS |
GWERROR_107 | Sorry, at the moment the transaction cannot be processed due to excessive retries with this card. Please try using another card | К сожалению, в настоящее время транзакция не может быть обработана из-за большого количества повторных попыток оплаты этой картой. Попробуйте использовать другую карту |
GWERROR_108 | Sorry, at the moment the transaction cannot be processed. Please try using another card | К сожалению, в данный момент транзакция не может быть обработана. Попробуйте использовать другую карту |
GWERROR_109 | Inactive card, please activate the card first | Неактивная карта, сначала активируйте карту |
GWERROR_2304 | There is an ongoing process your order | Ваш заказ находится в обработке (блокирует повторную операцию с теми же данными) |
GWERROR_5007 | Debit cards only supports 3DS operations | Данная дебетовая карта поддерживает только 3DS-операции |
ALREADY_AUTHORIZED | Re-enter transaction | Операция уже авторизована, в повторной попытке нет необходимости |
-9999 | Banned operation | Отказ системы противодействия мошенничеству. Операция заблокирована |
Одна из самых распространенных ошибок: нехватка средств на карте
Рекомендации по безопасности при работе с личным кабинетом:
- Доступ к использованию личного кабинета выдавать только при условии регистрации на личный почтовый ящик пользователя (групповые почтовые ящики не использовать)
- В исключительных случаях, при предоставлении доступа посредством группового почтового ящика - ограничивать права пользователя только просмотровыми функциями
- Отслеживать и деактивировать / корректировать права доступа пользователей личного кабинета при увольнении или смене должности
- Для пользователей с расширенными правами (редактирование прав доступа, редактирование технических параметров, проведение возвратов) - ограничивать доступ по белому списку IP-адресов
Управление правами пользователя осуществляется через меню: Настройки учетной записи - Доступ пользователей к ЛК.
Доступные функции:
- https://secure.ypmn.ru/cpanel/tools_users.php
- добавление/удаление пользователей
- смена пароля пользователей
- назначение ролей пользователям
- https://secure.ypmn.ru/cpanel/tools_roles.php
- создание ролей
- редактирование ролей
- https://secure.ypmn.ru/cpanel/ip_tools.php
- активация/деактивация белого списка IP
- назначение условий использования белого списка для всех пользователей
- назначение условий использования белого списка для выделенных пользователей или групп пользователей
Формирование справок по операциям в Личном кабинете Продавца
В панели управления предусмотрен механизм автоматизированного формирования справок по операциям ваших клиентов.
Такие справки могут понадобиться в различных случаях для подтверждения успешности или неуспешности операции для банков-эмитентов или других организаций.
Чтобы получить справку по текущему состоянию операции:
- Найдите операцию базе данных заказов используя фильтры меню "Заказы и отчеты - Отчет по продажам"

- Щелчком по номеру операции (Ссылочный номер YP) раскройте информацию о ней в отдельном окне. Нажмите на кнопку "Печать"

- Автоматически начнется загрузка справки в формате PDF.
Содержимое справки будет соответствовать текущему статусу операции и содержать только данные указанные продавцом при создании операции!
Доступные виды справок:
- Неуспешная оплата (статус Не Оплачен)
- Успешная блокировка средств (статус В Обработке)
- Успешная оплата (статус Завершен)
- Успешный возврат (статус Возвращен)
- Успешная выплата на карту (статус Завершен)
- Неуспешная выплата (статус Отменен)
Формирование выплат на карту в Личном кабинете Продавца
В случае, если у вас подключена опция выплат на карты ваших клиентов, то у вас есть возможность производить такие операции через Личный кабинет Продавца (в дополнение к выплатам по API)
Для того, чтобы успешно и безопасно производить выплаты необходимо:
- Создать и сохранить роль, с включенной опцией "Формирование выплат" (через меню "Настройки учетной записи - Доступ пользователей к ЛК" нажав кнопку "Добавить новую роль")

- создать отдельного(!) пользователя и назначить ему роль созданную ранее (более подробно о настройке ролей и управлении пользователями)
- Пользователь, обладающий описанной выше ролью сможет зайти в меню "Выплаты - Создать выплату", где будет доступен следующий интерфейс:

- Введите номер карты получателя, сумму выплаты, имя получателя (или имя на карте получателя), назначение платежа.
- Нажмите на кнопку "Выплатить"
- Если все действия выполнены верно - вы получите оповещение об успешной операции.
Для настройки чеков перейдите в меню Настройки учетной записи
> Редактирование настроек
> Настройка чеков
Для подключения к вашему аккаунту возможности интеграции с кассой АТОЛ Онлайн обратитесь в служба поддержки.
После подключения возможности интеграции с кассой АТОЛ Онлайн вы можете задать настройки и активировать интеграцию
в личном кабинете в меню Настройки учетной записи
> Редактирование настроек
> Настройка чеков
(см. блок "АТОЛ").
Доступные настройки:
- Активировать - активировать отправку чеков в АТОЛ. Чеки будут отправляться, если заданы минимально необходимые настройки: "Версия ФФД", "Login", "Password", "Group code"
- Настройки интеграции с АТОЛ
- Версия ФФД
- Login
- Password
- Group code
- IPN URL - URL для отправки вебхуков о регистрации чеков в АТОЛ
- Активировать отправку вебхуков - можно активировать, если указан IPN URL
После указания необходимых настроек и активации интеграции с АТОЛ Онлайн для отправки чеков необходимо передать
данные для регистрации чеков в поле details
> receipts
в запросе на авторизацию платежа / списание / возврат (см.
API оплаты.
CMS (Content Management Systems) – системы управления содержимым сайтов. Мы поддерживаем и развиваем наши модули для большинства популярных CMS:
Модуль устанавливается через Каталог решений (маркетплейс) по ссылке:
Модуль можно установить скачав его с сайта GitHub:
Если у вас тарифный план Омни, Расширенный или Премиум, вы можете обратиться в техническую поддержку InSales, и вам установят платежный модуль Your Payments.
АвтоВебОфис предоставляет встроенный модуль для интеграции с Your Payments
SDK (Software Development Kit) – готовые программные библиотеки (модули) на разных языках программирования.
Они очень полезны для быстрого старта в нестандартных, «самописных» программах.
Использование SDK делает интеграции проще (быстрее и дешевле), а также включает уже протестированный код и его бесплатные обновления.
SDK на PHP содержит в себе подробные примеры, а также готовый сервер в контейнере Docker.
API версии 4 ( 4.0.0 )
Этот набор API используется для взаимодействия с YourPayments для обработки платежей. Имейте в виду, что доступны некоторые варианты интеграции:
- для одиночного продавца.
- для Торговой Площадки (используется несколько учетных записей, где одна главная, остальные подчиненные)
Обзор
Эти API методы позволяют продавцу принимать или отправлять онлайн-платежи на своем веб-сайте. Продавец может интегрировать несколько платежных потоков.
Для входящего потока платежей различными доступными методами оплаты используйте API Оплаты
Для входящего потока платежей различными доступными методами оплаты с разделением платежа используйте API Оплаты с разделением платежа
Для исходящего потока (выплаты на карты) используйте API Выплат на карты
Формат тестирования
Вы можете использовать Postman для тестирования наших API. Ниже представлена postman-коллекция, которая поможет вам протестировать основные потоки:
Описание | файлы для скачивания |
---|---|
Коллекция всех доступных API, включая некоторые специфические бизнес-процессы. | API YPMN; Переменные окружения |
Текущие файлы среды настроены с общими учетными записями, и данные могут быть удалены в любое время.
В любой среде вы можете заменить PAYU_SECRET_KEY
и PAYU_MERCHANT_CODE
на код, предоставленный нашей командой интеграции.
При работе с тестовым контуром (sandbox) параметр HOST_BASE_URL в переменных окружения устанавливается https://sandbox.ypmn.ru
Доступ к тестовому контуру выдается индивидуально после обращения к курирующему менеджеру.
При работе с боевым контуром параметр HOST_BASE_URL в переменных окружения устанавливается https://secure.ypmn.ru
IP-адреса тестового контура
Если на вашей стороне применено фильтрование входящего трафика с использованием белого списка, то рекомендуем разрешить следующие адреса:
- 81.211.57.50
- 81.211.57.52
- 185.6.175.138
- 185.6.175.142
Карты для проведения операций оплаты в тестовом контуре:
Номер карты | Срок действия, месяц | Срок действия, год | CVV / CVC2 | Имя держателя | 3DS | Результат оплаты | Получаемая ошибка |
---|---|---|---|---|---|---|---|
4652035440667037 | 8 | Следующий год | 971 | Любое Имя | Нет | Успешно | - |
4051060000000178 | 12 | Следующий год | 895 | Любое Имя | Да | Успешно | - |
5105105105105100 | 3 | Следующий год | 235 | Любое Имя | Нет | Успешно | - |
5547629478785897 | 7 | Следующий год | 123 | Любое Имя | Да | Успешно | - |
2200204265570145 | 3 | Следующий год | 235 | Любое Имя | Нет | Успешно | - |
2200201673687446 | 7 | Следующий год | 123 | Любое Имя | Да | Успешно | - |
5563693062030796 | 3 | Любой, до 20 лет в будущем | 235 | Любое Имя | Нет | НЕ успешно | Stolen card, pick up |
4921301010459253 | 3 | Любой, до 20 лет в будущем | 235 | Любое Имя | Нет | НЕ успешно | Default error |
2200200000000000 | 3 | Любой, до 20 лет в будущем | 235 | Любое Имя | Нет | НЕ успешно | Non Sufficient Funds |
Карты для проведения операций выплаты на карту в тестовом контуре:
Номер карты | Код ответа | Описание | Статус выплаты |
---|---|---|---|
4149605380309302 | 1 | SUCCEED MAX AMOUNT IS 1000 RUB | SUCCESS |
4485911421241112 | -14 | Transfer to this card is prohibited | CANCELLED |
4532630960308024 | -3 | Unknown transaction | CANCELLED |
4508391810655094 | -13 | Attempt to exceed the limit for transfers | CANCELLED |
4716697592364426 | -25 | PaymentServer rejection | CANCELLED |
4716651015234500 | -11 | 28 (For this card the response is delayed with 30 seconds to simulate the timeout) | PENDING |
4716658082797970 | -11 | Unsuccessful transaction in PaymentServer | PENDING |
Карты для проведения оплат в тестовом контуре с использованием 3DS симулятора:
Номер карты | Срок действия, месяц | Срок действия, год | CVV / CVC2 | Имя держателя | 3DS | Результат оплаты |
---|---|---|---|---|---|---|
4111111111111111 | Любой | Любой, до 20 лет вперёд | Любой | Любое Имя | Выбор в симуляторе | Вариабелен |
Специфические суммы операций в тестовом контуре:
Amount (сумма операции) | Fraud check Result (результат антифрод проверки) |
---|---|
140 RUB | invalid decision - неверное решение системы противодействия мошенничеству |
150 RUB | internal error in scoring - ошибка при скоринге операции |
200 RUB | manual review stage - ручная проверка платежа |
333 RUB | directly fraud - отказ платежа, как признанного мошенническим |
Как это работает:
API поддерживает идемпотентность для безопасного повторения запросов без случайного повторного выполнения одной и той же операции.
Идемпотентность работает, сохраняя ответы на запросы в течение 24 часов, в течение которых клиенты могут использовать тот же ключ идемпотентности для получения исходного ответа. Создание нескольких идентичных запросов имеет тот же эффект, что и выполнение одного запроса.
Вы можете использовать один и тот же ключ идемпотентности в течение 24 часов, после чего ключ будет удален.
Все запросы POST принимают ключи идемпотентности. Отправка ключей идемпотентности в запросах GET и DELETE не имеет никакого эффекта, и ее следует избегать.
Отправка ключа идемпотентности:
Ключ идемпотентности отправляется в заголовке запроса:
Заголовок | Описание |
---|---|
X-Header-Idempotency-Key | Любая непустая строка с максимальной длиной 36 символов |
Как это работает:
Чтобы избежать необоснованного количества запросов от одного продавца, некоторые API YourPayments защищены системой квот, которая разрешает только определенное количество запросов в течение 60 секунд. API-интерфейсы, защищенные этой системой, будут отправлять дополнительные заголовки ответа, чтобы пользовательское приложение знало, сколько запросов у него осталось. Если продавец превысит свою квоту, ему придется подождать, прежде чем делать дальнейшие запросы к этому API.
Ограничения API указаны в заголовках ниже:
Заголовок | Описание |
---|---|
X-Rate-Limit-Limit | Количество разрешенных запросов за период 60 секунд |
X-Rate-Limit-Reset | Сколько времени в секундах осталось до конца текущего периода в 60 секунд |
X-Rate-Limit-Remaining | Сколько запросов доступно до конца текущего периода 60 секунд |
Превышение квоты запросов
Когда клиент превышает квоту запросов, сервер возвращает код ответа HTTP 429 (Too many requests)
Все запросы, выполняемые к процессинговой платформе, должны включать корректно расчитаную подпись, в противном случае в обработке будет отказано.
Подпись передается в заголовке запроса X-Header-Signature. Также должны быть отправлены следующие заголовки:
Идентификационный код продавца
Ваш идентификационный код (код мерчанта) в нашей системе (вы можете найти его в личном кабинете Меню: "Управление учетной записью > Настройки учетной записи > поле "Код продавца")
Тип схемы: | API-Key |
---|---|
Имя заголовка : | X-Header-Merchant |
Дата
Дата запроса в формате ISO 8601 (например, 2020-01-01T11:22:33+03:00)
Тип схемы: | API-Key |
---|---|
Имя заголовка : | X-Header-Date |
Подпись
Подпись рассчитывается с помощью алгоритма HMAC-SHA256 (ваш секретный ключ является ключом шифрования) применяемого к базовой строке, собираемой по следующему правилу:
- значение заголовка
X-Header-Merchant
- значение заголовка
X-Header-Date
- HTTP-метод (
POST
,GET
,PUT
,DELETE
) - базовый путь из URL-адреса вызова API (например: /api/v4/payments/authorize)
- строка запроса из URL-адреса вызова API (если применимо)
- контрольная сумма MD5 (строчный шестнадцатеричный) тела запроса
Все символы подписи должны быть строчными шестнадцатеричными символами (например:
da0b9f5e7e12cd02f02ed1591802d3739762a69c0ea31e8a3b28e6eb817b73ec
).
Ваш секретный ключ можно найти в личном кабинете, в разделе «Управление учетной записью» / «Настройки учетной записи». Если вам требуется дополнительная помощь на этом этапе, свяжитесь с нами.
Базовый путь и строка запроса вычисляются, как указано в разделе «Синтаксические компоненты» RFC3986.
Если в вашем запросе нет тела, то последним элементом из приведенного выше списка будет контрольная сумма MD5 от
пустой строки "". Примером здесь может быть любой GET
запрос.
Тип схемы: | API-Key |
---|---|
Имя заголовка : | X-Header-Signature |
В рамках постоянного улучшения функциональности нашего API, мы рады сообщить о добавлении нового поля под названием Details. Это обновление открывает перед разработчиками новые возможности для передачи данных, обеспечивая большую гибкость и удобство при интеграции с нашей системой.
Описание нового поля
Название поля: Details
Формат данных: JSON
Размер данных: Не ограничен (при снятии лимитов)
Предназначение: Поле Details предназначено для передачи любых данных в формате JSON, которые могут быть
использованы для последующей обработки или хранения на стороне сервера.
Работает с запросами: "Создание и авторизация платежа", "Списание", "Возврат/Отмена платежа"
Основные преимущества
- Гибкость передачи данных:
Благодаря формату JSON, поле Details позволяет передавать структурированные данные любой сложности. Это особенно полезно в случаях, когда требуется передать дополнительные параметры, метаданные или контекстную информацию, которая не укладывается в стандартные поля API. - Отсутствие ограничений на размер данных:
Мы сняли ограничения на размер данных, передаваемых в поле Details. Это позволяет разработчикам передавать большие объемы информации без необходимости разделения на несколько запросов. Однако, важно помнить, что при передаче больших данных следует учитывать производительность и ограничения инфраструктуры. - Универсальность:
Поле Details может быть использовано для различных сценариев: от передачи дополнительных параметров для обработки запроса до хранения произвольных данных, которые могут понадобиться в будущем. Это делает API более адаптивным к потребностям разработчиков.
Пример использования
Предположим, вы хотите передать в API информацию о заказе, включая дополнительные детали, такие как метаданные, пользовательские настройки или контекстные данные. С новым полем Details это можно сделать следующим образом:
{
"merchantPaymentReference": "test-0035",
"currency": "RUB",
"authorization": {
"usePaymentPage": "YES",
"paymentMethod": "CCVISAMC"
},
"details": {
"metadata": {
"source": "mobile_app",
"version": "1.2.3"
},
"preferences": {
"language": "en",
"notifications": true
},
"context": {
"referral_code": "REF123",
"campaign_id": "CAMP456"
}
}
}
В этом примере поле Details содержит дополнительную информацию, которая может быть использована для персонализации обработки заказа или для аналитических целей.
Рекомендации по использованию
- Оптимизация данных:
Хотя размер данных в поле Details не ограничен, рекомендуется оптимизировать объем передаваемой информации, чтобы избежать излишней нагрузки на сеть и сервер. - Структурирование JSON:
Для удобства обработки данных на стороне сервера, рекомендуется придерживаться четкой структуры JSON-объекта в поле Details. Это упростит парсинг и использование данных. - Безопасность:
При передаче чувствительных данных в поле Details, убедитесь, что используется защищенное соединение (HTTPS) и данные зашифрованы, если это необходимо.
Постскриптум
Добавление поля Details в наш API - это важный шаг в направлении повышения гибкости и универсальности нашего сервиса. Мы уверены, что это нововведение позволит разработчикам более эффективно решать свои задачи и создавать более сложные и функциональные интеграции.
Списание
Запрос используется по необходимости. Если не настроено автоматическое списание, или если необходимо списать средства до того момента, когда средства будут списаны автоматически.
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
X-Header-Idempotency-Key | string Example: 60ibwxptqpsw7czp0u4zzwjj3fhmnfozmw08 Ключ идемпотентности |
Request Body schema: application/jsonrequired
required | number or string <integer> (PayuPaymentReference) > 0 Example: "896782" Номер транзакции в системе YourPayments |
required | number or string <double> Example: "5.66" Сумма исходной авторизации (полученная в response авторизационного запроса в параметре amount) |
required | number or string <double> Example: "5.66" Сумма, которая будет списана |
currency required | |
object (Details) Содержит данные с расширенными сведениями в парах ключ/значение. |
Responses
Request samples
- Payload
{- "payuPaymentReference": 896782,
- "originalAmount": 5.66,
- "amount": 5.66,
- "currency": "EUR",
- "details": {
- "receipts": "string"
}
}
Response samples
- 200
- 429
- 4XX
- 5XX
{- "payuPaymentReference": 896782,
- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response"
}
Возврат/Отмена платежа
Возврат и Отмена платежа производятся одним и тем же методом, при этом важно понимать, что:
Отмена - Операция отмены блокировки средств на карте. Производится до момента списания средств.
Возврат - Операция возврата средств, ранее списанных с карты плательщика.
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
X-Header-Idempotency-Key | string Example: 60ibwxptqpsw7czp0u4zzwjj3fhmnfozmw08 Ключ идемпотентности |
Request Body schema: application/jsonrequired
required | number or string <integer> (PayuPaymentReference) > 0 Example: "896782" Номер транзакции в системе YourPayments |
required | number or string <double> Example: "5.66" Первоначальная сумма сделки (включая стоимость платежей в рассрочку, если применимо) |
currency required | |
amount required | number <double> Example: "5.66" Сумма, которая будет возвращена клиенту. Она не должен превышать разницу между суммой исходной операции и суммой ранее совершенных возвратов по этой операции (нельзя вернуть клиенту больше чем он заплатил). Сумма должна быть строго положительным числом. |
merchantRefundReference | string <string> Example: "6c6ATzmtUD" Уникальный идентификатор возврата (если он необходим). |
Array of objects Обязательно в случае оплаты с разделением платежа | |
object (Details) Содержит данные с расширенными сведениями в парах ключ/значение. |
Responses
Request samples
- Payload
{- "payuPaymentReference": 896782,
- "originalAmount": 5.66,
- "currency": "EUR",
- "amount": 5.66,
- "merchantRefundReference": "6c6ATzmtUD",
- "marketplaceV1": [
- {
- "merchant": "YPMN_2",
- "amount": 4.6
}
], - "details": {
- "receipts": "string"
}
}
Response samples
- 200
- 202
- 429
- 4XX
- 5XX
{- "payuPaymentReference": 896782,
- "code": 200,
- "message": "Confirmed",
- "status": "A text representing the status of the response",
- "refundRequestId": "800d45c7-70c4-4107-ac7c-29bf03cdab63"
}
Статус платежа
path Parameters
merchantPaymentReference required | string <= 100 characters Номер заказа в системе продавца |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 404
- 429
- 5XX
{- "paymentStatus": "PAYMENT_AUTHORIZED",
- "payuPaymentReference": 896782,
- "code": 200,
- "message": "Success",
- "authorizations": [
- {
- "timestamp": "2022-01-02T12:00:14+00:00",
- "authorized": "SUCCESS",
- "cardDetails": {
- "cardScheme": "VISA",
- "cardType": "DEBIT",
- "issuerBank": "BRD Groupe Societe Generale",
- "issuerCountryCode": "RU",
- "cardProfile": "CONSUMER",
- "lastFourDigits": "1111",
- "binNumber": "411111"
}, - "storedCredentials": {
- "useId": "123456"
}
}
]
}
Отличие Оплаты с разделением платежа от Оплаты без разделения
Оплата с разделением отличается от обычной оплаты тем, что у каждого продукта в операции есть "владелец/продавец".
Таким образом:
- в запросе на авторизацию появляются дополнительные характеристики у каждого продукта в блоке products -> marketplace
- в запросе на возврат появляется дополнительный блок marketplaceV1, указывающий на продавца, который должен выплатить деньги в рамках операции возврата.
- так же как и в обычной Операции возврата - продавец не может вернуть покупателю больше средств, чем получил.
После оплаты пользователь направляется на указанный URL, указанный в параметра returnUrl
запроса на авторизацию платежа,
POST или GET запросом.
Возврат покупателя POST-запросом
Request Body schema: application/x-www-form-urlencodedrequired
body | string <json> (ReturnUrlRequestBody) Example: "{\"payuPaymentReference\":\"896782\",\"status\":\"SUCCESS\",\"paymentResult\":{\"payuResponseCode\":\"AUTHORIZED\"},\"message\":\"Authorized.\",\"merchantPaymentReference\":\"34dfsd-sdgds\",\"code\":200}" Строковое представление json объекта с информацией о заказе |
signature | string (ReturnUrlRequestSignature) Example: "0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c" Подпись запроса |
merchant | string (ReturnUrlRequestMerchant) Example: "MERCH_CODE" Идентификатор продавца в системе YourPayments |
date | string <ISO_8601> (ReturnUrlRequestDate) Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Возврат покупателя GET-запросом
query Parameters
body | string <json> (ReturnUrlRequestBody) Example: body={"payuPaymentReference":"896782","status":"SUCCESS","paymentResult":{"payuResponseCode":"AUTHORIZED"},"message":"Authorized.","merchantPaymentReference":"34dfsd-sdgds","code":200} Строковое представление json объекта с информацией о заказе |
signature | string (ReturnUrlRequestSignature) Example: signature=0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
merchant | string (ReturnUrlRequestMerchant) Example: merchant=MERCH_CODE Идентификатор продавца в системе YourPayments |
date | string <ISO_8601> (ReturnUrlRequestDate) Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Коды ответов на запрос авторизации
Ниже приведен список кодов/сообщений, которые могут появиться в случае неудачных транзакций (<status>FAILED</status>
).
Обращаем ваше внимание, что указанные коды ошибок отображаются в зависимости от ответа платежной системы или банка, выпустившего карту (эмитента). Ответ банка эмитента соответствует его внутренним процедурам и не всегда может полностью раскрывать причину отказа по конкретной операции.
Код ответа | Значение | Описание |
---|---|---|
AUTHORIZED | Successful authorization | Успешная авторизация |
3DS_ENROLLED | 3DS redirect required. The response to the authorisation request will have: "url": "URL to redirect user" и "type": "redirect" |
Требуется редирект на 3DS. В ответе на запрос авторизации будет: "url": "Адрес для редиректа пользователя" и "type": "redirect" |
PENDING_AUTHORIZATION | Waiting for payment, redirect to payment page required. The response to the authorisation request will have: "url": "URL to redirect user" и "type": "redirect" |
Ожидает оплаты, требуется редирект на платежную страницу. В ответе на запрос авторизации будет: "url": "Адрес для редиректа пользователя" и "type": "redirect" |
ALREADY_AUTHORIZED | The payment for your order is already authorized | Операция уже авторизована, в повторной попытке нет необходимости |
GW_ERROR_GENERIC | An error occurred during processing. Please retry the operation | При обработке произошла ошибка. Пожалуйста, повторите операцию |
GW_ERROR_GENERIC_3D | An error occurred during 3DS processing | Произошла ошибка при обработке 3DS |
GWERROR_-19 | Authentication failed | Ошибка аутентификации |
GWERROR_-18 | Error in CVC2 or CVC2 Description fields | Ошибка в CVC2 или его описании |
GWERROR_-10 | Error in amount field | Ошибка в сумме операции (недопустимо значение 0, может быть отказ со стороны эмитента по транзакциям меньше 1 руб) |
GWERROR_-9 | Error in card expiration date field | Ошибка в поле срока действия карты |
GWERROR_-8 | Invalid card number | Номер карты не корректен |
GWERROR_-3 | No or Invalid response received | Позвоните в службу поддержки эквайера (отказ без указания причины, комментарий может дать только банк, обслуживающий операцию |
GWERROR_-2 | An error occurred during processing. Please retry the operation | Ошибка обработки. Пожалуйста, повторите операцию |
GWERROR_01 | Card type not active or incorrect PIN | Карта не поддерживается или неверный PIN-код |
GWERROR_02 | Refer to card issuer, special condition | Обратитесь к эмитенту карты, отказ с по особым условиям |
GWERROR_03 | Invalid merchant | Неверно указан продавец |
GWERROR_04 | Restricted card | Функционал карты ограничен эмитентом |
GWERROR_05 | Authorization declined | В авторизации отказано |
GWERROR_06 | Error - retry | Ошибка. Повторите попытку. |
GWERROR_07 | Password incorrect or card disabled | Неверный пароль или карта отключена |
GWERROR_08 | Invalid amount | Недопустимая сумма |
GWERROR_12 | Amount exceeds card ceiling | Данная сумма превышает допустимую, и не может быть проведена с данной карты, |
GWERROR_13 | Invalid amount | Недопустимая сумма |
GWERROR_14 | No such card | Нет такой карты |
GWERROR_15 | No such card/issuer | Нет такой карты/эмитента |
GWERROR_17 | Customer cancellation | Отменено плательщиком |
GWERROR_19 | Re-enter transaction | Повторно ввести транзакцию |
GWERROR_20 | Invalid response | Неверный ответ банка |
GWERROR_22 | Suspected Malfunction | Подозрение на неисправность |
GWERROR_30 | Format error | Ошибка формата |
GWERROR_34 | Credit card number failed the fraud | Система защиты от мошенничества блокировала операцию по данной карте |
GWERROR_36 | Credit restricted | Кредит ограничен |
GWERROR_41 | Lost card | Карта утерянна |
GWERROR_43 | Stolen card, pick up | Украдена карта |
GWERROR_51 | Insufficient funds | Недостаточно средств |
GWERROR_54 | Expired card | Срок действия карты истек |
GWERROR_55 | Incorrect PIN | Неверный PIN-код |
GWERROR_57 | Transaction not permitted on card | Транзакция по карте не разрешена |
GWERROR_58 | Not permitted to merchant | Не разрешено торговцу |
GWERROR_59 | Suspected fraud | Подозрение на мошенничество |
GWERROR_61 | Exceeds amount limit | Превышает лимит суммы |
GWERROR_62 | Restricted card | Ограниченние по карте |
GWERROR_63 | Security violation | Нарушение правил безопасности |
GWERROR_65 | Exceeds frequency limit | Превышен предел частоты платежей с данной карты |
GWERROR_68 | Response received too late | Ответ получен слишком поздно, время ожидания ответа истекло |
GWERROR_75 | PIN tries exceeded | Количество попыток ввести ПИН-код превышено |
GWERROR_76 | Wrong pin, tries exceeded | Неверный пин-код, количество попыток превышено |
GWERROR_78 | Reserved | В случае, когда контракт эмитента и держателя карты расторгнут или приостановлен. |
GWERROR_82 | Time-out at issuer | Тайм-аут со стороны эмитента карты |
GWERROR_83 | Unable to verify PIN | Не удалось подтвердить PIN-код |
GWERROR_84 | Invalid cvv | Неверный CVV |
GWERROR_88 | Cryptographic failure | Сбой криптографии при передаче данных в платежную систему. |
GWERROR_89 | Authentication failure | Ошибка аутентификации |
GWERROR_91 | A technical problem occurred. Issuer cannot process | Техническая ошибка. Эмитент не может обработать операцию |
GWERROR_93 | Violation of law | Нарушение законодательства (в некоторых странах законодательно запрещено платить локальными картами в зарубежных магазинах) |
GWERROR_94 | Duplicate transmission | Отказ в проведении операции по причине срабатывания контроля дубликатов |
GWERROR_95 | Reconcile error | Ошибка реконсиляции (сверки) на стороне банка -эквайера или банка-эмитента |
GWERROR_96 | System malfunction | Неисправность системы |
GWERROR_98 | Error during canceling transaction | Ошибка при отмене транзакции |
GWERROR_99 | Incorrect card brand | Неверный бренд карты |
GWERROR_102 | Acquirer timeout | Тайм-аут на стороне банка-эквайера |
GWERROR_105 | 3DS authentication error | Ошибка аутентификации 3DS |
GWERROR_107 | Sorry, at the moment the transaction cannot be processed due to ecessive retries with this card. Please try using another card. | К сожалению, в настоящее время транзакция не может быть обработана из-за большого количества повторных попыток оплаты этой картой. Попробуйте использовать другую карту |
GWERROR_108 | Sorry, at the moment the transaction cannot be processed. Please try using another card. | К сожалению, в данный момент транзакция не может быть обработана. Попробуйте использовать другую карту |
GWERROR_109 | Inactive card, please activate the card first. | Неактивная карта, сначала активируйте карту |
GWERROR_2304 | There is an ongoing process your order. | Ваш заказ находится в обработке (блокирует повторную операцию с теми же данными) |
GWERROR_5007 | Debit cards only supports 3DS operations. | Данная дебетовая карта поддерживает только 3DS-операции |
-9999 | Banned operation | Отказ системы противодействия мошенничеству. Операция заблокирована |
Позволяет совершать переводы на карту, а также может получать информацию о прошлых выплатах или текущем балансе, доступном для выплат.
Создание запроса на выплату
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
X-Header-Idempotency-Key | string Example: 60ibwxptqpsw7czp0u4zzwjj3fhmnfozmw08 Ключ идемпотентности |
Request Body schema: application/jsonrequired
merchantPayoutReference required | string (MerchantPayoutReference) non-empty Example: "896782" Допускаются только a-z, A-Z, 0-9, тире и подчеркивание. |
required | object (PayoutAmount) Объект, содержащий информацию о сумме выплаты |
description required | string (PayoutDescription) <= 255 characters Example: "Description of payout" Детали выплаты |
required | object (PayoutDestination) Объект, содержащий информацию о пункте назначения |
required | object (PayoutSource) Источник, из которого будет получена сумма выплаты. В настоящее время для этого поля поддерживается только значение "merchantBalance" |
Responses
Request samples
- Payload
{- "merchantPayoutReference": "896782",
- "amount": {
- "currency": "EUR",
- "value": 5.66
}, - "description": "Description of payout",
- "destination": {
- "type": "card",
- "card": {
- "cardNumber": "4111111111111111"
}, - "recipient": {
- "type": "individual",
- "email": "example@email.com",
- "city": "Moscow",
- "address": "Sector 2",
- "postalCode": "510002",
- "countryCode": "RU",
- "firstName": "John",
- "lastName": "Doe"
}
}, - "source": {
- "type": "merchantBalance",
- "sender": {
- "firstName": "John",
- "lastName": "John",
- "email": "senderEmail@mail.com",
- "phone": "0764111111"
}
}
}
Response samples
- 200
- 401
- 429
- 502
- 4XX
- 5XX
{- "payuPayoutReference": "123",
- "payoutStatus": "SUCCESS",
- "amount": {
- "currency": "EUR",
- "value": 5.66
}, - "merchantCode": "MERCH_V1",
- "commission": {
- "merchant": 5.66,
- "payee": 2.66
}, - "merchantPayoutReference": "896782",
- "description": "Description of payout",
- "destination": {
- "type": "card",
- "recipient": {
- "type": "individual",
- "email": "example@email.com",
- "city": "Moscow",
- "address": "Sector 2",
- "postalCode": "510002",
- "countryCode": "RU",
- "firstName": "John",
- "lastName": "Doe"
}
}, - "source": {
- "type": "merchantBalance",
- "sender": {
- "firstName": "John",
- "lastName": "John",
- "email": "senderEmail@mail.com",
- "phone": "0764111111"
}
}, - "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "SUCCESS"
}
Запрос отчета по выплатам
Возвращает коллекцию выплат на основе параметров запроса.
В данном API есть ограничение на количество возвращаемых результатов - 50.
Чтобы получить полный отчет, соответствующий условиям, вы должны продолжать последовательно вызывать API, используя URL-адрес, указанный в узле _links из ответа в параметре next (для получения более подробной информации вы можете проверить структуру ответа ниже).
query Parameters
merchantCodes | Array of strings[ items non-empty ] Example: merchantCodes=MERCH_V1 Массив торговых кодов |
startDate | string <ISO_8601> Example: startDate=2021-04-12T16:40:00-04:00 Дата и время начала диапазона для отображения в ответе. Он должен быть в формате ISO_8601 Ymd\TH:i:sP |
endDate | string <ISO_8601> Example: endDate=2021-04-12T16:40:00-04:00 Дата и время окончания диапазона для отображения в ответе. Он должен быть в формате ISO_8601 Ymd\TH:i:sP |
page | number <int> Example: page=2 Номер страницы, указывающий, какой набор элементов будет возвращен в ответе. |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 401
- 429
- 502
- 4XX
- 5XX
{- "items": [
- {
- "payuPayoutReference": "123",
- "payoutStatus": "SUCCESS",
- "amount": {
- "currency": "EUR",
- "value": 5.66
}, - "merchantCode": "MERCH_V1",
- "commission": {
- "merchant": 5.66,
- "payee": 2.66
}, - "merchantPayoutReference": "896782",
- "description": "Description of payout",
- "destination": {
- "type": "card",
- "recipient": {
- "type": "individual",
- "email": "example@email.com",
- "city": "Moscow",
- "address": "Sector 2",
- "postalCode": "510002",
- "countryCode": "RU",
- "firstName": "John",
- "lastName": "Doe"
}
}, - "source": {
- "type": "merchantBalance",
- "sender": {
- "firstName": "John",
- "lastName": "John",
- "email": "senderEmail@mail.com",
- "phone": "0764111111"
}
}
}
], - "_links": {
- "prev": "/v4/payout?startDate=2021-04-12T16:40:00-04:00&endDate=2021-04-17T16:40:00-04:00&page=1",
- "next": "/v4/payout?startDate=2021-04-12T16:40:00-04:00&endDate=2021-04-17T16:40:00-04:00&page=2",
- "last": "/v4/payout?startDate=2021-04-12T16:40:00-04:00&endDate=2021-04-17T16:40:00-04:00&page=25"
}, - "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response"
}
Запрос на получение баланса
query Parameters
merchantCodes | Array of strings[ items non-empty ] Example: merchantCodes=MERCH_V1 Массив кодов отправителя (если у Вас их несколько и необходимо получить отчет только по некоторым из них) |
minValue | number <double> > 0 Example: minValue=5.66 Минимальная сумма баланса. Указание этого параметра обязательно должно сопровождаться указанием валюты в параметре currency |
maxValue | number <double> > 0 Example: maxValue=5.66 Максимальная сумма баланса. Указание этого параметра обязательно должно сопровождаться указанием валюты в параметре currency |
currency |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 401
- 429
- 502
- 4XX
- 5XX
{- "items": [
- {
- "merchantCode": "MERCH_V1",
- "currency": "EUR",
- "value": 5.66,
- "timestamp": "2021-06-01 10:20:01"
}
], - "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response"
}
Проверка получателя СБП
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
phoneNumber required | any <string> Example: "791111111111" Номер телефона получателя |
fio | any <string> Example: "Иванов Иван Иванович" ФИО получателя. Не обязательно, можно передать, чтобы проверить на совпадение |
bankId required | any <string> Example: "100000000001" Id банка |
Responses
Request samples
- Payload
{- "phoneNumber": 791111111111,
- "fio": "Иванов Иван Иванович",
- "bankId": 100000000001
}
Response samples
- 200
- 401
- 429
- 502
- 4XX
- 5XX
{- "result": "success",
- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "fioNSPK": "Иванов Иван Иванович"
}
Получение списка банков
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 401
- 429
- 502
- 4XX
- 5XX
{- "list": [
- {
- "BankName": "Газпромбанк",
- "BankID": 100000000001
}
], - "code": 200,
- "message": "Success",
- "status": "SUCCESS"
}
Специфические суммы операций для выплат СБП в тестовом контуре
Сумма операции (amount), руб | Результат оплаты (payment result) |
---|---|
1011 | Успешная выплата |
1012 | Неуспешная выплата. Отказ эмитента |
1013 | Неуспешная выплата. Зависает в ожидании, не получен ответ от банка |
1014 | Неуспешная выплата. Недостаточно средств на счете |
1015 | Неуспешная выплата. Свяжитесь с Получателем средств и уточните реквизиты для зачисления денежных средств |
1020 | Неуспешная выплата. Ошибка на стороне эмитента |
IPN-запрос YourPayments
Адрес для отправки вебхука (merchant-ipn-url
) регистрируется в личном кабинете (настройка адреса описана Здесь)
Это общая структура запросов, которые YourPayments отправляет продавцу на основе нескольких событий платежного потока. Поведение этого можно изменить из CPanel.
Для IPN, отправленных в случае заказов на возврат, информация о продуктах (таких как name
, sku
, additionalDetails
) может отсутствовать или отличаться от тех, которые были отправлены в запросе на авторизацию.
В случае IPN для заказов на возврат информация о продукте будет отправлена только в том случае, если это «Полный возврат» или «Частичный возврат только для одного продукта». Из-за этого вы не должны использовать эти поля для сопоставления продуктов или выполнения определенной логики на их основе.
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
X-Header-Idempotency-Key | string Example: 60ibwxptqpsw7czp0u4zzwjj3fhmnfozmw08 Ключ идемпотентности |
Request Body schema: application/jsonrequired
object (IpnOrderData) Этот узел отправляется YourPayments по запросу IPN с информацией о заказе | |
object (IpnPaymentResult) Этот узел отправляется YourPayments по запросу IPN с соответствующей платежной информацией. | |
object (IpnClientData) Этот узел отправляется YourPayments по запросу IPN с соответствующими данными клиента. | |
Array of objects (IpnProducts) | |
dateTime | string Example: "20190114143730" Значение даты и времени на момент отправки запроса в формате «ГГГГММДДЧЧММСС» |
object (AuthorizationResource) Этот узел отправляется YourPayments с информацией об использованной карте. | |
object (FX) Этот узел отправляется YourPayments с информацией о курсе валют при оплате зарубежными картами. |
Responses
Request samples
- Payload
{- "orderData": {
- "orderDate": "2018-08-02T12:00:14+00:00",
- "payuPaymentReference": "6742343",
- "merchantPaymentReference": "34dfsd-sdgds",
- "status": "PAYMENT_AUTHORIZED",
- "currency": "RUB",
- "amount": "352.30",
- "commission": "25.10",
- "loyaltyPointsAmount": 0,
- "loyaltyPointsDetails": [
- {
- "type": "BNS",
- "amount": "5"
}
], - "refundInfo": {
- "chargeback": "the merchandise does not match the merchant's description."
}, - "refundRequestId": "2149a875-8984-471a-b4a4-b74fa28b59ff"
}, - "paymentResult": {
- "paymentMethod": "CCVISAMC",
- "paymentDate": "2018-08-02T12:00:14+00:00",
- "captureDate": "2018-08-02T12:00:14+00:00",
- "cardProgramName": "World",
- "installmentsNumber": "5",
- "authCode": 324534,
- "merchantId": "A891911",
- "rrn": 43534654,
- "cardDetails": {
- "bin": "424242",
- "owner": "John Doe",
- "pan": "4242-xxxx-xxxx-2466",
- "type": "Visa",
- "cardIssuerBank": "EST"
}, - "paymentBankShortName": "BRD",
- "serviceProcessingType": "TSP"
}, - "client": {
- "billing": {
- "firstName": "John",
- "lastName": "Doe",
- "email": "test@ypmn.ru",
- "countryCode": "RU",
- "phone": 771346934,
- "city": "Moscow",
- "state": "Moscow",
- "companyName": "YPMN",
- "taxId": "example",
- "addressLine1": "example",
- "addressLine2": "example",
- "zipCode": "example",
- "identityDocument": {
- "number": 123445,
- "type": "PERSONALID"
}
}, - "delivery": {
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "Example Inc.",
- "addressLine1": "example address 1",
- "addressLine2": "example address 2",
- "city": "Bucharest",
- "state": "Ilfov",
- "zipCode": "900169",
- "countryCode": "ro",
- "phone": "+407101082567",
- "email": "example@email.com"
}, - "ip": "192.168.24.1",
- "ipCountry": "Russia"
}, - "products": [
- {
- "name": "Product name",
- "sku": "Code_XYZ",
- "additionalDetails": "Product additional information",
- "unitPrice": "21",
- "quantity": "2",
- "vatAmount": "12"
}
], - "dateTime": "20190114143730",
- "authorization": {
- "timestamp": "2022-01-02T12:00:14+00:00",
- "authorized": "SUCCESS",
- "cardDetails": {
- "cardScheme": "VISA",
- "cardType": "DEBIT",
- "issuerBank": "BRD Groupe Societe Generale",
- "issuerCountryCode": "RU",
- "cardProfile": "CONSUMER",
- "lastFourDigits": "1111",
- "binNumber": "411111"
}, - "storedCredentials": {
- "useId": "123456"
}
}, - "fx": {
- "currency": "USD",
- "exchangeRate": "5.66",
- "amountRUB": "566.00",
- "amountCur": "100.00"
}
}
Вебхук по операциям выплат
Адрес для отправки вебхука (merchant-payout-url
) регистрируется в личном кабинете (настройка адреса описана Здесь)
Это общая структура запросов, которые YourPayments отправляет продавцу на основе событий выплат. Поведение этого можно изменить из CPanel.
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
object (PayoutOrderData) Этот узел отправляется YourPayments по запросу выплаты с информацией о заказе | |
object (PayoutPaymentResult) Этот узел отправляется YourPayments по запросу выплаты с соответствующей платежной информацией. | |
object (WebhookPayoutRecipient) |
Responses
Request samples
- Payload
{- "orderData": {
- "orderDate": "2018-08-02T12:00:14+00:00",
- "payuPayoutReference": "6742343",
- "merchantPayoutReference": "896782",
- "currency": "EUR",
- "amount": "352.30",
- "status": "PENDING",
- "message": "003.approved.active"
}, - "paymentResult": {
- "paymentMethod": "PAYOUT",
- "paymentDate": "2018-08-02T12:00:14+00:00",
- "authCode": 324534,
- "rrn": 43534654,
- "commission": {
- "merchant": 5.66,
- "payee": 2.66
}
}, - "recipient": {
- "city": "Moscow",
- "address": "Sector 2",
- "postalCode": "510002",
- "countryCode": "RU",
- "clientName": "testFirstName testLastName"
}
}
API позволяет продавцу создать токен (сохранить карту покупателя), а также получить информацию о токене или отменить его.
Создать токен
Создает токен из исходной операции. Чтобы сохранить карту необходимо сначала создать оплату с картой!
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
required | number or string <integer> (PayuPaymentReference) > 0 Example: "896782" Номер транзакции в системе YourPayments |
Responses
Request samples
- Payload
{- "payuPaymentReference": 896782
}
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "token": "d41d8cd98f00b204e9800998ecf8427e",
- "cardUniqueIdentifier": "e9fc5107db302fa8373efbedf55a1614b5a3125ee59fe274e7dc802930d68f6d",
- "expirationDate": "2023-06-10",
- "cardHolderName": "Test",
- "tokenStatus": "ACTIVE",
- "lastFourDigits": "1111",
- "cardExpirationDate": "2023-08-31"
}
Получить информацию о токене
path Parameters
token required | string Example: d41d8cd98f00b204e9800998ecf8427e Информация о токене карты |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "token": "d41d8cd98f00b204e9800998ecf8427e",
- "cardUniqueIdentifier": "e9fc5107db302fa8373efbedf55a1614b5a3125ee59fe274e7dc802930d68f6d",
- "expirationDate": "2023-06-10",
- "cardHolderName": "Test",
- "tokenStatus": "ACTIVE",
- "lastFourDigits": "1111",
- "cardExpirationDate": "2023-08-31",
- "networkToken": {
- "lastFourDigits": "1111",
- "expirationDate": "2023-08-31"
}
}
Отменить токен
path Parameters
token required | string Example: d41d8cd98f00b204e9800998ecf8427e Информация о токене карты |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "token": "d41d8cd98f00b204e9800998ecf8427e",
- "cardUniqueIdentifier": "e9fc5107db302fa8373efbedf55a1614b5a3125ee59fe274e7dc802930d68f6d",
- "expirationDate": "2023-06-10",
- "cardHolderName": "Test",
- "tokenStatus": "ACTIVE",
- "lastFourDigits": "1111",
- "cardExpirationDate": "2023-08-31"
}
Получить информацию о карте
path Parameters
cardBin required | string [ 6 .. 10 ] characters Example: 411111 БИН карты |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "binNumber": 411111,
- "cardScheme": "VISA",
- "issuerBank": "BRD Groupe Societe Generale",
- "issuerCountryCode": "RU",
- "cardType": "DEBIT",
- "cardProfile": "CONSUMER",
- "cardProgram": "Name of the program",
- "installmentOptions": [
- {
- "installmentNumber": 1
}
], - "paymentMethod": "CCVISAMC"
}
Получить информацию о карте по токену
path Parameters
token required | string Example: d41d8cd98f00b204e9800998ecf8427e Токен карты |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "binNumber": 411111,
- "cardScheme": "VISA",
- "issuerBank": "BRD Groupe Societe Generale",
- "issuerCountryCode": "RU",
- "cardType": "DEBIT",
- "cardProfile": "CONSUMER",
- "cardProgram": "Name of the program",
- "installmentOptions": [
- {
- "installmentNumber": 1
}
], - "paymentMethod": "CCVISAMC"
}
Получить отчет в формате JSON
Предоставление отчета не является синхронным, отчет может формироваться до нескольких минут.
query Parameters
startDate | string Example: startDate=2023-11-01 Дата начала отчета |
endDate | string Example: endDate=2023-11-14 Дата окончания отчета |
periodLength | string Enum: "hour" "day" "week" "month" Группировка по часам, дням, неделям, месяцам |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response",
- "startDate": "2023-11-01",
- "endDate": "2023-11-14",
- "periodLength": "day",
- "periods": [
- {
- "startDate": "2023-11-01 00:00:00",
- "endDate": "2023-11-01 23:59:59",
- "paymentMethods": [
- {
- "method": "CCVISAMC",
- "pending": "2",
- "pendingAmount": "450.00",
- "authorized": "3",
- "authorizedAmount": "350.00",
- "completed": "4",
- "completedAmount": "650.00",
- "reversed": "1",
- "reversedAmount": "250.00",
- "refund": "1",
- "refundAmount": "100.00"
}
]
}
]
}
Получить отчет в виде графика
Предоставление отчета не является синхронным, отчет может формироваться до нескольких минут.
query Parameters
startDate | string Example: startDate=2023-11-01 Дата начала отчета |
endDate | string Example: endDate=2023-11-14 Дата окончания отчета |
periodLength | string Enum: "hour" "day" "week" "month" Группировка по часам, дням, неделям, месяцам |
type | string Enum: "amount" "count" тип выводимых данных - сумма, количество |
status | Array of strings Items Enum: "COMPLETE" "AUTHRECEIVED" "PENDING" "CANCELED" "REVERSED" "REFUND" вывод определенных статусов оплаты |
showTotal | string Enum: "true" "1" выводить сводную таблицу после графика |
showToolbar | string Enum: "true" "1" выводить тулбар с фильтрами над графиком |
jsonUpdateUrl | string Example: jsonUpdateUrl=/api/chartUpdate ссылка на endpoint для обновления графика |
jsonForUpdate | string Enum: "true" "1" отдать данные для обновления графика в формате JSON |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
<div class='report-chart'> ... </div>
Получить потранзакционный отчет в JSON формате
Предоставление отчета не является синхронным, отчет может формироваться до нескольких минут.
query Parameters
startDate | string Example: startDate=2024-05-01T00:00:00+03:00 Дата начала отчета в ISO 8601 |
endDate | string Example: endDate=2024-05-14T00:23:00+03:00 Дата окончания отчета в ISO 8601 |
byConfirmation | string Enum: "YES" "NO" признак выбора даты фильтрации "YES" - по дате завершения заказа, "NO" или отсутствует в запросе - по дате заказа |
object Набор статусов транзакций включенных в выборку |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "code": 200,
- "startDate": "2024-05-01T00:00:00+03:00",
- "endDate": "2024-05-14T00:23:00+03:00",
- "byConfirmation": "YES",
- "data": [
- {
- "merchantPaymentReference": "1715749955353375903",
- "payuPaymentReference": "5374892697124",
- "status": "SUCCESS",
- "amount": "450",
- "currency": "RUB",
- "commission": "9",
- "paymentDate": "2023-11-01 10:00:00",
- "captureDate": "2023-11-01 10:01:00"
}
]
}
Получить детальный отчет по заказу
Предоставление отчета не является синхронным, отчет может формироваться до нескольких минут.
Для получения отчета укажите в запросе номер заказа мерчанта merchantPaymentReference или внутренний номер заказа payuPaymentReference.
query Parameters
merchantPaymentReference | string Example: merchantPaymentReference=34dfsd-sdgds Номер заказа мерчанта |
payuPaymentReference | string Example: payuPaymentReference=6742343 Номер транзакции в системе YourPayments |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 429
- 4XX
- 5XX
{- "dateTime": "2018-08-02T12:00:14+00:00",
- "orderData": {
- "orderDate": "2018-08-02T12:00:14+00:00",
- "payuPaymentReference": "6742343",
- "merchantPaymentReference": "34dfsd-sdgds",
- "status": "PAYMENT_AUTHORIZED",
- "currency": "RUB",
- "amount": "352.30",
- "commission": "25.10",
- "loyaltyPointsAmount": 0,
- "loyaltyPointsDetails": [
- {
- "type": "BNS",
- "amount": "5"
}
], - "refundInfo": [
- {
- "chargeback": "AUTO: IRN",
- "payuPaymentReference": "240118",
- "amount": "200.00",
- "rrn": "0f2a39ef-e296-4b0a-8068-90b5167b",
- "requestDate": "2024-06-14T11:37:57+00:00",
- "refundDate": "2024-06-14T11:37:57+00:00",
- "requestedBy": "IRN",
- "products": [
- {
- "sku": "38408",
- "name": "Diff for refund order products",
- "unitPrice": "-200",
- "quantity": "1",
- "additionalDetails": "Additional product details",
- "vatAmount": "0"
}
]
}
], - "refundRequestId": "2149a875-8984-471a-b4a4-b74fa28b59ff"
}, - "paymentResult": {
- "paymentMethod": "CCVISAMC",
- "paymentDate": "2018-08-02T12:00:14+00:00",
- "captureDate": "2018-08-02T12:00:14+00:00",
- "cardProgramName": "World",
- "installmentsNumber": "5",
- "authCode": 324534,
- "merchantId": "A891911",
- "rrn": 43534654,
- "cardDetails": {
- "bin": "424242",
- "owner": "John Doe",
- "pan": "4242-xxxx-xxxx-2466",
- "type": "Visa",
- "cardIssuerBank": "EST"
}, - "paymentBankShortName": "BRD",
- "serviceProcessingType": "TSP"
}, - "client": {
- "billing": {
- "firstName": "John",
- "lastName": "Doe",
- "email": "test@ypmn.ru",
- "countryCode": "RU",
- "phone": 771346934,
- "city": "Moscow",
- "state": "Moscow",
- "companyName": "YPMN",
- "taxId": "example",
- "addressLine1": "example",
- "addressLine2": "example",
- "zipCode": "example",
- "identityDocument": {
- "number": 123445,
- "type": "PERSONALID"
}
}, - "delivery": {
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "Example Inc.",
- "addressLine1": "example address 1",
- "addressLine2": "example address 2",
- "city": "Bucharest",
- "state": "Ilfov",
- "zipCode": "900169",
- "countryCode": "ro",
- "phone": "+407101082567",
- "email": "example@email.com"
}, - "ip": "192.168.24.1",
- "ipCountry": "Russia"
}, - "products": [
- {
- "name": "Product name",
- "sku": "Code_XYZ",
- "additionalDetails": "Product additional information",
- "unitPrice": "21",
- "quantity": "2",
- "vatAmount": "12"
}
], - "authorization": {
- "timestamp": "2022-01-02T12:00:14+00:00",
- "authorized": "SUCCESS",
- "cardDetails": {
- "cardScheme": "VISA",
- "cardType": "DEBIT",
- "issuerBank": "BRD Groupe Societe Generale",
- "issuerCountryCode": "RU",
- "cardProfile": "CONSUMER",
- "lastFourDigits": "1111",
- "binNumber": "411111"
}, - "storedCredentials": {
- "useId": "123456"
}
}, - "fx": {
- "currency": "USD",
- "exchangeRate": "5.66",
- "amountRUB": "566.00",
- "amountCur": "100.00"
}
}
Данный API позволяет мерчанту создать sessionId для проведения оплаты с помощью одноразового токена
Создание сессии
Создает сессию для авторизации с помощью одноразового токена. Новая сессия должна быть сгенерирована для каждой успешной авторизации с помощью одноразового токена.
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
X-Header-Idempotency-Key | string Example: 60ibwxptqpsw7czp0u4zzwjj3fhmnfozmw08 Ключ идемпотентности |
Request Body schema: application/jsonoptional
lifetimeMinutes | number <number> [ 1 .. 60 ] Default: 60 Example: "10" Срок жизни сессии в минутах. Если не указан, будет использовано значение по умолчанию |
Responses
Request samples
- Payload
{- "lifetimeMinutes": 10
}
Response samples
- 200
- 400
- 500
{- "sessionId": "49a88d24-7615-41e8-adc0-fa7ae01bbebu",
- "merchantCode": "MERCH_V1",
- "createdAt": "2023-01-15T12:00:00+00:00",
- "lifetimeMinutes": 10,
- "code": 200,
- "message": "A text message with details about processing result or with some message error",
- "status": "A text representing the status of the response"
}
Протокол, позволяющий Продавцу формировать следующие типы отчетов:
- Заказы
- Продукты
- Операторы
- Выгрузки оператора
API отчетов обеспечивает доступ Продавцу к нескольким типам отчетов через запрос GET протокола HTTP. Ответ от API приходит в формате JSON. Только для отчета по оператору предусмотрен экспорт в PDF-файл.
Формируется отчет о заказах за заданный пользователем период. Максимальный период: календарный месяц.
ОБЯЗАТЕЛЬНЫЕ ПОЛЯ ЗАПРОСА | ОПИСАНИЕ |
---|---|
merchant | Внутренний код Продавца (строка) или идентификатор Продавца (цифра) |
startDate | Стартовая дата отчетного периода (гггг-мм-дд) |
endDate | Конечная дата отчетного периода (гггг-мм-дд) |
timeStamp | Текущее UNIX-время |
signature | Уникальная подпись запроса (подробнее см. ниже) |
Запрос формируется путем присоединения значений полей к URL: https://secure.ypmn.ru/reports/orders
ПОЛЯ ОТВЕТА | ОПИСАНИЕ |
---|---|
statusCode | Код статуса. Подробное описание статусов приведено ниже (одинаковы для всех отчетов) |
statusDescription | Текстовое описание значения поля statusCode |
data | Cодержимое отчета или сообщение об ошибке |
Пример cтроки запроса:
https://secure.ypmn.ru/reports/orders?merchant=YPMNTEST&startDate=2014-08-01&endDate=2014-08-13&timeStamp=1408023282&signature=e55e56d686d96d1440aa769a86b9dd48
Пример ответа
"statusCode":"0",
"statusDescription":"Success",
"data":[
{
"Order No":"590",
"Order status":"TEST",
"Reference No":"9364477",
"External Reference No":"",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-01 11:52:22",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"2199",
"Total Price":"2199.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"2199",
"Processing fee":"0",
"Company":"",
"Client":"test test user",
"Address":" ",
"Phone":"9712388",
"Email":"kondor40@ya.ru",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"test test user",
"Delivery Address":" ",
"Delivery Phone":"9712388",
"Delivery Email":"kondor40@ya.ru",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"TEST",
"Net Profit":"2199",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"591",
"Order status":"REVERSED",
"Reference No":"9477395",
"External Reference No":"530516",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-01 12:17:35",
"Order Finish Date":"2014-08-08 23:54:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"22.33",
"Total Price":"22.33",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"22.33",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address0 address7",
"Phone":"07811510872",
"Email":"email2@email.com",
"City":"city6",
"Zip Code":"5",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"1011063",
"Registration Number":"1011063",
"Bank":"Bank2",
"Bank Account":"1011063",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address0 address7",
"Delivery Phone":"07811510872",
"Delivery Email":"email2@email.com",
"Delivery City":"city6",
"Delivery Zip Code":"5",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Canceled",
"Net Profit":"22.33",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9477395:2869525",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9608377",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-01 13:45:23",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"city2",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"city2",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9533575",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-01 14:36:30",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9567713",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-01 14:38:20",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9199354",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-01 14:51:13",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9492769",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-01 14:54:50",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"592",
"Order status":"COMPLETE",
"Reference No":"9543196",
"External Reference No":"6754194",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-01 18:20:27",
"Order Finish Date":"2014-08-08 17:51:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1",
"Total Price":"1.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1",
"Processing fee":"0",
"Company":"Company4",
"Client":"first name8 last name3",
"Address":"address8 address1",
"Phone":"0762575101",
"Email":"email6@email.com",
"City":"city1",
"Zip Code":"7",
"Country":"Spain",
"State":"",
"CNP":"",
"Fiscal Code":"63070",
"Registration Number":"63070",
"Bank":"Bank5",
"Bank Account":"63070",
"Delivery Client":"first name8 last name3",
"Delivery Address":"address8 address1",
"Delivery Phone":"0762575101",
"Delivery Email":"email6@email.com",
"Delivery City":"city1",
"Delivery Zip Code":"7",
"Delivery Country":"Spain",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9543196:2872162",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9325834",
"External Reference No":"8994688",
"Pay Method":"YooMoney",
"Order Date":"2014-08-04 14:59:43",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"6",
"Total Price":"6.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"6",
"Processing fee":"0",
"Company":"Company5",
"Client":"first name1 last name3",
"Address":"address2 address10",
"Phone":"07210310052",
"Email":"email8@email.com",
"City":"city0",
"Zip Code":"1",
"Country":"Germany",
"State":"",
"CNP":"",
"Fiscal Code":"511084",
"Registration Number":"511084",
"Bank":"Bank0",
"Bank Account":"511084",
"Delivery Client":"first name1 last name3",
"Delivery Address":"address2 address10",
"Delivery Phone":"07210310052",
"Delivery Email":"email8@email.com",
"Delivery City":"city0",
"Delivery Zip Code":"1",
"Delivery Country":"Germany",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"6",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9525357",
"External Reference No":"8994688",
"Pay Method":"YooMoney",
"Order Date":"2014-08-04 15:06:36",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"6",
"Total Price":"6.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"6",
"Processing fee":"0",
"Company":"Company5",
"Client":"TEST TEST",
"Address":"address2 address10",
"Phone":"+8(888)888-88-88",
"Email":"test@test.com",
"City":"city0",
"Zip Code":"1",
"Country":"Germany",
"State":"",
"CNP":"",
"Fiscal Code":"511084",
"Registration Number":"511084",
"Bank":"Bank0",
"Bank Account":"511084",
"Delivery Client":"TEST TEST",
"Delivery Address":"address2 address10",
"Delivery Phone":"+8(888)888-88-88",
"Delivery Email":"test@test.com",
"Delivery City":"city0",
"Delivery Zip Code":"1",
"Delivery Country":"Germany",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"6",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9490307",
"External Reference No":"",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-04 15:54:45",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"29.66",
"Total Price":"29.66",
"Total VAT":"5.34",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"35",
"Processing fee":"0",
"Company":"",
"Client":"Andreea Polizu",
"Address":" ",
"Phone":"+40744425114",
"Email":"andra_pm@yahoo.com",
"City":"",
"Zip Code":"",
"Country":"Romania",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"Andreea Polizu",
"Delivery Address":" ",
"Delivery Phone":"+40744425114",
"Delivery Email":"andra_pm@yahoo.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Romania",
"Delivery state":"",
"Authorization":"Message flow error",
"Approval status":"Unfinished",
"Net Profit":"29.66",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"demoshop"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9305114",
"External Reference No":"2746",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-05 11:21:37",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1",
"Total Price":"3.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"3",
"Processing fee":"0",
"Company":"",
"Client":"Testov Test",
"Address":" ",
"Phone":"1234567890",
"Email":"integration@ypmn.ru",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"Test Testov",
"Delivery Address":"3256 Epiphenomenal Avenue ",
"Delivery Phone":"0729581297",
"Delivery Email":"integration@ypmn.ru",
"Delivery City":"Minneapolis",
"Delivery Zip Code":"55416",
"Delivery Country":"Russia",
"Delivery state":"Minnesota",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"3",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"demoshop"
},
{
"Order No":"593",
"Order status":"COMPLETE",
"Reference No":"9499888",
"External Reference No":"",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-06 10:31:07",
"Order Finish Date":"2014-08-06 10:35:33",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.1",
"Total Price":"1.10",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.1",
"Processing fee":"0",
"Company":"",
"Client":"TEST TEST",
"Address":" ",
"Phone":"89653508589",
"Email":"kirill.zadubrovskiy@ypmn.ru",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"TEST TEST",
"Delivery Address":" ",
"Delivery Phone":"89653508589",
"Delivery Email":"kirill.zadubrovskiy@ypmn.ru",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9499888:2895115",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"593",
"Order status":"REFUND",
"Reference No":"9499888",
"External Reference No":"",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-06 10:39:02",
"Order Finish Date":"2014-08-06 10:39:03",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1",
"Total Price":"-1.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1",
"Processing fee":"0",
"Company":"",
"Client":"TEST TEST",
"Address":" ",
"Phone":"89653508589",
"Email":"kirill.zadubrovskiy@ypmn.ru",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"TEST TEST",
"Delivery Address":" ",
"Delivery Phone":"89653508589",
"Delivery Email":"kirill.zadubrovskiy@ypmn.ru",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9499888:2895115",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9482506",
"External Reference No":"",
"Pay Method":"Alfa Click",
"Order Date":"2014-08-06 13:13:49",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.1",
"Total Price":"1.10",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.1",
"Processing fee":"0",
"Company":"",
"Client":"TEST TEST",
"Address":" ",
"Phone":"8 888 888 88 88",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"TEST TEST",
"Delivery Address":" ",
"Delivery Phone":"8 888 888 88 88",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9559400",
"External Reference No":"8117894",
"Pay Method":"Alfa Click",
"Order Date":"2014-08-06 13:15:03",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.1",
"Total Price":"1.10",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.1",
"Processing fee":"0",
"Company":"Company1",
"Client":"first name0 last name3",
"Address":"address0 address6",
"Phone":"0726910641",
"Email":"email8@email.com",
"City":"city4",
"Zip Code":"7",
"Country":"Italy",
"State":"",
"CNP":"",
"Fiscal Code":"10101110",
"Registration Number":"10101110",
"Bank":"Bank11",
"Bank Account":"10101110",
"Delivery Client":"first name0 last name3",
"Delivery Address":"address0 address6",
"Delivery Phone":"0726910641",
"Delivery Email":"email8@email.com",
"Delivery City":"city4",
"Delivery Zip Code":"7",
"Delivery Country":"Italy",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9277236",
"External Reference No":"8117894",
"Pay Method":"Alfa Click",
"Order Date":"2014-08-06 13:17:17",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.1",
"Total Price":"1.10",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.1",
"Processing fee":"0",
"Company":"Company1",
"Client":"first name0 last name3",
"Address":"address0 address6",
"Phone":"0726910641",
"Email":"email8@email.com",
"City":"city4",
"Zip Code":"7",
"Country":"Italy",
"State":"",
"CNP":"",
"Fiscal Code":"10101110",
"Registration Number":"10101110",
"Bank":"Bank11",
"Bank Account":"10101110",
"Delivery Client":"first name0 last name3",
"Delivery Address":"address0 address6",
"Delivery Phone":"0726910641",
"Delivery Email":"email8@email.com",
"Delivery City":"city4",
"Delivery Zip Code":"7",
"Delivery Country":"Italy",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9364268",
"External Reference No":"9218",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-06 16:25:48",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1",
"Total Price":"3.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"3",
"Processing fee":"0",
"Company":"",
"Client":"Testov Test",
"Address":" ",
"Phone":"1234567890",
"Email":"integration@ypmn.ru",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"Test Testov",
"Delivery Address":"3256 Epiphenomenal Avenue ",
"Delivery Phone":"0729581297",
"Delivery Email":"integration@ypmn.ru",
"Delivery City":"Minneapolis",
"Delivery Zip Code":"55416",
"Delivery Country":"Russia",
"Delivery state":"Minnesota",
"Authorization":"Message flow error",
"Approval status":"Unfinished",
"Net Profit":"3",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"demoshop"
},
{
"Order No":"595",
"Order status":"COMPLETE",
"Reference No":"9167041",
"External Reference No":"1285383",
"Pay Method":"Alfa Click",
"Order Date":"2014-08-06 17:48:11",
"Order Finish Date":"2014-08-06 18:31:32",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.2",
"Total Price":"1.20",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.2",
"Processing fee":"0.024",
"Company":"Company10",
"Client":"first name8 last name9",
"Address":"address1 address6",
"Phone":"07101084940",
"Email":"email10@email.com",
"City":"city9",
"Zip Code":"5",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"104399",
"Registration Number":"104399",
"Bank":"Bank9",
"Bank Account":"104399",
"Delivery Client":"first name8 last name9",
"Delivery Address":"address1 address6",
"Delivery Phone":"07101084940",
"Delivery Email":"email10@email.com",
"Delivery City":"city9",
"Delivery Zip Code":"5",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.176",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9167041",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"594",
"Order status":"COMPLETE",
"Reference No":"9402123",
"External Reference No":"7021319",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-06 18:09:16",
"Order Finish Date":"2014-08-06 18:13:36",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.3",
"Total Price":"1.30",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.3",
"Processing fee":"0",
"Company":"Company8",
"Client":"first name3 last name5",
"Address":"address3 address7",
"Phone":"07102106687",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city8",
"Zip Code":"0",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"410995",
"Registration Number":"410995",
"Bank":"Bank5",
"Bank Account":"410995",
"Delivery Client":"first name3 last name5",
"Delivery Address":"address3 address7",
"Delivery Phone":"07102106687",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city8",
"Delivery Zip Code":"0",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.3",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9402123:2897676",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"594",
"Order status":"REFUND",
"Reference No":"9402123",
"External Reference No":"7021319",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-06 18:18:02",
"Order Finish Date":"2014-08-06 18:18:03",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.1",
"Total Price":"-1.10",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.1",
"Processing fee":"0",
"Company":"Company8",
"Client":"first name3 last name5",
"Address":"address3 address7",
"Phone":"07102106687",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city8",
"Zip Code":"0",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"410995",
"Registration Number":"410995",
"Bank":"Bank5",
"Bank Account":"410995",
"Delivery Client":"first name3 last name5",
"Delivery Address":"address3 address7",
"Delivery Phone":"07102106687",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city8",
"Delivery Zip Code":"0",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9402123:2897676",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9348114",
"External Reference No":"706991",
"Pay Method":"Rapida",
"Order Date":"2014-08-07 09:38:08",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"8",
"Total Price":"8.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"8",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name10 last name3",
"Address":"address7 address5",
"Phone":"076866764",
"Email":"email2@email.com",
"City":"city4",
"Zip Code":"0",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"65416",
"Registration Number":"65416",
"Bank":"Bank4",
"Bank Account":"65416",
"Delivery Client":"first name10 last name3",
"Delivery Address":"address7 address5",
"Delivery Phone":"076866764",
"Delivery Email":"email2@email.com",
"Delivery City":"city4",
"Delivery Zip Code":"0",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"8",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"49",
"Order status":"AUTHRECEIVED",
"Reference No":"9219692",
"External Reference No":"4114870",
"Pay Method":"Rapida",
"Order Date":"2014-08-07 10:43:44",
"Order Finish Date":"2014-08-07 14:20:37",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"10",
"Total Price":"10.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"10",
"Processing fee":"0",
"Company":"Company0",
"Client":"\u0421\u0435\u0440\u0433\u0435\u0439 \u0411\u0443\u0434\u044f\u043a\u043e\u0432",
"Address":"address11 address3",
"Phone":"9262468839",
"Email":"serega@budyakov.com",
"City":"city5",
"Zip Code":"5",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"82896",
"Registration Number":"82896",
"Bank":"Bank5",
"Bank Account":"82896",
"Delivery Client":"\u0421\u0435\u0440\u0433\u0435\u0439 \u0411\u0443\u0434\u044f\u043a\u043e\u0432",
"Delivery Address":"address11 address3",
"Delivery Phone":"9262468839",
"Delivery Email":"serega@budyakov.com",
"Delivery City":"city5",
"Delivery Zip Code":"5",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"In progress",
"Net Profit":"10",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"1691897618",
"Merchant Code":"demoshop"
},
{
"Order No":"596",
"Order status":"COMPLETE",
"Reference No":"9546516",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:22:33",
"Order Finish Date":"2014-08-08 17:50:57",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.4",
"Total Price":"1.40",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.4",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"email11@email.com",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"email11@email.com",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.4",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9546516:2901618",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"597",
"Order status":"COMPLETE",
"Reference No":"9438657",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:23:52",
"Order Finish Date":"2014-08-07 13:27:02",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.4",
"Total Price":"1.40",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.4",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.4",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9438657:2901623",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"597",
"Order status":"REFUND",
"Reference No":"9438657",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:30:01",
"Order Finish Date":"2014-08-07 13:30:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.4",
"Total Price":"-1.40",
"Total VAT":"0.00",
"Unit Discount":"-0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.4",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.4",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9438657:2901623",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"598",
"Order status":"COMPLETE",
"Reference No":"9598387",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:34:14",
"Order Finish Date":"2014-08-07 13:37:44",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.5",
"Total Price":"1.50",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.5",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1.5",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9598387:2901683",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"598",
"Order status":"REFUND",
"Reference No":"9598387",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:48:02",
"Order Finish Date":"2014-08-07 13:48:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.3",
"Total Price":"-1.30",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.3",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"katerina.valeeva@ypmn.ru",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"katerina.valeeva@ypmn.ru",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.3",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9598387:2901683",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9442673",
"External Reference No":"6654626",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-07 13:51:47",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"11",
"Total Price":"11.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"11",
"Processing fee":"0",
"Company":"Company10",
"Client":"first name3 last name0",
"Address":"address1 address4",
"Phone":"071863666",
"Email":"email11@email.com",
"City":"city5",
"Zip Code":"1",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"45536",
"Registration Number":"45536",
"Bank":"Bank9",
"Bank Account":"45536",
"Delivery Client":"first name3 last name0",
"Delivery Address":"address1 address4",
"Delivery Phone":"071863666",
"Delivery Email":"email11@email.com",
"Delivery City":"city5",
"Delivery Zip Code":"1",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"Authentication failed",
"Approval status":"Unfinished",
"Net Profit":"11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"demoshop"
},
{
"Order No":"592",
"Order status":"REFUND",
"Reference No":"9543196",
"External Reference No":"6754194",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-08 17:54:01",
"Order Finish Date":"2014-08-08 17:54:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1",
"Total Price":"-1.00",
"Total VAT":"0.00",
"Unit Discount":"-0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1",
"Processing fee":"0",
"Company":"Company4",
"Client":"first name8 last name3",
"Address":"address8 address1",
"Phone":"0762575101",
"Email":"email6@email.com",
"City":"city1",
"Zip Code":"7",
"Country":"Spain",
"State":"",
"CNP":"",
"Fiscal Code":"63070",
"Registration Number":"63070",
"Bank":"Bank5",
"Bank Account":"63070",
"Delivery Client":"first name8 last name3",
"Delivery Address":"address8 address1",
"Delivery Phone":"0762575101",
"Delivery Email":"email6@email.com",
"Delivery City":"city1",
"Delivery Zip Code":"7",
"Delivery Country":"Spain",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9543196:2872162",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"596",
"Order status":"REFUND",
"Reference No":"9546516",
"External Reference No":"4992847",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-08 17:54:05",
"Order Finish Date":"2014-08-08 17:54:08",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.4",
"Total Price":"-1.40",
"Total VAT":"0.00",
"Unit Discount":"-0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.4",
"Processing fee":"0",
"Company":"Company2",
"Client":"first name6 last name1",
"Address":"address9 address8",
"Phone":"07154411910",
"Email":"email11@email.com",
"City":"city4",
"Zip Code":"6",
"Country":"United Kingdom",
"State":"",
"CNP":"",
"Fiscal Code":"265611",
"Registration Number":"265611",
"Bank":"Bank8",
"Bank Account":"265611",
"Delivery Client":"first name6 last name1",
"Delivery Address":"address9 address8",
"Delivery Phone":"07154411910",
"Delivery Email":"email11@email.com",
"Delivery City":"city4",
"Delivery Zip Code":"6",
"Delivery Country":"United Kingdom",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.4",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9546516:2901618",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"588",
"Order status":"REFUND",
"Reference No":"9595811",
"External Reference No":"1158496",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-11 11:33:03",
"Order Finish Date":"2014-08-11 11:33:19",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.11",
"Total Price":"-1.11",
"Total VAT":"-0.00",
"Unit Discount":"-0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"-0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.11",
"Processing fee":"0",
"Company":"Company6",
"Client":"first name11 last name11",
"Address":"address0 address2",
"Phone":"079681761",
"Email":"email5@email.com",
"City":"city0",
"Zip Code":"0",
"Country":"France",
"State":"",
"CNP":"",
"Fiscal Code":"08232",
"Registration Number":"08232",
"Bank":"Bank5",
"Bank Account":"08232",
"Delivery Client":"first name11 last name11",
"Delivery Address":"address0 address2",
"Delivery Phone":"079681761",
"Delivery Email":"email5@email.com",
"Delivery City":"city0",
"Delivery Zip Code":"0",
"Delivery Country":"France",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9595811:2863290",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"0",
"Order status":"PENDING",
"Reference No":"9169520",
"External Reference No":"12345",
"Pay Method":"Qiwi",
"Order Date":"2014-08-11 12:22:46",
"Order Finish Date":"000-00-00 00:00:00",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1.11",
"Total Price":"1.11",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1.11",
"Processing fee":"0",
"Company":"",
"Client":"name last name",
"Address":" ",
"Phone":"9629076217",
"Email":"test@test.com",
"City":"",
"Zip Code":"",
"Country":"Russia",
"State":"",
"CNP":"",
"Fiscal Code":"",
"Registration Number":"",
"Bank":"",
"Bank Account":"",
"Delivery Client":"name last name",
"Delivery Address":" ",
"Delivery Phone":"9629076217",
"Delivery Email":"test@test.com",
"Delivery City":"",
"Delivery Zip Code":"",
"Delivery Country":"Russia",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Unfinished",
"Net Profit":"1.11",
"Delivered codes":"",
"Installments":"",
"Token":"",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"589",
"Order status":"REFUND",
"Reference No":"9466259",
"External Reference No":"5132757",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-12 12:56:56",
"Order Finish Date":"2014-08-12 12:57:04",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"-1.12",
"Total Price":"-1.12",
"Total VAT":"-0.00",
"Unit Discount":"-0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"-0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"-1.12",
"Processing fee":"0",
"Company":"Company1",
"Client":"first name9 last name6",
"Address":"address8 address0",
"Phone":"0715557113",
"Email":"email5@email.com",
"City":"city8",
"Zip Code":"4",
"Country":"Italy",
"State":"",
"CNP":"",
"Fiscal Code":"59996",
"Registration Number":"59996",
"Bank":"Bank1",
"Bank Account":"59996",
"Delivery Client":"first name9 last name6",
"Delivery Address":"address8 address0",
"Delivery Phone":"0715557113",
"Delivery Email":"email5@email.com",
"Delivery City":"city8",
"Delivery Zip Code":"4",
"Delivery Country":"Italy",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Refunded",
"Net Profit":"-1.12",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"9466259:2864307",
"Merchant Code":"YPMNTEST"
},
{
"Order No":"599",
"Order status":"COMPLETE",
"Reference No":"9394307",
"External Reference No":"9432509",
"Pay Method":"Visa\/MasterCard\/Eurocard",
"Order Date":"2014-08-13 09:18:12",
"Order Finish Date":"2014-08-13 09:19:06",
"Currency":"RUB",
"Quantity":"1",
"Unit price (without VAT)":"1",
"Total Price":"1.00",
"Total VAT":"0.00",
"Unit Discount":"0.00",
"Promotion":"",
"Promotion Coupon Code":"",
"General Discount":"0",
"PAYU Discount":"0",
"Shipping":"0",
"General Total":"1",
"Processing fee":"0",
"Company":"Company4",
"Client":"first name9 last name2",
"Address":"address11 address3",
"Phone":"0701047510",
"Email":"ruxandra.laceanu@ypmn.ru",
"City":"city6",
"Zip Code":"0",
"Country":"Spain",
"State":"",
"CNP":"",
"Fiscal Code":"92202",
"Registration Number":"92202",
"Bank":"Bank1",
"Bank Account":"92202",
"Delivery Client":"first name9 last name2",
"Delivery Address":"address11 address3",
"Delivery Phone":"0701047510",
"Delivery Email":"ruxandra.laceanu@ypmn.ru",
"Delivery City":"city6",
"Delivery Zip Code":"0",
"Delivery Country":"Spain",
"Delivery state":"",
"Authorization":"No Response",
"Approval status":"Finished",
"Net Profit":"1",
"Delivered codes":"",
"Installments":"",
"Token":"",
"RRN":"MO\/TO",
"Merchant Code":"YPMNTEST"
}
]
}
Чтобы посмотреть пример с разбиением на строки, воспользуйтесь сервисом http://json.parser.online.fr/. Скопируйте пример в левую половину экрана.
ПОЛЕ | ЗНАЧЕНИЕ |
---|---|
Order No | Порядковый номер транзакции на данной учётной записи. Присваивается YourPayments |
Order Status | Статус транзакции (тестовый платёж, успешное списание и тд). Список статусов совпадает с со списком в Панели управления. Также см. описание системных статусов здесь. Обратите внимание, что в отчете отображается и статус REFUND и PARTIAL REFUND при частичном возврате (подробнее о возврате см. здесь). |
Reference No | Уникальный внутренний номер. Присваивается сервером YourPayments автоматически. Отличается тем, что всегда уникальный для всей нашей системы в целом, в отличии от Order No (может быть одинаковым на разных учётных записях) и External Reference No (так же может быть одинаковым, хотя это и не желательно) |
External Reference No | Номер, который Продавец передает в запросе. Может содержать буквы и цифры (другие номера содержат только цифры) |
Pay Method | "Метод оплаты. |
Например Visa/MasterCard/Eurocard – платеж с помощью банковской карты" | |
Order Date | Дата создания транзакции |
Order Finish Date | Дата успешного списания (обычно) |
Quantity | Количество продуктов в заказе |
Unit price (without VAT) | Цена единицы товара без НДС |
Total Price | Итоговая цена продуктов в заказе |
Total VAT | Итоговый размер НДС |
Unit Discount | Скидка на единицу товара |
Promotion | Акция со скидкой (устаревшее поле) |
Promotion Coupon Code | Код купона на скидку (устаревшее поле) |
General Discount | Общая скидка |
PAYU Discount | Скидка YourPayments (устаревшее поле) |
Shipping | Стоимость доставки |
General Total | Итоговая стоимость по заказу |
Processing fee | Сбор YourPayments. Если комиссия за операцию не предусмотрена (например, возврат), то поле имеет нулевое значение. |
State | Регион, штат плательщика |
CNP | Поле не используется для российской платформы |
Delivery state | регион/штат доставки |
Authorization | Сообщение от платежного шлюза |
Approval status | Статус проверки на мошенничество |
Net profit | Прибыль Продавца за вычетом комиссии |
Delivered codes | Не используется для российской платформы |
Installments | Не используется для российской платформы |
Merchant Code | код, который YourPayments присваивает Продавцу при создании учётной записи (см. также здесь). |
Формируется отчет о продуктах за определенный период. Максимальный период: календарный месяц.
ОБЯЗАТЕЛЬНЫЕ ПОЛЯ ЗАПРОСА | ОПИСАНИЕ |
---|---|
merchant | Внутренний код Продавца (строка) или внутренний идентификатор Продавца (число) |
startDate | Начальная дата отчетного периода (гггг-мм-дд) |
endDate | Конечная дата отчетного периода (гггг-мм-дд) |
timeStamp | Текущее UNIX-время |
signature | Уникальная подпись запроса (подробнее см. ниже) |
Запрос формируется путем присоединения значений полей к URL (https://secure.ypmn.ru/reports/products).
ПОЛЯ ОТВЕТА | ОПИСАНИЕ |
---|---|
statusCode | Код статуса операции. Значения кодов см. ниже |
statusDescription | Описание кода |
data | Cодержимое отчета или сообщение об ошибке |
Пример запроса:
https://secure.ypmn.ru/reports/products?merchant=YPMNTEST&startDate=2014-08-01&endDate=2014-08-13&timeStamp=1408103538&signature=7c64a401aac9a781081b84f4bd301d37
Пример ответа
{"statusCode":"0","statusDescription":"Success","data":[{"Product ID":"4830640","Product Code":"74","Product":"\u0428\u0442\u0430\u043d\u044b \u0426\u0432\u0435\u0442\u043e\u0447\u043d\u0430\u044f \u041f\u043e\u043b\u044f\u043d\u0430","Extra info":"","Order No":"590","Order status":"TEST","Reference No":"9364477","External Reference No":"","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-01 11:52:22","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"2199","Total Price":"2199.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"2199","Processing fee":"0","Company":"","Client":"test test user","Address":" ","Phone":"9712388","Email":"kondor40@ya.ru","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"test test user","Delivery Address":" ","Delivery Phone":"9712388","Delivery Email":"kondor40@ya.ru","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"TEST","Net Profit":"2199","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4835181","Product Code":"10","Product":"prod11","Extra info":"3","Order No":"591","Order status":"REVERSED","Reference No":"9477395","External Reference No":"530516","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-01 12:17:35","Order Finish Date":"2014-08-08 23:54:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"22.33","Total Price":"22.33","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"22.33","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address0 address7","Phone":"07811510872","Email":"email2@email.com","City":"city6","Zip Code":"5","Country":"Russia","State":"","CNP":"","Fiscal Code":"1011063","Registration Number":"1011063","Bank":"Bank2","Bank Account":"1011063","Delivery Client":"first name6 last name1","Delivery Address":"address0 address7","Delivery Phone":"07811510872","Delivery Email":"email2@email.com","Delivery City":"city6","Delivery Zip Code":"5","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Canceled","Net Profit":"22.33","Delivered codes":"","Installments":"","Token":"","RRN":"9477395:2869525","Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9608377","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-01 13:45:23","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"city2","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"city2","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9533575","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-01 14:36:30","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9567713","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-01 14:38:20","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9199354","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-01 14:51:13","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9492769","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-01 14:54:50","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4839192","Product Code":"1","Product":"prod10","Extra info":"2","Order No":"592","Order status":"COMPLETE","Reference No":"9543196","External Reference No":"6754194","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-01 18:20:27","Order Finish Date":"2014-08-08 17:51:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1","Total Price":"1.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1","Processing fee":"0","Company":"Company4","Client":"first name8 last name3","Address":"address8 address1","Phone":"0762575101","Email":"email6@email.com","City":"city1","Zip Code":"7","Country":"Spain","State":"","CNP":"","Fiscal Code":"63070","Registration Number":"63070","Bank":"Bank5","Bank Account":"63070","Delivery Client":"first name8 last name3","Delivery Address":"address8 address1","Delivery Phone":"0762575101","Delivery Email":"email6@email.com","Delivery City":"city1","Delivery Zip Code":"7","Delivery Country":"Spain","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1","Delivered codes":"","Installments":"","Token":"","RRN":"9543196:2872162","Merchant Code":"YPMNTEST"},{"Product ID":"4859853","Product Code":"4","Product":"prod7","Extra info":"7","Order No":"0","Order status":"PENDING","Reference No":"9325834","External Reference No":"8994688","Pay Method":"YooMoney","Order Date":"2014-08-04 14:59:43","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"6","Total Price":"6.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"6","Processing fee":"0","Company":"Company5","Client":"first name1 last name3","Address":"address2 address10","Phone":"07210310052","Email":"email8@email.com","City":"city0","Zip Code":"1","Country":"Germany","State":"","CNP":"","Fiscal Code":"511084","Registration Number":"511084","Bank":"Bank0","Bank Account":"511084","Delivery Client":"first name1 last name3","Delivery Address":"address2 address10","Delivery Phone":"07210310052","Delivery Email":"email8@email.com","Delivery City":"city0","Delivery Zip Code":"1","Delivery Country":"Germany","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"6","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4859914","Product Code":"4","Product":"prod7","Extra info":"7","Order No":"0","Order status":"PENDING","Reference No":"9525357","External Reference No":"8994688","Pay Method":"YooMoney","Order Date":"2014-08-04 15:06:36","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"6","Total Price":"6.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"6","Processing fee":"0","Company":"Company5","Client":"TEST TEST","Address":"address2 address10","Phone":"+8(888)888-88-88","Email":"test@test.com","City":"city0","Zip Code":"1","Country":"Germany","State":"","CNP":"","Fiscal Code":"511084","Registration Number":"511084","Bank":"Bank0","Bank Account":"511084","Delivery Client":"TEST TEST","Delivery Address":"address2 address10","Delivery Phone":"+8(888)888-88-88","Delivery Email":"test@test.com","Delivery City":"city0","Delivery Zip Code":"1","Delivery Country":"Germany","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"6","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4834868","Product Code":"CDPLY1","Product":"CD Player 1","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9490307","External Reference No":"","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-04 15:54:45","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"29.66","Total Price":"29.66","Total VAT":"5.34","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"35","Processing fee":"0","Company":"","Client":"Andreea Polizu","Address":" ","Phone":"+40744425114","Email":"andra_pm@yahoo.com","City":"","Zip Code":"","Country":"Romania","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"Andreea Polizu","Delivery Address":" ","Delivery Phone":"+40744425114","Delivery Email":"andra_pm@yahoo.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Romania","Delivery state":"","Authorization":"Message flow error","Approval status":"Unfinished","Net Profit":"29.66","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"demoshop"},{"Product ID":"4865770","Product Code":"123","Product":"\u0422\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Extra info":"\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043a \u0422\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Order No":"0","Order status":"PENDING","Reference No":"9305114","External Reference No":"2746","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-05 11:21:37","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1","Total Price":"1.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"3","Processing fee":"0","Company":"","Client":"Testov Test","Address":" ","Phone":"1234567890","Email":"integration@ypmn.ru","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"Test Testov","Delivery Address":"3256 Epiphenomenal Avenue ","Delivery Phone":"0729581297","Delivery Email":"integration@ypmn.ru","Delivery City":"Minneapolis","Delivery Zip Code":"55416","Delivery Country":"Russia","Delivery state":"Minnesota","Authorization":"No Response","Approval status":"Unfinished","Net Profit":3,"Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"demoshop"},{"Product ID":"4865771","Product Code":"321","Product":"\u0412\u0442\u043e\u0440\u043e\u0439 \u0442\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Extra info":"\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043a \u0412\u0442\u043e\u0440\u043e\u0439 \u0442\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Order No":"0","Order status":"PENDING","Reference No":"9305114","External Reference No":"2746","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-05 11:21:37","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"2","Total Price":"2.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"","PAYU Discount":"","Shipping":"","General Total":"","Processing fee":"","Company":"","Client":"","Address":"","Phone":"","Email":"","City":"","Zip Code":"","Country":"","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"","Delivery Address":"","Delivery Phone":"","Delivery Email":"","Delivery City":"","Delivery Zip Code":"","Delivery Country":"","Delivery state":"","Authorization":"No Response","Approval status":"","Net Profit":0,"Delivered codes":"","Installments":"","Token":"","RRN":"","Merchant Code":""},{"Product ID":"3784940","Product Code":"","Product":"test_1.1_rub","Extra info":"","Order No":"593","Order status":"COMPLETE","Reference No":"9499888","External Reference No":"","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 10:31:07","Order Finish Date":"2014-08-06 10:35:33","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.1","Total Price":"1.10","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.1","Processing fee":"0","Company":"","Client":"TEST TEST","Address":" ","Phone":"89653508589","Email":"kirill.zadubrovskiy@ypmn.ru","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"TEST TEST","Delivery Address":" ","Delivery Phone":"89653508589","Delivery Email":"kirill.zadubrovskiy@ypmn.ru","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.1","Delivered codes":"","Installments":"","Token":"","RRN":"9499888:2895115","Merchant Code":"YPMNTEST"},{"Product ID":"0","Product Code":"PARTIAL REFUND","Product":"PARTIAL REFUND","Extra info":"","Order No":"593","Order status":"REFUND","Reference No":"9499888","External Reference No":"","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 10:39:02","Order Finish Date":"2014-08-06 10:39:03","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1","Total Price":"-1.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1","Processing fee":"0","Company":"","Client":"TEST TEST","Address":" ","Phone":"89653508589","Email":"kirill.zadubrovskiy@ypmn.ru","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"TEST TEST","Delivery Address":" ","Delivery Phone":"89653508589","Delivery Email":"kirill.zadubrovskiy@ypmn.ru","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1","Delivered codes":"","Installments":"","Token":"","RRN":"9499888:2895115","Merchant Code":"YPMNTEST"},{"Product ID":"3784940","Product Code":"","Product":"test_1.1_rub","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9482506","External Reference No":"","Pay Method":"Alfa Click","Order Date":"2014-08-06 13:13:49","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.1","Total Price":"1.10","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.1","Processing fee":"0","Company":"","Client":"TEST TEST","Address":" ","Phone":"8 888 888 88 88","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"TEST TEST","Delivery Address":" ","Delivery Phone":"8 888 888 88 88","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.1","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4874178","Product Code":"1","Product":"prod9","Extra info":"5","Order No":"0","Order status":"PENDING","Reference No":"9559400","External Reference No":"8117894","Pay Method":"Alfa Click","Order Date":"2014-08-06 13:15:03","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.1","Total Price":"1.10","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.1","Processing fee":"0","Company":"Company1","Client":"first name0 last name3","Address":"address0 address6","Phone":"0726910641","Email":"email8@email.com","City":"city4","Zip Code":"7","Country":"Italy","State":"","CNP":"","Fiscal Code":"10101110","Registration Number":"10101110","Bank":"Bank11","Bank Account":"10101110","Delivery Client":"first name0 last name3","Delivery Address":"address0 address6","Delivery Phone":"0726910641","Delivery Email":"email8@email.com","Delivery City":"city4","Delivery Zip Code":"7","Delivery Country":"Italy","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.1","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4874204","Product Code":"1","Product":"prod9","Extra info":"5","Order No":"0","Order status":"PENDING","Reference No":"9277236","External Reference No":"8117894","Pay Method":"Alfa Click","Order Date":"2014-08-06 13:17:17","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.1","Total Price":"1.10","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.1","Processing fee":"0","Company":"Company1","Client":"first name0 last name3","Address":"address0 address6","Phone":"0726910641","Email":"email8@email.com","City":"city4","Zip Code":"7","Country":"Italy","State":"","CNP":"","Fiscal Code":"10101110","Registration Number":"10101110","Bank":"Bank11","Bank Account":"10101110","Delivery Client":"first name0 last name3","Delivery Address":"address0 address6","Delivery Phone":"0726910641","Delivery Email":"email8@email.com","Delivery City":"city4","Delivery Zip Code":"7","Delivery Country":"Italy","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.1","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4875858","Product Code":"123","Product":"\u0422\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Extra info":"\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043a \u0422\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Order No":"0","Order status":"PENDING","Reference No":"9364268","External Reference No":"9218","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 16:25:48","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1","Total Price":"1.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"3","Processing fee":"0","Company":"","Client":"Testov Test","Address":" ","Phone":"1234567890","Email":"integration@ypmn.ru","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"Test Testov","Delivery Address":"3256 Epiphenomenal Avenue ","Delivery Phone":"0729581297","Delivery Email":"integration@ypmn.ru","Delivery City":"Minneapolis","Delivery Zip Code":"55416","Delivery Country":"Russia","Delivery state":"Minnesota","Authorization":"Message flow error","Approval status":"Unfinished","Net Profit":3,"Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"demoshop"},{"Product ID":"4875859","Product Code":"321","Product":"\u0412\u0442\u043e\u0440\u043e\u0439 \u0442\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Extra info":"\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043a \u0412\u0442\u043e\u0440\u043e\u0439 \u0442\u0435\u0441\u0442\u043e\u0432\u044b\u0439 \u0442\u043e\u0432\u0430\u0440","Order No":"0","Order status":"PENDING","Reference No":"9364268","External Reference No":"9218","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 16:25:48","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"2","Total Price":"2.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"","PAYU Discount":"","Shipping":"","General Total":"","Processing fee":"","Company":"","Client":"","Address":"","Phone":"","Email":"","City":"","Zip Code":"","Country":"","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"","Delivery Address":"","Delivery Phone":"","Delivery Email":"","Delivery City":"","Delivery Zip Code":"","Delivery Country":"","Delivery state":"","Authorization":"Message flow error","Approval status":"","Net Profit":0,"Delivered codes":"","Installments":"","Token":"","RRN":"","Merchant Code":""},{"Product ID":"4876534","Product Code":"5","Product":"prod2","Extra info":"9","Order No":"595","Order status":"COMPLETE","Reference No":"9167041","External Reference No":"1285383","Pay Method":"Alfa Click","Order Date":"2014-08-06 17:48:11","Order Finish Date":"2014-08-06 18:31:32","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.2","Total Price":"1.20","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.2","Processing fee":"0.024","Company":"Company10","Client":"first name8 last name9","Address":"address1 address6","Phone":"07101084940","Email":"email10@email.com","City":"city9","Zip Code":"5","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"104399","Registration Number":"104399","Bank":"Bank9","Bank Account":"104399","Delivery Client":"first name8 last name9","Delivery Address":"address1 address6","Delivery Phone":"07101084940","Delivery Email":"email10@email.com","Delivery City":"city9","Delivery Zip Code":"5","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.176","Delivered codes":"","Installments":"","Token":"","RRN":"9167041","Merchant Code":"YPMNTEST"},{"Product ID":"4876715","Product Code":"11","Product":"prod6","Extra info":"3","Order No":"594","Order status":"COMPLETE","Reference No":"9402123","External Reference No":"7021319","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 18:09:16","Order Finish Date":"2014-08-06 18:13:36","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.3","Total Price":"1.30","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.3","Processing fee":"0","Company":"Company8","Client":"first name3 last name5","Address":"address3 address7","Phone":"07102106687","Email":"katerina.valeeva@ypmn.ru","City":"city8","Zip Code":"0","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"410995","Registration Number":"410995","Bank":"Bank5","Bank Account":"410995","Delivery Client":"first name3 last name5","Delivery Address":"address3 address7","Delivery Phone":"07102106687","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city8","Delivery Zip Code":"0","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.3","Delivered codes":"","Installments":"","Token":"","RRN":"9402123:2897676","Merchant Code":"YPMNTEST"},{"Product ID":"0","Product Code":"PARTIAL REFUND","Product":"PARTIAL REFUND","Extra info":"","Order No":"594","Order status":"REFUND","Reference No":"9402123","External Reference No":"7021319","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-06 18:18:02","Order Finish Date":"2014-08-06 18:18:03","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.1","Total Price":"-1.10","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1.1","Processing fee":"0","Company":"Company8","Client":"first name3 last name5","Address":"address3 address7","Phone":"07102106687","Email":"katerina.valeeva@ypmn.ru","City":"city8","Zip Code":"0","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"410995","Registration Number":"410995","Bank":"Bank5","Bank Account":"410995","Delivery Client":"first name3 last name5","Delivery Address":"address3 address7","Delivery Phone":"07102106687","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city8","Delivery Zip Code":"0","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.1","Delivered codes":"","Installments":"","Token":"","RRN":"9402123:2897676","Merchant Code":"YPMNTEST"},{"Product ID":"4880438","Product Code":"8","Product":"prod5","Extra info":"2","Order No":"0","Order status":"PENDING","Reference No":"9348114","External Reference No":"706991","Pay Method":"Rapida","Order Date":"2014-08-07 09:38:08","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"8","Total Price":"8.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"8","Processing fee":"0","Company":"Company2","Client":"first name10 last name3","Address":"address7 address5","Phone":"076866764","Email":"email2@email.com","City":"city4","Zip Code":"0","Country":"Russia","State":"","CNP":"","Fiscal Code":"65416","Registration Number":"65416","Bank":"Bank4","Bank Account":"65416","Delivery Client":"first name10 last name3","Delivery Address":"address7 address5","Delivery Phone":"076866764","Delivery Email":"email2@email.com","Delivery City":"city4","Delivery Zip Code":"0","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"8","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4881002","Product Code":"3","Product":"prod11","Extra info":"11","Order No":"49","Order status":"AUTHRECEIVED","Reference No":"9219692","External Reference No":"4114870","Pay Method":"Rapida","Order Date":"2014-08-07 10:43:44","Order Finish Date":"2014-08-07 14:20:37","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"10","Total Price":"10.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"10","Processing fee":"0","Company":"Company0","Client":"\u0421\u0435\u0440\u0433\u0435\u0439 \u0411\u0443\u0434\u044f\u043a\u043e\u0432","Address":"address11 address3","Phone":"9262468839","Email":"serega@budyakov.com","City":"city5","Zip Code":"5","Country":"Russia","State":"","CNP":"","Fiscal Code":"82896","Registration Number":"82896","Bank":"Bank5","Bank Account":"82896","Delivery Client":"\u0421\u0435\u0440\u0433\u0435\u0439 \u0411\u0443\u0434\u044f\u043a\u043e\u0432","Delivery Address":"address11 address3","Delivery Phone":"9262468839","Delivery Email":"serega@budyakov.com","Delivery City":"city5","Delivery Zip Code":"5","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"In progress","Net Profit":"10","Delivered codes":"","Installments":"","Token":"","RRN":"1691897618","Merchant Code":"demoshop"},{"Product ID":"4882297","Product Code":"11","Product":"prod3","Extra info":"3","Order No":"596","Order status":"COMPLETE","Reference No":"9546516","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:22:33","Order Finish Date":"2014-08-08 17:50:57","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.4","Total Price":"1.40","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.4","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"email11@email.com","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"email11@email.com","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.4","Delivered codes":"","Installments":"","Token":"","RRN":"9546516:2901618","Merchant Code":"YPMNTEST"},{"Product ID":"4882301","Product Code":"11","Product":"prod3","Extra info":"3","Order No":"597","Order status":"COMPLETE","Reference No":"9438657","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:23:52","Order Finish Date":"2014-08-07 13:27:02","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.4","Total Price":"1.40","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.4","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"katerina.valeeva@ypmn.ru","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.4","Delivered codes":"","Installments":"","Token":"","RRN":"9438657:2901623","Merchant Code":"YPMNTEST"},{"Product ID":"4882301","Product Code":"11","Product":"prod3","Extra info":"3","Order No":"597","Order status":"REFUND","Reference No":"9438657","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:30:01","Order Finish Date":"2014-08-07 13:30:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.4","Total Price":"-1.40","Total VAT":"0.00","Unit Discount":"-0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1.4","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"katerina.valeeva@ypmn.ru","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.4","Delivered codes":"","Installments":"","Token":"","RRN":"9438657:2901623","Merchant Code":"YPMNTEST"},{"Product ID":"4882393","Product Code":"11","Product":"prod4","Extra info":"3","Order No":"598","Order status":"COMPLETE","Reference No":"9598387","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:34:14","Order Finish Date":"2014-08-07 13:37:44","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.5","Total Price":"1.50","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.5","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"katerina.valeeva@ypmn.ru","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1.5","Delivered codes":"","Installments":"","Token":"","RRN":"9598387:2901683","Merchant Code":"YPMNTEST"},{"Product ID":"0","Product Code":"PARTIAL REFUND","Product":"PARTIAL REFUND","Extra info":"","Order No":"598","Order status":"REFUND","Reference No":"9598387","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:48:02","Order Finish Date":"2014-08-07 13:48:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.3","Total Price":"-1.30","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1.3","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"katerina.valeeva@ypmn.ru","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"katerina.valeeva@ypmn.ru","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.3","Delivered codes":"","Installments":"","Token":"","RRN":"9598387:2901683","Merchant Code":"YPMNTEST"},{"Product ID":"4882572","Product Code":"5","Product":"prod9","Extra info":"2","Order No":"0","Order status":"PENDING","Reference No":"9442673","External Reference No":"6654626","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-07 13:51:47","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"11","Total Price":"11.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"11","Processing fee":"0","Company":"Company10","Client":"first name3 last name0","Address":"address1 address4","Phone":"071863666","Email":"email11@email.com","City":"city5","Zip Code":"1","Country":"Russia","State":"","CNP":"","Fiscal Code":"45536","Registration Number":"45536","Bank":"Bank9","Bank Account":"45536","Delivery Client":"first name3 last name0","Delivery Address":"address1 address4","Delivery Phone":"071863666","Delivery Email":"email11@email.com","Delivery City":"city5","Delivery Zip Code":"1","Delivery Country":"Russia","Delivery state":"","Authorization":"Authentication failed","Approval status":"Unfinished","Net Profit":"11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"demoshop"},{"Product ID":"4839192","Product Code":"1","Product":"prod10","Extra info":"2","Order No":"592","Order status":"REFUND","Reference No":"9543196","External Reference No":"6754194","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-08 17:54:01","Order Finish Date":"2014-08-08 17:54:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1","Total Price":"-1.00","Total VAT":"0.00","Unit Discount":"-0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1","Processing fee":"0","Company":"Company4","Client":"first name8 last name3","Address":"address8 address1","Phone":"0762575101","Email":"email6@email.com","City":"city1","Zip Code":"7","Country":"Spain","State":"","CNP":"","Fiscal Code":"63070","Registration Number":"63070","Bank":"Bank5","Bank Account":"63070","Delivery Client":"first name8 last name3","Delivery Address":"address8 address1","Delivery Phone":"0762575101","Delivery Email":"email6@email.com","Delivery City":"city1","Delivery Zip Code":"7","Delivery Country":"Spain","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1","Delivered codes":"","Installments":"","Token":"","RRN":"9543196:2872162","Merchant Code":"YPMNTEST"},{"Product ID":"4882297","Product Code":"11","Product":"prod3","Extra info":"3","Order No":"596","Order status":"REFUND","Reference No":"9546516","External Reference No":"4992847","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-08 17:54:05","Order Finish Date":"2014-08-08 17:54:08","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.4","Total Price":"-1.40","Total VAT":"0.00","Unit Discount":"-0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"-1.4","Processing fee":"0","Company":"Company2","Client":"first name6 last name1","Address":"address9 address8","Phone":"07154411910","Email":"email11@email.com","City":"city4","Zip Code":"6","Country":"United Kingdom","State":"","CNP":"","Fiscal Code":"265611","Registration Number":"265611","Bank":"Bank8","Bank Account":"265611","Delivery Client":"first name6 last name1","Delivery Address":"address9 address8","Delivery Phone":"07154411910","Delivery Email":"email11@email.com","Delivery City":"city4","Delivery Zip Code":"6","Delivery Country":"United Kingdom","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.4","Delivered codes":"","Installments":"","Token":"","RRN":"9546516:2901618","Merchant Code":"YPMNTEST"},{"Product ID":"4825390","Product Code":"7","Product":"prod10","Extra info":"7","Order No":"588","Order status":"REFUND","Reference No":"9595811","External Reference No":"1158496","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-11 11:33:03","Order Finish Date":"2014-08-11 11:33:19","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.11","Total Price":"-1.11","Total VAT":"-0.00","Unit Discount":"-0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"-0","PAYU Discount":"0","Shipping":"0","General Total":"-1.11","Processing fee":"0","Company":"Company6","Client":"first name11 last name11","Address":"address0 address2","Phone":"079681761","Email":"email5@email.com","City":"city0","Zip Code":"0","Country":"France","State":"","CNP":"","Fiscal Code":"08232","Registration Number":"08232","Bank":"Bank5","Bank Account":"08232","Delivery Client":"first name11 last name11","Delivery Address":"address0 address2","Delivery Phone":"079681761","Delivery Email":"email5@email.com","Delivery City":"city0","Delivery Zip Code":"0","Delivery Country":"France","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.11","Delivered codes":"","Installments":"","Token":"","RRN":"9595811:2863290","Merchant Code":"YPMNTEST"},{"Product ID":"110653","Product Code":"123","Product":"test_prod","Extra info":"","Order No":"0","Order status":"PENDING","Reference No":"9169520","External Reference No":"12345","Pay Method":"Qiwi","Order Date":"2014-08-11 12:22:46","Order Finish Date":"000-00-00 00:00:00","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1.11","Total Price":"1.11","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1.11","Processing fee":"0","Company":"","Client":"name last name","Address":" ","Phone":"9629076217","Email":"test@test.com","City":"","Zip Code":"","Country":"Russia","State":"","CNP":"","Fiscal Code":"","Registration Number":"","Bank":"","Bank Account":"","Delivery Client":"name last name","Delivery Address":" ","Delivery Phone":"9629076217","Delivery Email":"test@test.com","Delivery City":"","Delivery Zip Code":"","Delivery Country":"Russia","Delivery state":"","Authorization":"No Response","Approval status":"Unfinished","Net Profit":"1.11","Delivered codes":"","Installments":"","Token":"","RRN":null,"Merchant Code":"YPMNTEST"},{"Product ID":"4826662","Product Code":"1","Product":"prod7","Extra info":"7","Order No":"589","Order status":"REFUND","Reference No":"9466259","External Reference No":"5132757","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-12 12:56:56","Order Finish Date":"2014-08-12 12:57:04","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"-1.12","Total Price":"-1.12","Total VAT":"-0.00","Unit Discount":"-0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"-0","PAYU Discount":"0","Shipping":"0","General Total":"-1.12","Processing fee":"0","Company":"Company1","Client":"first name9 last name6","Address":"address8 address0","Phone":"0715557113","Email":"email5@email.com","City":"city8","Zip Code":"4","Country":"Italy","State":"","CNP":"","Fiscal Code":"59996","Registration Number":"59996","Bank":"Bank1","Bank Account":"59996","Delivery Client":"first name9 last name6","Delivery Address":"address8 address0","Delivery Phone":"0715557113","Delivery Email":"email5@email.com","Delivery City":"city8","Delivery Zip Code":"4","Delivery Country":"Italy","Delivery state":"","Authorization":"No Response","Approval status":"Refunded","Net Profit":"-1.12","Delivered codes":"","Installments":"","Token":"","RRN":"9466259:2864307","Merchant Code":"YPMNTEST"},{"Product ID":"4923062","Product Code":"3","Product":"prod9","Extra info":"10","Order No":"599","Order status":"COMPLETE","Reference No":"9394307","External Reference No":"9432509","Pay Method":"Visa\/MasterCard\/Eurocard","Order Date":"2014-08-13 09:18:12","Order Finish Date":"2014-08-13 09:19:06","Currency":"RUB","Quantity":"1","Unit price (without VAT)":"1","Total Price":"1.00","Total VAT":"0.00","Unit Discount":"0.00","Promotion":"","Promotion Coupon Code":"","General Discount":"0","PAYU Discount":"0","Shipping":"0","General Total":"1","Processing fee":"0","Company":"Company4","Client":"first name9 last name2","Address":"address11 address3","Phone":"0701047510","Email":"ruxandra.laceanu@ypmn.ru","City":"city6","Zip Code":"0","Country":"Spain","State":"","CNP":"","Fiscal Code":"92202","Registration Number":"92202","Bank":"Bank1","Bank Account":"92202","Delivery Client":"first name9 last name2","Delivery Address":"address11 address3","Delivery Phone":"0701047510","Delivery Email":"ruxandra.laceanu@ypmn.ru","Delivery City":"city6","Delivery Zip Code":"0","Delivery Country":"Spain","Delivery state":"","Authorization":"No Response","Approval status":"Finished","Net Profit":"1","Delivered codes":"","Installments":"","Token":"","RRN":"MO\/TO","Merchant Code":"YPMNTEST"}]}
Поля отчета практически идентичны полям отчета по транзакциям, только в начале указывается не идентификатор транзакции, а идентификатор продукта, после чего выводятся поля, описывающие этот продукт, т.е. данные разбиваются по продуктам. Затем выводятся поля с информацией о заказах, в которых этот продукт участвовал. Обратите внимание, что, как и в описанном выше отчете, несколько полей не используются в русской платформе (не заполняются).
Отчет по оператору за период.
ОБЯЗАТЕЛЬНЫЕ ПОЛЯ ЗАПРОСА | ОПИСАНИЕ |
---|---|
merchant | Внутренний код Продавца (строка) или внутренний идентификатор Продавца (целое число) |
startDate | Начальная дата отчетного периода (гггг-мм-дд) |
endDate | Конечная дата отчетного периода (гггг-мм-дд) |
timeStamp | Текущее UNIX-время |
signature | Уникальная подпись запроса (подробнее см. ниже) |
Запрос формируется путем присоединения значений полей к URL (https://secure.ypmn.ru/reports/operator).
ПОЛЯ ОТВЕТА | ОПИСАНИЕ |
---|---|
statusCode | Код статуса операции. Значения кодов см. ниже |
statusDescription | Описание кода |
data | Cодержимое отчета или сообщение об ошибке |
Пример запроса отчета:
https://secure.ypmn.ru/reports/operator?merchant=TestMerchantCode&startDate=2012-12-01&endDate=2012-12-31&timeStamp=1360590579&signature=93082a090599d9264e4da426e9688138
Пример ответа
{
"statusCode": "0",
"statusDescription": "Success",
"data": [
{
"IdOperatorReports": "316",
"DateFrom": "2012-11-01",
"DateTo": "2012-11-31",
"Autostamp": "0000-00-00 00:00:00",
"IdAccount": "10612",
"CompanyName": "Test Merchant SRL"
},
{
"IdOperatorReports": "317",
"DateFrom": "2012-12-01",
"DateTo": "2012-12-31",
"Autostamp": "0000-00-00 00:00:00",
"IdAccount": "10612",
"CompanyName": "Test Merchant SRL"
}
]
}
При отправке запроса на URL (https://secure.ypmn.ru/reports/operator/
ОБЯЗАТЕЛЬНЫЕ ПОЛЯ ЗАПРОСА | ОПИСАНИЕ |
---|---|
merchant | Внутренний код Продавца (строка) или внутренний идентификатор Продавца (целое число) |
timeStamp | Текущее UNIX-время |
signature | Уникальная подпись запроса (подробнее см. ниже) |
Пример запроса:
https://secure.ypmn.ru/reports/operator/316?merchant=TestMerchantCode&timeStamp=1360596963&signature=88f0bd36ba4f3f7033d559f5484498ae
В случае успеха запроса, система возвращает готовый файл.
В случае сбоя, система возвращает сообщение об ошибке в формате JSON. Структура сообщения приведена в таблице ниже.
ПОЛЯ ОТВЕТА | ОПИСАНИЕ |
---|---|
statusCode | Код статуса операции. Значения кодов см. ниже |
statusDescription | Описание кода |
data | Cодержимое отчета или сообщение об ошибке |
В адресной строке браузера отображается информация, указывающая на результат запроса:
- application/json означает, что получено сообщение об ошибке в формате JSON
- application/pdf означает, что сформирован файл отчета в формате PDF
ПОЛЕ STATUSCODE | ПОЛЕ STATUSDESCRIPTION | ЗНАЧЕНИЕ |
---|---|---|
0 | Success | Успешное выполнение запроса |
1 | Invalid report type | Некорректный тип отчета |
2 | Invalid merchant | Некорректный идентификатор Продавца |
3 | Invalid start date | Некорректная стартовая дата |
4 | Invalid end date | Некорректная конечная дата |
5 | Invalid time period | Некорректно задан отчетный период |
6 | Invalid timestamp | Некорректно указано UNIX-время |
7 | Invalid signature | Некорректно задана подпись |
8 | Expired request, check timestamp | Время запроса истекло, проверьте UNIX-время |
9 | Invalid report ID | Некорректный идентификатор отчета |
10 | Internal error | Внутренняя ошибка сервера |
Для обеспечения безопасности данных, каждый HTTP-запрос должен содержать уникальную подпись. Для ее формирования применяется алгоритм HMAC MD5, используется секретный ключ Продавца. Для получение отчетов через описываемый API необходимо сформировать подпись вручную и добавить ее к строке запроса (см. выше).
Для того чтобы сформировать подпись:
Составьте базовую строку из полей запроса. Для этого значения полей запроса собираются в строку, при этом перед каждым значением ставится его длина в байтах формата UTF-8.
Пример базовой строки
Для значений запроса "https://secure.ypmn.ru/reports/orders?merchant=TestMerchantCode&startDate=2012-12-01&endDate=2012-12-31&timeStamp=1360679091" базовая строка подписи имеет следующий вид (длины полей в байтах выделены голубым): 16TestMerchantCode102012-12-01102012-12-31101360679091.Выполните расчет подписи (вы можете воспользоваться автоматическими конвертерами в Интернете) из базовой строки и секретного ключа.
Пример расчета хэша
К базовой строке из примера выше прибавляем секретный ключ "SECRET_KEY". В результате формируется хэш 831e95506286b2bdf5990dce5d1cebe8.Добавьте результат (хэш) к строке запроса.
Пример готового запроса с подписью
https://secure.ypmn.ru/reports/orders?merchant=TestMerchantCode&startDate=2012-12-01&endDate=2012-12-31&timeStamp=1360679091&signature=831e95506286b2bdf5990dce5d1cebe8
Поле timeStamp (UNIX-время) необходимо для ограничения срока действия запроса 15-ю минутами.
- Сайт Продавца запрашивает у YourPayments уникальную ссылку на заказ
- Сайт Продавца отправляет ссылку покупателю (e-mail, SMS, мессенджеры)
- Покупатель переходит на платежную страницу YourPayments
- YourPayments уведомляет Сайт Продавца об успешной авторизации
ТЕРМИН | ЗНАЧЕНИЕ |
---|---|
3DS | 3d-Secure, XML-протокол, который используется как дополнительный уровень безопасности для онлайн-кредитных и дебетовых карт, двухфакторной аутентификации пользователя. Компания Visa разработала его с целью улучшения безопасности интернет-платежей и предложила клиентам услугу Verified by Visa (VbV). Услуги, основанные на данном протоколе, также были приняты MasterCard под названием MasterCard SecureCode (MCC) и JCB International как J/Secure. |
ARN | Acquirer Reference Number - уникальный номер операции в клиринговом обмене между банками/процессинговыми центрами), содержит 31 символ. Этот код подтверждает успешное выполнение операции. Значение доступно только сотрудникам процессинговых отделов и не отображается в выписках. |
Chargeback | Cитуация, когда держатель карты требует возврата средств через банк. Для ее разрешения происходит разбирательство, в случае проигрыша Продавца оплачивает 15 долларов США (явно отражено в договоре). |
CMS | Система управления контентом. С точки зрения интеграции с YourPayments, имеются в виду системы, позволяющие создавать Интернет-магазины и управлять ими. YourPayments интегрируется с основными CMS, предназначенными для Интернет-торговли |
Electronic Commerce Indicator (ECI) | – индикатор, показывающий степень защиты, применяемую при предоставлении покупателем своих данных Продавцу. Его значение отражает результаты аутентификации и параметры процесса оплаты на сайте Продавца. Сервер Продавца направляет запрос на авторизацию платежа, включая ECI, эквайеру или в процессинговый центр. Возможные значения: 5: Аутентификация держателя карты выполнена через ввод пароля или личных данных. Значение передается ACS(сервером контроля доступа) в ответ на аутентификацию плательщика (PAR) после прохождения плательщиком аутентификации через систему 3DS. 6: Продавец попытался выполнить аутентификацию держателя карты, но либо держатель карты, либо ее эмитент не участвовали в процессе. Значение передается ACS (сервером контроля доступа) как ответ на попытку аутентификации. Кроме того, это значение может использоваться если от Visa Directory Server приходит код N параметра Verify Enrollment 7: Продавец устанавливает это значение, если транзакция осуществлена через защищенный канал (напр., SSL/TLS), но аутентификация не была выполнена, либо эмитент ответил, что она невозможна. Значение 7 используется если Verify Enrollment или Payer Authentication Response содержит код U – аутентификация невозможна. |
PRN | Payment Reference Number. Уникальный номер платежа, предоставляемый плательщику для возможности сравнения фактических результатов списания с параметрами платежа |
Внешняя ссылка | В панели управления так называется номер транзакции, передаваемый Продавцом. Также существует номер, присваиваемый YourPayments |
Выплата | Выдача денег на карту клиента Продавца. Также используются термины "payout" |
Мошенничество | Также используется термин "фрод" (fraud). Попытка использования поддельных (чужих) платежных реквизитов для совершения сделки через Интернет. В системе YourPayments принимаются меры к отслеживанию и предотвращению мошеннических операций |
МКК/МФК | Микрофинансовые организации: микрофинансовые компании (МФК) и микрокредитные компании (МКК) |
МПС | Международные платежные системы (Visa, MasterCard, etc.) |
Товар | Запись в БД, описывающая продукт или услугу, реализуемую через Продавца и оплачиваемую через YourPayments. |
Токен | Код, формируемый системой и присваиваемый определенному платежному инструменту (чаще всего, карте). При повторном использовании данного инструмента, сайт Продавца и система YourPayments используют токен для обработки повторного платежа. Токены, в частности, используются для автоматизации и упрощения процедуры оплаты услуг, предоставляемых по подписке/на условиях абонентской платы. Новые платежи не требуют участия владельца карты и выполняются автоматически |
Продавец | Сайт интернет-магазина, на котором организуют проведение онлайн платежей (также "мерчант", магазин) |
Эквайер | Организация (как правило, банк), выполняющая операции по взаимодействию с точками обслуживания карточек, которая состоит из терминалов в торгово-сервисной сети и банкоматов. Эквайер отвечает за перевод средств торговым точкам. YourPayments работает с Промсвязьбанком, БИНБАНКом, Банком Русский Стандарт, Тинькофф и ВТБ24. |
Эмитент | Кредитная организация, выдавшая пластиковую карту. |
Очень коротко:
Чарджбек / Финансовая претензия / Диспут (далее по тексту – ЧБ) – это запрос возврата денежных средств от владельца карты как правило по одной из следующих причин:
- мошенническая операция (держатель карты заявляет, что не проводил оплату)
- товар не доставлен / сервис не оказан
ЧБ инициируется владельцем карты в своем банке (банке, выпустившем карту).
Мерчант может согласиться с претензией («_согласиться на ЧБ_») или отклонить запрос на возврат («_отклонить ЧБ_»).
- Если мерчант соглашается с ЧБ и возвратом средств клиенту, то такой возврат проводит банк-эквайер, поэтому дополнительных действий со стороны мерчанта не требуется (кроме согласия в ответном письме)
- Если мерчант не согласен с ЧБ – необходимо обосновать свою позицию согласно правилам Международных платежных систем (Visa / MasterCard / МИР / UnionPay) и предоставить соответствующие документы в полном объеме
- Если до получения ЧБ мерчант провел возврат – YPMN отклонит претензию
- Если мерчант не отвечает на запрос – ЧБ будет принят автоматически по истечении срока на ответ, возврат средств владельцу карты будет проведен за счет средств мерчанта
- Основные понятия
МПС – международная платежная система (например, МИР, Visa или MasterCard).
Retrieval Request – запрос информации и документации о конкретной транзакции. В некоторых случаях при получении претензии от держателя карты банк-эмитент может принять решение предварительно запросить информацию у мерчанта и только потом принять решение, давать ли ход заявлению держателя карты. Таким образом информация, представленная (или не представленная) мерчантом может вести к чарджбеку.
ЧБ (chargeback / dispute/ финансовая претензия) – это процедура, строго регламентирована правилами МПС. Возникает, когда владелец карты обращается в свой банк и заявляет о претензии и просьбе провести возврат по указанной причине (reason code).
Reason Code (RC) – указанная владельцем карта причина опротестования (например, Услуга не оказана, Двойная оплата, Возврат не проведен).
Representment (или 2presentment) – документированное обоснование позиции мерчанта, доказывающее почему платеж не должен быть возвращен клиенту и его претензия необоснованна.
Пре-арбитражный запрос (pre-arbitration) – повторный ЧБ, фаза предшествующая arbitration (арбитражу). Возникает, если владелец карты и банк-эмитент не согласны с доводами, которые предоставил мерчант в representment и настаивают на возврате средств.
Аrbitration – финальный этап, где решение принимает комиссия МПС, изучив все предоставленные документы от двух сторон: мерчанта и владельца карты. Комиссия за проигрыш в арбитраже составляет 30 000 руб. по каждой транзакции, поэтому решение о выходе на эту стадию стороны должны принимать осознанно.
Мерчант (или ТСП, продавец) – торгово-сервисное предприятие, которое заключило договор с YPMN для проведения платежей
Банк-эмитент – банк, который выпустил карту
Банк-эквайер – процессинговый банк, который проводит операцию оплаты / возврата, с которым у YPMN заключен договор на обработку транзакций
Вся процедура ЧБ строго регламентирована правилами МПС, правила размещены в свободном доступе для ознакомления по следующим ссылкам MasterCard и Visa. Российское законодательство, регулирующее отношения сторон в процессе оплаты и последующего ЧБ, безусловно учитывается при рассмотрении вопроса.
Вся коммуникация в процессе ЧБ строится следующим образом:
- Держатель карты взаимодействует с банком-эмитентом
- Банк-эмитент взаимодействует с МПС
- МПС взаимодействует с банком-эмитентом, банком-эквайером и YPMN
- Банк-эквайер взаимодействует с МПС и YPMN
- YPMN взаимодействует с МПС, банком-эквайером и мерчантом
- Мерчант взаимодействует с YPMN
ВАЖНО:
- Для отклонения чарджбека (запроса на возврат) могут быть приняты только сканы документов и фото (видео и аудио файлы не будут приняты МПС)
ЧЕГО ДЕЛАТЬ НЕ СТОИТ:
- Проводить возврат средств плательщику самостоятельно, не дожидаясь результатов рассмотрения ЧБ со стороны МПС. Если чарджбек получен – он уже зафиксирован в МПС и удалить его нельзя, его можно отклонить или принять. Возврат, проведенный в процессе рассмотрения диспута, не будет учтен и мерчант может потерять деньги дважды
ЧТО СТОИТ СДЕЛАТЬ:
- Выяснить причину предъявления претензии, оперативно и аккуратно подготовить документы для процедуры representment и направить их в YPMN по адресу chargeback@ypmn.ru
- Задать все имеющиеся вопросы YPMN и получить на них ответы
- Пересмотреть информацию на сайте, в том числе правила доставки, возврата и обмена – это поможет избежать претензий в будущем
- Процесс документооборота
a. Retrieval Request
Получение такого запроса означает предварительное расследование банка-эмитента по транзакции, как правило, Retrieval Request это потенциальный чарджбек, но не обязательно в него переходит.
Необходимые действия для мерчанта:
- проверить факт оказания услуги,
- собрать максимальное количество информации о запрашиваемой транзакции в указанные банком сроки (как правило, 3-5 дней), например: описание заказа, подтверждение доставки, переписка с клиентом, если есть,
- разрешается проводить возврат по транзакции, это предотвратит получение ЧБ в случае рисковой или мошеннической операции (если услуга не была еще оказана и если мерчант не понесет финансовых потерь),
- отправить запрашиваемую информацию в ответ на письмо от YPMN (ответ необходимо направить именно в YPMN, а не напрямую в банк, т. к. со стороны YPMN будут добавлены детали транзакции, банковские данные и комментарии/объяснения при необходимости).
b. Чарджбек
Получение финансовой претензии означает, что клиент не согласен со списанием и запросил вернуть сумму транзакции, обратившись в свой банк.
Важно! Покупатель не всегда является владельцем карты.
Основные причины (reason code):
- MERCHANDISE_NOT_RECEIVED (покупатель не получил услугу/товар)
- NOT_AS_DESCRIBED (товар отличается от указанного описания на сайте)
- DUPLICATE_TRANSACTION (заказ или услуга не оказаны)
- FRAUD / NOT_RECOGNIZED (мошенничество/операция не опознана)
- CREDIT_NOT_PROCESSED (обещанный или согласованный возврат не получен)
- LATE_PRESENTMENT (дата списания отличается от даты покупки, списание произведено намного позже, чем сумма была заблокирована на карте клиента).
!! Информация для банка-эквайера должна быть собрана и предоставлена в соответствии с кодом претензии!!
Необходимые действия:
- проверить статус оказания услуги и подготовить подтверждение,
- собрать максимум информации о запрашиваемой транзакции в указанные банком сроки, обычно это 3-5 дней (документы необходимо подготовить с учетом кода оспаривания),
- отправить запрашиваемую информацию в ответ на письмо от YPMN (ответ необходимо направить именно в YPMN, а не напрямую в банк, со стороны YPMN будут добавлены детали транзакции, банковские данные и комментарии/объяснения при необходимости),
- недопустимо производить возврат по оспариваемой транзакции, т. к. держатель карты в итоге может получить две суммы по платежу. В лучшем случае такой возврат не пройдет, в худшем – двойной убыток по операции,
- рекомендуется контакт с клиентом для уточнения причины оспаривания и при разрешении проблемы можно запросить письмо, в котором клиент в письменной форме отказывается от оспаривания по указанной операции.
Если информация не будет получена МПС в указанный срок – ЧБ будет признан валидным (будет принят)
- Что необходимо подготовить, чтобы отклонить чарджбек?
В зависимости от причины ЧБ должен быть предоставлен следующий набор данных:
RC: Мошенничество/операция не опознана:
Если в транзакции принимал участие настоящий владелец карты, но он просто не узнает операцию в выписке (платеж по подписке или абонементу), то у нас есть шанс отклонить первый чарджбек, предоставив следующие документы:
- Информация, которая содержит описание продукта/услуги и содержит дату и способ доставки.
- Копия информации, представленной покупателю во время покупки, которая содержит предупреждение о регулярном списании и условия подписки (если платеж регулярный).
- Cкрин-шот страницы сайта с информацией об условиях отмены подписки.
- История обращений клиента, если есть (только в письменной форме).
- Подтверждение покупателем получения продукта.
RC: Заказ или услуга не оказаны:
- Подтверждение получения продукта покупателем (подтверждение того, что продукт был только отправлен недостаточно для отклонения претензии) или услуги.
- Копия информации, представленной клиенту во время транзакции, которая содержит описание продукта / услуги и указывает дату и способ доставки.
- Информация о том, обращался ли владелец карты напрямую к продавцу с просьбой рассмотреть жалобу, как жалоба была обработана и почему она была отклонена (если применимо).
RC: Продукт не соответствует описанию, поврежден или услуга, оказана иначе, чем было оговорено/обещано:
- Копия информации, представленной покупателю во время покупки, которая содержит описание продукта/услуги и содержит дату и способ доставки, и которая доказывает, что продукт/услуга соответствует своему описанию.
- Документ, подтверждающий, что покупатель получил товар и подтвердил, что он не был поврежден.
- Письменные заявления и документы мерчанта (при наличии), если:
- товар не был возвращен покупателем
- товар / услуга отремонтирована или недостающие элементы были восполнены
- Информация о том, обращался ли владелец карты напрямую к продавцу с просьбой рассмотреть жалобу, как жалоба была обработана и почему она была отклонена (если применимо).
RC: Двойная оплата одного и того же товара/услуги (оплата одной и той же картой, другой картой, переводом или иным образом)
- Документы, подтверждающие, что платежи касались различных товаров/услуг или что клиент успешно получил два заказа или успешно воспользовался двумя услугами.
Ответственность за получение двойной оплаты одного доставленного заказа лежит на мерчанте несмотря на то, что плательщик провел две оплаты самостоятельно. Мерчант должен отслеживать дубликаты или излишки поступлений на счет.
RC: Обещанный или согласованный возврат не получен
- Подтверждение того, что был произведен соответствующий возврат.
- Письменные заявления и документы Продавца (при наличии), если:
- товар не был возвращен покупателем,
- продавец не принял возврат или отмену услуги,
- продавец представил политику отказа и возврата при покупке.
ВАЖНО:
Информация для запросов по картам Visa (RC Мошенничество) и по картам иностранных банков должна быть подготовлена на английском языке или с комментариями на английском.
В каждом ЧБ в дополнение к стандартному пакету документов может быть приложено письмо/заявление от владельца карты, которое мерчант может запросить у него напрямую. В этом письме клиент должен сообщить, что услугу по указанной операции получил и не намерен продолжать спор далее – в свободной форме. Это поможет в отклонении чарджбека, но не является гарантией успеха. От полноты ответа зависит исход разбирательства по претензии. В случае продолжения спора со стороны эмитента и получения пре-арбитражного уведомления, дополнительные документы могут не приниматься во внимание Арбитражным комитетом, поэтому важно предоставить полный пакет подтверждающей информации на этапе первой претензии.
- Пре-арбитражный запрос (второй чарджбек)
Получение Пре-арбитражного запроса означает, что владелец карты и его банк рассмотрели ранее присланные документы и решили продолжить процесс оспаривания транзакции, т. к. не согласны с предоставленными доводами. Это повторный запрос вернуть сумму транзакции от эмитента и, если второй запрос будет также отклонен, эмитент может инициировать Арбитраж, где решение уже принимает комиссия МПС, а не владелец карты.
Необходимые действия при получении пре-арбитража:
взвесить все риски и принять решение, оценив шансы выиграть или проиграть потенциальный арбитраж (арбитражный комитет платежной системы удерживает комиссию в размере 30 000 руб. по каждой транзакции с проигравшей стороны, что зачастую превышает размер оспариваемой транзакции).
В случае, если мерчант все еще не согласен вернуть средства по процедуре претензии и настаивает, что возврат не должен быть проведен, необходимо:
проверить и собрать максимум дополнительной информации о запрашиваемой транзакции в указанные банком сроки
отправить запрашиваемую информацию в YPMN в указанные сроки.
По нашей практике большинство мерчантов не продолжают спор после получения второго чарджбека, т. к. риск проиграть в большинстве случаев больше, чем возможность выиграть (сумма комиссии за проигрыш несопоставима часто с суммой транзакции).
Если эмитент решил инициировать Арбитраж – мерчант будет проинформирован о результате, как только информация будет доступна.
- Предотвращение чарджбека
Как и с любой претензией, чарджбек зачастую легче предотвратить, чем впоследствии тратить ресурсы на его отклонение.
Для предотвращения получений чарджбеков, пожалуйста, убедитесь, что на сайте присутствуют и находятся в легком доступе:
- полное описание продукта/товара/услуги и его свойства,
- контакты поддержки сайта,
- информация о сроках доставки,
- условия и способы возврата/обмена,
- при оплате клиент должен поставить заметную галочку рядом с уведомлением о регулярных платежах, если они предусмотрены подпиской или абонементом.
Общие рекомендации:
- используйте дополнительную верификацию (3DS, MirAccept), это защитит вас от чарджбеков с кодом «мошенничество»,
- оперативное отвечайте на обращения
- если возврат был обещан клиенту – провести его необходимо как можно скорее, но не позднее 15 дней с момента согласия. МПС настоятельно рекомендует проводить возвраты точно таким же способом, каким был проведён платеж клиента – это упростит процесс отклонения чарджбека.
- Примечание
Статус чарджбека не отображается в Личном Кабинете мерчанта. Статистику или отчетность по чарджбекам можно запросить, написав на chargeback@ypmn.ru.
Если на момент получения чарджбека мерчант уже провел возврат в системе YPMN, такой чарджбек будет отклонен без уведомления мерчанта – для отклонения будет использована информация о таком возврате и дополнительная информация не требуется.
Cancel Dispute: вариант для закрытия ошибочного Dispute, запись об открытом ранее Dispute не сохраняется в самой транзакции. Используется в случае, если диспут был открыт с указанием неверного reason code. Причину опротестования исправить в системе YPMN не предоставляется вохзможным, только отменить диспут и открыть новый.
Close Dispute:
REFUND_GRANTED_BY_VENDOR (используется, если ТСП при получении чарджбека соглашается с ним и не оспаривает транзакцию. Также используется, если правила МПС не дают возможности ее оспорить (например, по карте была единственная транзакция на терминале без 3дс и получен фродовый чарджбек (Visa)). За каждый принятый чарджбек вместе с суммой транзакции удерживается комиссия в размере 15$ (эта информация указана в договоре).
REFUND_DENIED (используется, если мы успешно отклонили чарджбек или пре-арбитраж).
Форма Secure Fields - это HTML форма, которая вставляется в ваш сайт для сбора информации о карте пользователя.
При использовании формы Secure Fields, YPMN генерирует поля для ввода карточных данных и собирает карточную информацию, отправленную пользователем. Таким образом, уменьшаются требования PCI, требуя от вас соответствия стандарту SAQ A.
Вы можете стилизовать форму как пожелаете. См. пример ниже:

Когда карточная информация отправлена с помощью формы Secure Fields, YPMN возвращает вашему сайту токен карты. Токен используется для создания и авторизации оплаты.
Шаги для внедрения формы Secure Fields в вашу платежную страницу.
1. Включение Secure Fields Javascript SDK в вашу платежную страницу
Secure Fields Javascript SDK расположен
- в боевом контуре по ссылке
https://secure.ypmn.ru/js/secure-fields/secure-fields.min.js
, - в тестовом контуре по ссылке
https://sandbox.ypmn.ru/js/secure-fields/_sb/secure-fields.min.js
<body>
...
<script src="https://secure.ypmn.ru/js/secure-fields/secure-fields.min.js"></script>
...
</body>
2. Добавление формы с нужными полями ввода
Пример ниже содержит следующие поля: номер карты, срок действия карты, cvv-код, согласие пользователя. См. подробную информацию об элементах (полях) формы по ссылке.
<body>
...
<form id="payment-form">
<div class="field">
<input id="cardholder-name" class="input" placeholder="John Doe" />
<label>Name</label>
</div>
<div class="field">
<div id="card-number" class="input"></div>
<label>Card Number</label>
</div>
<div class="field">
<div id="exp-date" class="input "></div>
<label>Expiration Date</label>
</div>
<div class="field">
<div id="cvv" class="input"></div>
<label>CVV</label>
</div>
<div class="field">
<div id="user-agreement" class="input"></div>
</div>
<button type="submit" id="pay_button">Pay $25</button>
</form>
...
</body>
3. Инициализация формы Secure Fields
Создайте экземпляр Secure Fields, вызвав PayUSecureFields.Init(auth, options?)
.
В качестве первого аргумента вам необходимо передать аутентификационные данные, в качестве второго вы можете передать пользовательские стили,
которые будут применены к полям формы (второй аргумент не является обязательным).
Получить sessionId можно с помощью API. Это должно быть сделано до инициализации формы Secure Fields.
Внимание: Сессия должна быть уникальной для успешной авторизации, т.е. после успешной авторизации с помощью Secure Fields вы должны получить новую сессию.
/*
Создание инстанса secure fields.
В качестве первого аргумента, передается merchantCode и sessionId (обязательно).
В качестве второго аргумента передается список пользовательских стилей, которые будут применены к полям (опционально).
*/
const auth = {
merchantCode: 'YPMN merchant code',
sessionId: '79fac7b6-4f87-4a17-92b4-bffe16f68f1e',
}
const fonts = [
{
src: 'https://fonts.googleapis.com/css?family=Source+Code+Pro',
}
]
const formElements = new PayUSecureFields.Init(auth, {
fonts
})
4. Создание экземпляра каждого поля, которое вы хотите показать в вашей форме
Создание экземпляра каждого поля осуществляется путем вызова formElements.create(elementType,options?)
с указанием типа поля, которое вы хотите создать, и дополнительным опциями. Затем необходимо смонтировать каждое поле в структуру DOM.
/*
Объект placeholders - это только один пример дополнительных опций, которые могут быть переданы при создании поля.
*/
const placeholders = {
cardNumber: '1234 1234 1234 1234',
expDate: 'MM / YY',
cvv: '123'
}
// Создание полей, которые вы хотите показывать, и добавление их в DOM.
const cardNumber = formElements.create('cardNumber', {
placeholders
})
cardNumber.mount('#card-number')
const expiry = formElements.create('creditCardExpiry', {
placeholders
})
expiry.mount('#exp-date')
const cvv = formElements.create('cvv', {
placeholders
})
cvv.mount('#cvv')
const userAgreement = formElements.create('userAgreement', {})
userAgreement.mount('#user-agreement')
5. Создание токена
Вызовите PayUSecureFields.createToken()
когда пользователь отправит форму, но только после того,
как вы получите имя картодержателя, чтобы передать его в виде объекта, содержащего дополнительные данные. Имя картодержателя является обязательным полем,
вы не можете пропустить этот шаг.
Перейти к деталям по токенизации
document.getElementById('payment-form').addEventListener('submit', async(event) => {
event.preventDefault()
const additionalData = {
holder_name: document.getElementById('cardholder-name').value // This field is mandatory
}
const result = await PayUSecureFields.createToken(cardNumber, {
additionalData
})
console.log(`The response is ${JSON.stringify(result)}`)
})
6. Итоговые файлы
<!-- Это ваш html файл -->
<body>
<div class="checkout-page">
<form id="payment-form">
<div class="field">
<input id="cardholder-name" class="input" placeholder="John Doe" />
<label>Name</label>
</div>
<div class="field">
<div id="card-number" class="input"></div>
<label>Card Number</label>
</div>
<div class="field">
<div id="exp-date" class="input"></div>
<label>Expiration Date</label>
</div>
<div class="field">
<div id="cvv" class="input"></div>
<label>CVV</label>
</div>
<div class="field">
<div id="user-agreement" class="input"></div>
</div>
<button type="submit" id="pay_button">Pay $25</button>
</form>
</div>
<script src="https://secure.ypmn.ru/js/secure-fields/secure-fields.min.js"></script>
<script src="index.js"></script>
</body>
// Это ваш index.js файл
/*
Создание инстанса secure fields.
В качестве первого аргумента передается merchantCode и sessionId (обязательно).
В качестве второго аргумента передается список пользовательских стилей, которые будут применены к полям (опционально).
*/
const auth = {
merchantCode:'YPMN merchant code',
sessionId: '79fac7b6-4f87-4a17-92b4-bffe16f68f1e',
}
const fonts = [
{
src: 'https://fonts.googleapis.com/css?family=Source+Code+Pro',
}
]
const formElements = new PayUSecureFields.Init(auth, {
fonts
})
/*
Создание объекта с дополнительными опциями, которые можно передать в конструктор при создании полей.
Существует множество других опций доступных для передачи в конструктор, но для простоты мы
показываем один объект в нашем примере.
*/
const placeholders = {
cardNumber: '1234 1234 1234 1234',
expDate: 'MM / YY',
cvv: '123'
}
// Создание полей, которые вы хотите показывать, и добавление их в DOM.
const cardNumber = formElements.create('cardNumber', {
placeholders
})
cardNumber.mount('#card-number')
const expiry = formElements.create('creditCardExpiry', {
placeholders
})
expiry.mount('#exp-date')
const cvv = formElements.create('cvv', {
placeholders
})
cvv.mount('#cvv')
const userAgreement = formElements.create('userAgreement', {})
userAgreement.mount('#user-agreement')
/*
Создание токена, когда пользователь отправляет форму, но только после того, как имя картодержателя будет получено
и передано в виде объекта, содержащего дополнительные данные, при вызове createToken.
*/
document.getElementById('payment-form').addEventListener('submit', async(event) => {
event.preventDefault()
const additionalData = {
holder_name: document.getElementById('cardholder-name').value // This field is mandatory
}
const result = await PayUSecureFields.createToken(cardNumber, additionalData)
console.log(`The response is ${JSON.stringify(result)}`)
})
Если случилась ошибка, ответ будет выглядеть следующим образом:
{
statusCode: CLIENT_ERROR,
errors: {
invalid_pan: 'Card number did not pass luhn validation',
invalid_expiry: 'Card expiration date is invalid',
client_error: 'Invalid expiryYear or expiryMonth'
}
}
Возможные ключи ошибок: invalid_pan | invalid_expiry | invalid_cvv | invalid_cardholder_name | invalid_agreement | client_error | server_error
Возможные статус коды: CLIENT_ERROR | SERVER_ERROR | SUCCESS
В случае успеха ответ будет выглядеть следующим образом:
{
statusCode: SUCCESS,
token: "fAMfv4qbHx0TU1FwwXroS2H+G3DSKkvrgYuuPaB1a1VpJgIg+WjGB2Bg==",
cardUniqueIdentifier: "b1e6d93a154e375695ed87d7404d25e27923442e3f7b34afb5a8aff3de69cb64",
cardExpirationDate: "2024-10-31",
lastFourDigits: "1234"
}
Вызов метода createToken
в короткий промежуток времени без ожидания ответа предыдущих вызовов приведет к клиентской ошибке с сообщением "Overlapping request".
Цель этого механизма предотвратить создание дупликатов отправки формы по ошибке, например в случае двойного клика по кнопке отправки формы.
Для предотвращения этого при интеграции Secure Fields необходимо убедиться, что перед отправкой нового запроса на создание токена получен ответ от предыдущего запроса.
При инициализации Secure Fields путем вызова PayUSecureFields.Init(authData, options?)
есть несколько опций, которые вы можете передать: пользовательские стили, опция выключения валидации номера карты по алгоритму Луна.
Список доступных опций см. по ссылке.
При описании шагов, необходимых для встраивания формы Secure Fields в страницу оплаты, мы остановились на базовом примере, который показывает как создать следующие поля: номер карты, срок действия карты, cvv-код, согласие пользователя. Полный список доступных типов полей см. в разделе Элементы (поля) формы.
Обязательными являются следующие поля Secure Fields: номер карты, срок действия, пользовательское соглашение.
Также вы должны передавать имя картодержателя в объекте дополнительных данных.
Создание поля формы происходит путем вызова formElements.create(elementType, options?)
.
Вторым аргументом этого вызова является объект, содержащий дополнительные опции, например: placeholder для номера карты.
const placeholders = {
cardNumber: '1234 1234 1234 1234'
}
const cardNumber = formElements.create('cardNumber', {
placeholders
})
Однако существует больше опций, которые вы можете использовать. Все доступные опции см. в разделе Элементы (поля) формы.
Форма Secure Fields предоставляет слушатели событий: изменение поля, изменение фокуса на поле. Они вызываются следующим образом:
cardNumber.on('change', (event) => {
console.log(event)
})
cardNumber.on('focus', (event) => {
console.log(event)
})
cardNumber.on('blur', (event) => {
console.log(event)
})
Параметр event
callback-функции возвращает следующий объект (значения приведены в качестве примера):
{
bin: "510510", // BIN карты
complete: false, // введены ли и являются ли валидными данные карты
brand: "visa", // возвращается только для номеров карт
empty: false, // пустое ли поле для ввода
error: undefined // объект с ошибкой в случае возникновения ошибки при вводе данных
}
Есть несколько методов, которые вы можете использовать с каждым типом поля (см. список всех доступных типов полей в разделе Элементы (поля) формы).
Эти методы перечислены ниже.
Метод | Описание |
---|---|
update(optionsObject) | Обновляет поле ввода с применением указанных опций. См. список опций, которые вы можете передать, в разделе Элементы (поля) формы |
clear() | Очищает поле ввода |
destroy() | Удаляет поле ввода из структуры DOM. Данный метод можно вызвать один раз. |
mount(containerSelector) | Монтирует поле ввода в структуру DOM. |
Вы можете стилизовать Secure Fields путем передачи объектов стилей и классов
при вызове formElements.create(elementType,options?). Объект стилей позволяет
вам стилизовать поля Secure Fields на основе их состояния (валидные данные, данные не введены, невалидные данные).
Объект классов позволяет вам применить пользовательские классы к div
элементам, оборачивающим поля ввода, давая вам
еще больше контроля над стилями, которые вы можете применять к полям. Рассмотрим оба варианта.
1. Применение стилей
Перейти к описанию объекта стилей
Объект стилей имеет вложенные объекты, чьи ключи - это название статуса ввода данных в поле (валидные данные, данные не введены, невалидные данные).
Исключение - вложенный объект base
; этот объект содержит стили, которые наследуются другими объектами.
Ниже представлен базовый пример с объектами base
и invalid
(применяется, если введенные пользователем данные не валидны):
const style = {
base: {
color: '#fff',
fontWeight: 600,
fontFamily: 'Quicksand, Open Sans, Segoe UI, sans-serif',
fontSize: '16px',
fontSmoothing: 'antialiased'
},
invalid: {
color: '#FF0000'
}
};
Вы можете также добавить псевдо-классы и псевдо-элементы для еще более детального контроля над стилизацией элементов:
const style = {
base: {
color: '#fff',
fontWeight: 600,
fontFamily: 'Quicksand, Open Sans, Segoe UI, sans-serif',
fontSize: '16px',
fontSmoothing: 'antialiased',
':focus': {
color: '#424770',
},
'::placeholder': {
color: '#9BACC8',
},
':focus::placeholder': {
color: '#CFD7DF',
},
},
invalid: {
color: '#FF0000',
':focus': {
color: '#FA755A',
},
'::placeholder': {
color: '#FFCCA5',
},
}
};
Объект со стилями необходимо передать при вызове formElements.create(elementType,options?):
const cardNumber = formElements.create('cardNumber', {
style,
...
})
2. Применение пользовательских классов
Перейти к описанию объекта классов
Объект классов позволяет вам применить пользовательские классы к div
элементам, оборачивающим поля ввода, в зависимости от статуса
введенных в поле данных (валидные данные, данные не введены, невалидные данные). Ключи объекта классов представляют собой названия
статуса ввода данных в поле. В примере ниже мы применяем класс my-own-invalid-class
к полям ввода, если пользователь ввел невалидные данные.
const classes = {
invalid: 'my-own-invalid-class'
}
div
элемент, к которому применяются классы, - это элемент, который вы передаете при вызове
formElement.mount(containerSelector)
.
Если вы не передаете объект классов, тогда применяются дефолтные классы.
Объект с классами необходимо передать при вызове
formElements.create(elementType,options?)
:
const cardNumber = formElements.create('cardNumber', {
classes,
...
})
Вы можете стилизовать форму, как пожелаете. Ниже приведен пример стилизованной формы:

При стилизации формы поле userAgreement (соглашение пользователя с условиями) должно обязательно оставаться видимым, чтобы пользователь видел, что при отправке формы он соглашается с условиями.
Одноразовая токенизация - процесс, который защищает чувствительные карточные данные, конвертируя их
в токен. Когда вы токенизируете карточные данные пользователя, YPMN возвращает объект одноразового токена
.
Три вещи, которые вам следует знать о токенизации:
- После попытки осуществления платежа (необязательно успешной) вы больше не можете использовать тот же самый токен. Если вы хотите переиспользовать токен, чтобы покупателям не нужно было повторно вводить информацию о карте, вы должны сначала создать постоянный токен и затем использовать сохраненный токен в запросах на проведение оплаты. Для дополнительной информации см. раздел Токены (сохраненные карты).
- Токенизация не включает валидацию карты, а позволяет защитить чувствительные карточные данные. Например, срок действия карты мог истечь или карта могла быть аннулирована. Это не будет выявлено при токенизации карты, сообщение об этом придет при попытке совершить первую транзакцию.
- CVV-код является частью токена.
Чтобы иметь возможность получить информацию о карте, Secure Fields позволяет использовать событие cardInfo
, которое
вы можете прослушать и получить информацию, как только пользователь введет номер карты.
Чтобы получать эти данные, необходимо при создании поля cardNumber (или при создании поля fullCreditCard, др.)
добавить опцию getCardInfo: true
.
Ниже представлены 2 ответа, которые вы можете получить от события cardInfo:
//1. объект информации о карте (со следующей структурой)
{
binNumber: string
cardProfile: ?string
cardProgram: ?string
cardScheme: ?string
cardType: ?string
installmentOptions: ?string
issuerBank: ?string
issuerCountryCode: ?string
paymentMethod: ?string
}
//2. пустой объект {} в случаях, когда предыдущий ответ был недействительным (например, пользователь удаляет номер карты после того, как полностью набрал его)
{}
Ниже приведен пример, как создать поле cardNumber
с включенной опцией получения информации о карте:
const cardNumber = fields.create('cardNumber', {
style,
placeholders,
classes: elementClasses,
getCardInfo: true
})
// подписка на событие cardInfo:
cardNumber.on('cardInfo', (event) => {
console.log('cardInfoEvent', event)
})
Теперь, когда вы собрали информацию о карте клиента, приступайте к созданию и авторизации платежа.
Уделите внимание блоку authorization.oneTimeUseToken
в теле запроса. В нем должен быть указан одноразовый токен, полученный при токенизации Secure Fields, и sessionId,
использованный при инициализации Secure Fields и получении токена.
Класс создания Secure Fields и токенизации данных карты.
1 PayUSecureFields.Init(authData, options?)
Создает экземпляр (инициализирует) Secure Fields.
Параметры
Имя | Тип | Описание |
---|---|---|
auth | AuthenticationData object | (обязательный) объект, используемый для аутентификации мерчанта в YPMN. См. Secure Field AuthenticationData ниже. |
options | PosFieldsOptions object | (опциональный) объект с опциями, передаваемый при инициализации Secure Fields. См. Secure Field PosFieldsOptions ниже. |
Secure Field AuthenticationData
Имя | Тип | Описание | Пример |
---|---|---|---|
merchantCode | string | (обязательный) Код мерчанта (устанавливается YPMN) | MERC_1 |
sessionId | string | (обязательный) Session ID, сгенерированный API сессий | S79fac7b6-4f87-4a17-92b4-bffe16f68f1e |
Secure Field PosFieldsOptions
Имя | Тип | Описание | Пример |
---|---|---|---|
directionLtr | boolean | (опциональный) Отображать ли поля слева направо или справа налево. Значение по умолчанию: true (слева направо). | true |
fonts | array | (опциональный) Список пользовательских шрифтов, применяемых к полям, в виде массива объектов, где каждый объект имеет ключ src и значение (строка) - ссылка на файл шрифтов. См. пример в разделе Интеграция формы Secure Fields в страницу оплаты. | [ { src: 'https://fonts.googleapis.com/css?family=Source+Code+Pro' } ] |
luhnValidation | boolean | (опциональный) Проверять ли номер карты по алгоритму Луна. Значение по умолчанию: true. | true |
2 PayUSecureFields.createToken(elementType,additionalData)
Возвращает токен для карточных данных, отправленных через форму Secure Fields.
Параметры
Имя | Тип | Описание |
---|---|---|
elementType | string | Тип поля, для которого будет создан токен. Может принимать одно из следующих значений: fullCreditCard , creditCard , cardNumber . Описание каждого типа поля см. в разделе Типы элементов формы ниже. |
additionalData | object | JSON объект, содержащий пары ключ-значение дополнительных данных. Вы можете использовать эти данные в дополнение к данным карты, введенным пользователем. Данный параметр является обязательным, т.к. вы должны передать как минимум имя картодержателя. |
Элементы формы - поля, которые вы хотите показывать на странице оплаты.
1 formElements.create(elementType,options?)
Создает элемент формы (поле) для отображения на странице оплаты. formElements
- экземпляр, возвращаемый при вызове PayUSecureFields.Init(options?)
.
Параметры
Имя | Тип | Описание |
---|---|---|
elementType | string | Тип создаваемого поля. См. ниже типы элементов формы (полей). |
options | object | (optional) Дополнительные опции для передачи при создании поля. См. ниже перечень опций. |
1.1. Типы элементов формы (полей)
Имя типа поля | Описание |
---|---|
fullCreditCard | Отображает поля для ввода номера карты, срока действия и cvv кода |
creditCard | Отображает поля для ввода номера и срока действия карты |
cardNumber | Отображает поле для ввода номера карты |
creditCardExpiry | Отображает поле для ввода срока действия карты |
cvv | Отображает поле для ввода cvv кода |
userAgreement | Отображает чекбокс для принятия пользовательского соглашения |
1.2. Опции элементов формы
Опция | Тип | Описание |
---|---|---|
cardFormat | boolean | Приводить ли вводимый номер карты к соответствующему формату. Применимо только для полей с типом карты. Значение по умолчанию: true |
maxCardPanLength | number | Максимальная длина номера карты. Применимо только для полей с типом карты. Если для опции cardFormat установлено значение true , мы добавим 3 дополнительных символа для пробелов, используемых при форматировании. Значение по умолчанию: 22 символа с установленным true для опции cardFormat . |
classes | object | Классы, применимые для div , оборачивающего поле ввода. См. дополнительную информацию в разделе Стилизация формы Secure Fields. |
disabled | boolean | Запрещает ввод данных в поле |
includeCardImage | boolean | Отображать ли логотип платежной системы при вводе номера карты. Применимо только для полей с типом карты. Значение по умолчанию: true |
placeholders | object | Отображаемый по умолчанию текст в полях ввода. Применяется для полей типа: cardNumber , cvv , expDate . Для поля userAgreement в placeholder можно установить язык отображения текста о пользовательском соглашении, значение по умолчанию: ru . |
style | object | CSS стили для стилизации полей ввода. См. дополнительную информацию в разделе Стилизация формы Secure Fields. |
2 formElement.clear()
Очищает поле ввода. formElement
возвращается при вызове formElements.create(elementType,options?)
.
3. formElement.destroy()
Удаляет поле ввода из DOM. Можно вызвать только один раз. formElement
возвращается при вызове formElements.create(elementType,options?)
.
4. formElement.mount(containerSelector)
Добавляет поле ввода в DOM. formElement
возвращается при вызове formElements.create(elementType,options?)
.
Параметры
Имя | Тип | Описание |
---|---|---|
containerSelector | string | ID элемента, внутрь которого будет смонтировано поле. |
5. formElement.on(eventType, callBack)
Устанавливает слушателя на поле ввода, отслеживает следующие события: изменение, фокус на поле и потеря фокуса.
formElement
возвращается при вызове formElements.create(elementType,options?)
.
Параметра
Имя | Тип | Описание |
---|---|---|
eventType | string | Тип события, которое слушается. Может принимать следующие значения: change , focus , blur . |
callBack | function | Callback функция. Функция принимает один параметр - объект результата. |
Параметр callback функции возвращает объект со следующими свойствами:
Имя | Тип значения | Описание |
---|---|---|
bin | string | Первые 6 цифр карты, идентифицирующие финансовый институт, выпустивший карту. |
complete | boolean | Введены ли и являются ли валидными данные карты. Примечание : Для поля карты значение будет true если при создании поля была выключена проверка по алгоритму Луна. |
brand | string | Бренд карты. Возвращается только для номеров карт. |
empty | boolean | Пустое ли поле для ввода. |
error | object | Объект с ошибкой в случае возникновения ошибки. |
В случае возврата объекта error
, он содержит следующие свойства:
Имя | Тип значения | Описание |
---|---|---|
cvv | string | Результат проверки введенного cvv кода. Пример значения: Card cvv is in the wrong length |
pan | string | Результат проверки введенного номера карта. Пример значения: Card number did not pass luhn validation |
expiry | string | Результат проверки введенного срока действия карты. Пример значения: Card expiration date is invalid |
agreement | string | Результат проверки согласия с пользовательским соглашением. Пример значения: User has not accepted user agreement |
6. formElement.update(options)
Обновляет поле ввода с применением указанных опций. formElement
возвращается при вызове formElements.create(elementType,options?)
.
Parameters
Имя | Тип | Описание |
---|---|---|
options | object | (опциональный) Опции, которые можно передать при создании поля. |
Вы можете стилизовать Secure Fields, передав объекты style
или classes
при вызове formElements.create(elementType,options?)
.
См. дополнительную информацию в разделе Стилизация формы Secure Fields.
1 Объект стилей
Ниже приведен список ключей объектов, представляющих статус введенных данных, для которых могут быть применены стили.
Обратите внимание, что объекты стилей должны быть вложены в объект style
.
Имя ключа | Описание |
---|---|
base | Стили, которые наследуются другими объектами |
complete | Применяется, когда введенные в поле данные валидны |
empty | Применяется, когда поле ввода пустое |
invalid | Применяется, когда введенные в поле данные не валидны |
Свойства объекта стилей
Ниже приведен список возможных свойств объекта стилей, расположенного внутри объекта style
.
Свойство | Тип |
---|---|
backgroundColor | string |
color | string |
fontFamily | string |
fontSize | string |
fontSmoothing | string |
fontStyle | string |
fontVariant | string |
fontWeight | string |
lineHeight | string |
letterSpacing | string |
padding | string |
textAlign | string |
textDecoration | string |
textShadow | string |
textTransform | string |
Псевдоклассы и псевдоэлементы объекта стилей
Ниже приведен список псевдоклассов и псевдоэлементов, которые может содержать объект стилей, расположенный внутри объекта style
:
- :hover
- :focus
- ::placeholder
- ::selection
- :disabled
2 Объект классов
Ниже приведен список ключей объектов, представляющих статус введенных данных, для которых могут быть применены пользовательские классы. Также приведены названия классов по умолчанию.
Имя ключа | Описание | Имя класса по умолчанию, если оно не задано |
---|---|---|
base | Базовый класс применяемый к div элементам, обворачивающим каждое поле ввода |
POSElement |
complete | Название класса применяемое к div элементу, когда введенные в поле данные валидны.Примечание: Для полей карты этот класс будет также применяться для поля с введенными невалидными данными, если при создании поля вы отключили проверку по алгоритму Луна. |
POSElement–complete |
empty | Название класса применяемое к div элементу, когда поле для ввода пустое |
POSElement–empty |
focus | Название класса применяемое к div элементу, когда фокус оказывается на поле |
POSElement–focus |
invalid | Название класса применяемое к div элементу, когда введенные в поле данные невалидны |
POSElement–invalid |
При подключении данной возможности мерчанты могут добавлять сабмерчантов путем отправки заполненной анкеты
- в разделе Подключение сабмерчантов в ЛК;
- по API.
Подключение проходит в несколько этапов:
- создание, заполнение и отправка мерчантом анкеты на проверку;
- проверка анкеты со стороны YP с одним из следующих результатов:
- отказ;
- анкета одобрена (переход к следующему шагу);
- анкета отправлена на доработку (мерчант должен внести изменения и снова отправить анкету на проверку);
- мерчант скачивает и распечатывает pdf-файл с заполненной анкетой, подписывает анкету и отправляет пакет документов YP;
- в случае успешного прохождения проверки в системе создается аккаунт продавца (сабмерчанта).
Статус | Значение |
---|---|
created | Новая анкета, необходимо заполнить и отправить на проверку YPMN |
filled | Анкета заполнена и отправлена на проверку, ожидает поступления в работу |
edited | Анкета отредактирована, необходимо заполнить и отправить на проверку YPMN |
review | Анкета на проверке у YPMN, ожидайте, пожалуйста |
returned | Анкета возвращена на уточнение, необходимо внести исправления и повторно отправить на проверку YPMN |
declined | Анкета отклонена, дальнейшие действия не требуются |
approved | Анкета подтверждена, пожалуйста, распечатайте анкету |
printed | Необходимо направить подписанные документы в НКО ООО Твои Платежи |
exported | Анкета проходит внутренние процедуры, ожидайте создания аккаунта(ов) субмерчантов |
imported | Анкета проходит внутренние процедуры, ожидайте создания аккаунта(ов) субмерчантов |
completed | Работа по анкете завершена, аккаунт(ы) субмерчантов созданы |
removed | Анкета удалена |
Подключение в ЛК осуществляется в разделе Подключение сабмерчантов.
Добавление одного сабмерчанта
Нажмите кнопку Добавить
/ Добавить по ИНН
для добавления одного сабмерчанта.
Добавление реестра сабмерчантов (если у вас подключена такая возможность)
- Выберете файл реестра (пример файла)
- Если первая строка в файле является заголовком, отметьте галочку
Первая строка - заголовок
- Нажмите кнопку
Загрузить
Если в реестре указаны реквизиты сабмерчантов, то анкеты добавятся в статусе "К запуску", иначе в статусе "На проверке".
API позволяет:
- отправить заполненную анкету на проверку;
- получить pdf-файл с заполненной анкетой;
- узнать текущий статус анкеты и получить список созданных по этой анкете аккаунтов продавцов;
- получить весь список анкет с указанием общей информации, статусу и созданных аккаунтов продавцов.
Создание и отправка анкеты на проверку
При отправке анкеты по API отправляется полностью заполненная и валидная анкета.
После отправки анкета получает статус filled
.
В случае наличия ошибок, они будут указаны в ответе на запрос.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
inn required | string [ 10 .. 12 ] characters Example: "1234567890" Допускаются только цифры |
required | object |
Responses
Request samples
- Payload
{- "inn": "1234567890",
- "schema": {
- "phones": [
- {
- "phone": "+7 495 1234567, доб. 123"
}
], - "emails": [
- {
- "email": "example1@ypmn.com"
}
], - "legalAddress": {
- "zip": "123456",
- "region": "Москва",
- "city": "Москва",
- "street": "ул. Арбат",
- "house": "10"
}, - "actualAddress": {
- "isEqualToLegalAddress": true
}, - "ceo": {
- "identityDoc": {
- "series": "1234",
- "number": "123456",
- "issueDate": "2000-01-30",
- "issuedBy": "МВД",
- "issuedByKP": "123-456"
}, - "birthDate": "1990-01-30",
- "birthPlace": "Москва",
- "registrationAddress": "г. Москва, ул. Ленина, д. 1, кв. 1"
}, - "owners": [
- {
- "owner": "Иванов Иван Иванович",
- "share": "100"
}
], - "bankAccounts": [
- {
- "bankAccount": {
- "bankBIK": "044525974",
- "bankCorAccount": "30101810145250000974",
- "bankAccount": "40817810400002911811"
}
}
]
}
}
Response samples
- 200
- 400
- 403
- 429
- 5XX
{- "id": 123,
- "status": "filled"
}
Статус анкеты
Получение статуса анкета по её ID.
Статус может быть запрошен как по анкете, созданной через API, так и через интерфейс cPanel.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 400
- 403
- 404
- 429
- 5XX
{- "id": 123,
- "status": "completed",
- "seller": {
- "name": "ООО Ромашка",
- "type": "org",
- "inn": 1234567890
}, - "accounts": [
- {
- "merchantCode": "romash11",
- "secretKey": "SECRET_KEY"
}
]
}
Печать анкеты
Получение заполненной pdf версии анкеты по её ID.
Анкету необходимо распечатать после получения вебхука об одобрении анкеты.
Может быть запрошено как по анкете, созданной через API, так и через интерфейс cPanel.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 400
- 403
- 404
- 429
- 5XX
{- "code": 400,
- "message": "Invalid qst id",
- "status": "INVALID_QST_ID"
}
Список анкеты
Получение списка анкет.
В ответе будет получен весь список анкет: созданных через API и через интерфейс cPanel.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 403
- 429
- 5XX
[- {
- "id": 123,
- "status": "completed",
- "seller": {
- "name": "ООО Ромашка",
- "type": "org",
- "inn": 1234567890
}, - "accounts": [
- {
- "merchantCode": "romash11",
- "secretKey": "SECRET_KEY"
}
]
}
]
Вебхуки отправляются при получении анкетой одного из следующих статусов:
- filled
- returned
- declined
- approved
- completed
Отправка вебхуков
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2,GLB_MKPT Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
id required | number (QstIdResponse) Example: "123" ID анкеты |
status required | string (QstCompletedStatusResponse) Enum: "created" "filled" "edited" "review" "returned" "declined" "approved" "printed" "exported" "imported" "completed" "removed" Example: "completed" Статус анкеты |
required | object Информация о продавце |
Array of objects Аккаунты, созданные по этой анкете |
Responses
Request samples
- Payload
[- {
- "id": 123,
- "status": "completed",
- "seller": {
- "name": "ООО Ромашка",
- "type": "org",
- "inn": 1234567890
}, - "accounts": [
- {
- "merchantCode": "romash11",
- "secretKey": "SECRET_KEY"
}
]
}
]
Специализированное API для управление пользователями, ролями и привилегиями включает следующие модули:
- user-api-privileges - получение списка привилегий
- user-api-users - просмотр пользователей мерчанта, создание/редактирование пользователя с привязкой ролей
- user-api-roles - просмотр ролей мерчанта, создание/редактирование ролей с привязкой привилегий
Получение списка привилегий
Получение списка доступных привилегий сгруппированных по наименовнию доступных групп.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments. |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "privilege": {
- "groupName": {
- "privilegeName": "Account access"
}
}
}
Получение списка ролей
Получение списка ролей.
Authorizations:
query Parameters
merchants | string Enum: "PAYU_3,CCITEST,PAYU_2,NONAME,CC1" "all" Example: merchants=PAYU_3,CCITEST,PAYU_2,NONAME,CC1 Коды мерчантов через запятую или all (допускается только один из варинатов). |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "roles": [
- {
- "merchant": "PAYU_2",
- "roleName": "role_name",
- "roleDescription": "Role Description",
- "roleID": 1,
- "privilege": {
- "groupName": {
- "privilegeName": true
}
}
}
]
}
Создание роли с привилегиями
Создание роли для мерчанта с назначением привилегий.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
roleName required | string Example: "role_name" Кодовое имя роли. |
roleDescription required | string Example: "Role Description" Описание роли. |
merchant | string Example: "PAYU_2" Код мерчанта. |
required | object (UsersApiPrivilege) |
Responses
Request samples
- Payload
Роль с указанными привилегиями будет создана для мерчанта, код которого передан в заголовке.
{- "roleName": "name1",
- "roleDescription": "roleDescription1",
- "privilege": {
- "account": {
- "additionalFields": true,
- "editAccount": false
}, - "products": {
- "manageProducts": true,
- "productDelivery": false
}
}
}
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "status": "created",
- "roles": [
- {
- "merchantCode": "CLIENT_CODE",
- "roleID": "roleID1"
}
]
}
Изменение роли с привилегиями
Изменение роли для мерчанта с назначением привилегий.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
roleName required | string Example: "role_name" Кодовое имя роли. |
roleDescription required | string Example: "Role Description" Описание роли. |
merchant required | string Example: "PAYU_2" Код мерчанта. |
required | object (UsersApiPrivilege) |
Responses
Request samples
- Payload
Для мерчанта будут установлены значения основных параметров. Привилегии роли с 'roleID' будут заменена на указанные.
{- "roleName": "name1",
- "roleDescription": "roleDescription1",
- "merchant": "merchantCode1",
- "roleID": "roleID1",
- "privilege": {
- "account": {
- "additionalFields": true,
- "editAccount": false
}, - "products": {
- "manageProducts": true,
- "productDelivery": false
}
}
}
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "status": "update",
- "roleID": "roleID1"
}
Получение списка пользователей
Получение списка пользователей
Authorizations:
query Parameters
merchants | string Enum: "PAYU_3,CCITEST,PAYU_2,NONAME,CC1" "all" Example: merchants=PAYU_3,CCITEST,PAYU_2,NONAME,CC1 Коды мерчантов через запятую или all (допускается только один из варинатов) |
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Responses
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "users": [
- {
- "firstName": "First Name",
- "lastName": "Last Name",
- "emailUser": "user@email.tst",
- "userID": "1",
- "type": "REGULAR",
- "status": "Enabled",
- "role": [
- {
- "merchantCode": "CLIENT_CODE",
- "roleID": "roleID1"
}
]
}
]
}
Создание пользователя с назначением ролей мерчантам
Создание пользователя с назначением ролей мерчантам.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
firstName required | string Example: "First Name" Имя пользователя. |
lastName required | string Example: "Last Name" Фамилия пользователя. |
emailUser required | string Example: "user@email.tst" Адрес электронной почты. |
status required | string Example: "Enabled" Статус пользователя. |
password required | string Example: "$Erty#ghhh678%~4" Пароль пользователя. |
Array of objects (UsersApiRole) |
Responses
Request samples
- Payload
Будет создан пользователь без назначенных мерчантам ролей.
{- "firstName": "firstName1",
- "lastName": "lastName1",
- "emailUser": "email1@test.tst",
- "status": "enable",
- "password": "$Erty#ghhh678%~4"
}
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "status": "created",
- "userID": "userID1"
}
Изменение пользователя с изменением назначенных мерчантам ролей
Изменение пользователя с изменением назначенных мерчантам ролей.
Authorizations:
header Parameters
X-Header-Signature required | string Example: 0b9b07bd4b81375d189bbe0fe23a7c4b939b112715c2ac090829ed2182752c1c Подпись запроса |
X-Header-Merchant required | string Example: MERCH_V2 Идентификатор продавца в системе YourPayments |
X-Header-Date required | any <ISO_8601> Дата запроса в формате ISO_8601 Y-m-d\TH:i:sP |
Request Body schema: application/jsonrequired
firstName | string Example: "First Name" Имя пользователя. |
lastName | string Example: "Last Name" Фамилия пользователя. |
emailUser | string Example: "user@email.tst" Адрес электронной почты. |
password | string Example: "$Erty#ghhh678%~4" Пароль пользователя. |
userID required | string Example: "1" Идентификатор пользователя. |
status required | string Example: "Enabled" Статус пользователя. |
Array of objects (UsersApiRole) |
Responses
Request samples
- Payload
Минимально необходимый набор атрибутов для изменения пользователя 'userID1'.
{- "userID": "userID1",
- "status": "enable"
}
Response samples
- 200
- 400
- 401
- 5XX
{- "code": 200,
- "status": "updated",
- "userID": "userID1"
}