¶ Техническая поддержка
Возникающие вопросы общего характера можно отправлять на адрес merchants@yoomoney.ru, так же можно обратиться по телефону 8(800)250-66-99, доб. 2 (пн-пт 8:00 - 20:00 / сб-вс 10:00 - 19:00). Вопросы по сопровождению b2b_support@yoomoney.ru - тех.поддержка (24/7)
¶ Параметры
- ShopId: Идентификатор магазина. Идентификатор указан в разделе Настройки — Магазин (поле shopId)
- SecretKey: Секретный ключ магазина. Секретный ключ нужно сгенерировать и активировать паролем из смс в разделе Интеграция — Ключи API
- URL
| Название метода | Url-Адрес |
|---|---|
| Url-адрес операции регистрации платежа | https://api.yookassa.ru/v3/payments |
| Url-адрес операции проверки оплаты | https://api.yookassa.ru/v3/payments/{id} |
| Url-адрес операции возврата платежа | https://api.yookassa.ru/v3/payments |
{
"ShopId":"",
"SecretKey":"",
"UrlRefundPayment":"https://api.yookassa.ru/v3/payments",
"UrlConfirmResult":"https://api.yookassa.ru/v3/payments/{id}/capture",
"UrlCancelPayment":"https://api.yookassa.ru/v3/payments/{id}/cancel",
"ApiUrl":"https://api.yookassa.ru/v3/",
"UrlRegisterOrder":"https://api.yookassa.ru/v3/payments",
"UrlPaymentResult":"https://api.yookassa.ru/v3/payments/{id}",
"VatDictionary":null,
"UseTaxSystem":false
}
Здесь VatDictionary - соответствие НДС из Барса и Юкассы.
Коды ставок НДС указаны на сайте Юкассы
В Барс.Администраторе при настройке эквайринга нужно зайти в раздел "Указать соответствие ставок НДС" и напротив используемого налога Барса указать код из Юкассы.
| Код | Ставка НДС |
|---|---|
| 1 | Без НДС |
| 2 | НДС по ставке 0% |
| 3 | НДС по ставке 10% |
| 4 | НДС чека по ставке 20% |
| 5 | НДС чека по расчетной ставке 10/110 |
| 6 | НДС чека по расчетной ставке 20/120 |
| 7 | НДС по ставке 5% |
| 8 | НДС по ставке 7% |
| 9 | НДС по расчетной ставке 5/105 |
| 10 | НДС по расчетной ставке 7/107 |
¶ Фискализация
Есть два сценария фискализации чеков
1. Фискализация чека онлайн кассой, которую ранее подключили к ЮKassa.
Для того, чтобы чеки фискализировались онлайн кассой от ЮKassa, нужно сначала подключить онлайн кассу, затем выставить настройки в веб модуле ЮKassa Настройки-Онлайн касса. Перевести ползунок на параметре "Режим проверки чеков" и выставить галочку на параметре "Принимать платеж" тогда все чеки будут фискализироваться Онлайн кассой и в транзакциях будет соответсвующая пометка
Подробнее
2. Фискализация чека сервисом фискализации.
Для того, чтобы чеки фискализировались сервисом фискализации, нужно подключить сервис фискализации к WebStore, настроить его и проверить что отключен параметр проверки чеков в веб модуле ЮKassa.
¶ Файлы
¶ Возвраты
Экварйнг поддерживает механизм полного и частичного возврата, для платежей с фискализацией и без.
Особенность частичного возврата с фискализацией предполагает указание суммы возврата, кратной сумме одной из позиций в чеке. В таком случае будет осуществлён поиск по первому совпадению суммы позиции в чеке и суммы указанной при возврате.
¶ Агенты
Была поддержана работа с агенской схемой эквайринга Юkassa, для возможности передачи реквизитов поставщика и реквизитов агента в чеке в онлайн кассу ЮKassa.
Для реализации работы по агенской схеме требуется использовать сценарий "Сначала платеж, потом чек", что в более подробной формулировке означает не связывать платеж и чек, отправляя отдельными запросами запрос на создание заказа и запрос на создание чека после платежа.
Для насройки работы по сценарию "Сначала платеж, потом чек" требуется провести подготовительные настройки Системы Барса и эквайринга ЮKassa.
1. Настройки ЮKassa
Требуется перейти в "Настройки", далее "Онлайн-касса" в личном кабинете ЮKassa. Далее требуется включить "Режим проверки чеков" и выбрать на в настройке "Что делать с платежом, если чек не доставлен" параметр "Не связывать платеж и чек". Данная настройка подразумевает под собой что чеки на каждый созданный платеж требуется формировать вручную.
2. Настройки системы Барс
Работа с эквайрингом ЮKassa в системе Барса производится через службу платежей. Для Возможности работать с использованием агенской схемы эквайринга ЮKassa, требуется создать эквайринг (если он не создан) или настроить уже существующий эквайринг на режим работы "Не связывать платеж и чек" на параметре "Режим работы". Таким образом система будет создавать сначала платеж, а затем, после оплаты, создавать чек где будут передаваться реквизиты поставщика.
2. Настройки Барс WebStore
Предварительно должен быть добавлен мерчант "Служба платежей Барс", если этого не сделано, то требуется перейти в личный кабинет WebStore, в раздел "Эквайринг", далее настроить эквайринг по пунктам описанным ниже:
- Добавить мерчант;
- Задать ему идентификатор;
- Указать Url-адрес службы платежей;
- Указать идентификатор эквайринга ЮKassa (можно посмотреть в справочнике добавленных эквайрингов в Барс Администратор);
- Указать таймаут ожидания платежа (в секундах).
Далее требуется перейти в раздел "Фискализация" в личном кабинете WebStore. В настройке "Платежные агенты", указать тип агента. Поддерживаемые типы агентов эквайринга:
- Банковский платежный агент;
- Платежный агент;
- Комиссионер;
- Агент.
Далее требуется указать идентификатор организации Барса, которая будет являться оператором перевода или оператором по приему платежных средств. Требуется указывать идентификатор головной организации (Агента), который можно посмотреть в Барс Администратор, в "Справочнике организаций", отобразив спрятанную колонку "Id".
Для правильной работы агенской схемы требуется выставить в Барс Администратор, на всех товарах организацию к которой они принадлежат, а так же заполнить все реквизиты организации в справочнике организаций.
Для отключения работы по агентской схеме требуется:
- Снять галочки со всех типов агентов в WebStore в разделе "Фискализация";
- Удалить идентификаторы оператора перевода в WebStore в разделе "Фискализация;
- В Барс Администратор, в "Справочник эквайрингов" на эквайринге ЮKassa, выставить режим работы "Платеж и чек одновременно";
- В личном кабинете ЮKassa, в "Настройках", далее "Онлайн-касса", выставить роежим проверки чеков "Принимать платеж", тем самым используя сценарий "Платеж и чек одновременно".
¶ Особенности
ЮKassa умеет перенаправлять пользователя на страницу для оплаты где используется конкретный способ оплаты и перенаправлять пользователя на страницу со списком способов оплаты доступных для магазина. Список доступных способов оплаты для магазина регулируется силами менеджера ЮKassa