Контактные данные технической поддержки ЯПэй в открытой документации не предоставляются.
Для подключения торговой точки, получения токена доступа и решения вопросов по работе эквайринга необходимо обращаться к менеджеру ЯПэй.
ЯПэй — это эквайринг для приема безналичных платежей через Систему быстрых платежей (СБП) с использованием QR-кодов.
Интеграция с системой Барс поддерживает два режима работы:
В обоих режимах поддерживаются:
В этом режиме используется заранее созданная QR-табличка, закрепленная за кассой.
Сценарий работы:
Такой режим подходит для стационарных касс, где QR-код постоянно размещен рядом с кассиром.
В данном режиме QR-код создается отдельно для каждой операции.
Сценарий работы:
Режим рекомендуется использовать для интернет-магазинов, WebStore и мобильных приложений.
При добавлении эквайринга ЯПэй необходимо заполнить основные параметры подключения.
| Параметр | Описание |
|---|---|
| UserToken | Токен торговой точки, предоставляемый ЯПэй |
| Тип QR | Кассовая ссылка или Динамический QR |
| URL регистрации платежа | Адрес создания платежа |
| URL проверки статуса | Адрес проверки состояния операции |
| URL возврата | Адрес выполнения возврата |
| URL отмены | Адрес отмены операции |
| AnswerUrl | Адрес получения уведомлений об оплате |
Базовый адрес API:
https://api.qr.yandex.net/
В зависимости от выбранного режима используются соответствующие методы API.
{
"UserToken": "",
"QrType": "Offline",
"UrlRegisterOrder": "https://api.qr.yandex.net/api/s1/operation/create",
"UrlPaymentResult": "https://api.qr.yandex.net/api/s1/operation/result",
"UrlRefundPayment": "https://api.qr.yandex.net/api/s1/operation/return",
"UrlCancelPayment": "https://api.qr.yandex.net/api/s1/operation/cancel"
}
{
"UserToken": "",
"QrType": "Online",
"UrlRegisterOrder": "https://api.qr.yandex.net/api/so/operation/create",
"UrlPaymentResult": "https://api.qr.yandex.net/api/so/operation/result",
"UrlRefundPayment": "https://api.qr.yandex.net/api/so/operation/return",
"UrlCancelPayment": "https://api.qr.yandex.net/api/so/operation/cancel"
}
Для подключения ЯПэй необходимо:
UserToken.В настройках кассы необходимо:
После этого касса готова к приему платежей через ЯПэй.
Процесс оплаты выглядит следующим образом:
Если покупатель отказался от оплаты до ее завершения, операция может быть отменена.
После успешной отмены платеж считается недействительным и чек не формируется.
Поддерживаются два типа возврата:
Возврат выполняется для уже оплаченной операции.
При частичном возврате сумма возврата не должна превышать сумму исходного платежа.
Статус оплаты определяется автоматически.
Для этого используются:
Пользователю не требуется выполнять эти действия вручную — они выполняются системой автоматически.
sale_token.| Операция | Поддерживается |
|---|---|
| Создание платежа | Да |
| Проверка статуса | Да |
| Отмена платежа | Да |
| Полный возврат | Да |
| Частичный возврат | Да |
| Получение уведомлений (Webhook) | Да |
| Проверка статуса через Polling | Да |
| Работа с кассовыми ссылками | Да |
| Работа с динамическими QR | Да |
UserToken у представителей ЯПэй.https://api.qr.yandex.net/