Подключение эквайринга ЮKassa

Подключение идёт в два захода: сначала магазин заводится в ЮKassa, потом вы переносите её ключи в настройки Позитив CRM и вписываете обратно в ЮKassa адрес, по которому она сообщит об оплате.

Настраивается это в разделе «Настройки» -> «Приём оплат», у владельца и совладельца.

Что нужно до начала

Магазин в ЮKassa, прошедший проверку.
Статус ИП, юридического лица или самозанятого. Самозанятому нужен идентифицированный кошелёк ЮMoney.
Заведённый вариант приёма оплат со способом «Интернет-эквайринг».

Сначала - подключение в ЮKassa

Оставьте заявку на приём платежей: yookassa.ru. Там же смотрите тарифы и комиссию - они не наши, и мы на них не влияем.
Дождитесь проверки магазина. До неё ключи выдают тестовые: платежи по ним настоящие по всем правилам, но денег не двигают.
Откройте раздел «Интеграция» и найдите страницу с ключами магазина. Возьмите оттуда идентификатор магазина (он же shopId) и секретный ключ.
Включите нужные способы оплаты. Что предложат плательщику на странице оплаты - карту, QR-код СБП, кошелёк, - решают настройки вашего магазина: CRM они не видны и он их не выбирает.

Что заполнить в Позитив CRM

Откройте вариант приёма оплат и выберите способ «Интернет-эквайринг».

«Получатель» - в чью пользу идёт платёж. Эту строку увидит плательщик в кабинете.
«Через какой сервис» - выберите «ЮKassa».
«Идентификатор магазина» и «Секретный ключ» - со страницы ключей в разделе «Интеграция». Секретный ключ хранится зашифрованным; сохранённый виден тем же, кому открыт этот раздел, - глазок в поле снимает маску.

Полей ключей у нового варианта сначала нет: сохраните вариант со способом «Интернет-эквайринг», и они появятся вместе с кнопками проверки.

Адрес для уведомлений - обязательный шаг

ЮKassa сообщает об оплате по адресу, который вы указываете у себя в кабинете. Пока адрес не вписан, оплата пройдёт, деньги спишутся, а абонемент у ученика не появится.

Скопируйте адрес из поля «Адрес для уведомлений» кнопкой справа от него.
В кабинете ЮKassa откройте раздел «Интеграция», страницу с уведомлениями, и вставьте его туда.
Включите там же события, перечисленные в этом же блоке: payment.succeeded, payment.canceled, payment.waiting_for_capture и refund.succeeded.

Две кнопки проверки, и нужны обе

«Проверить ключи» стоит под полями и отвечает на вопрос, приняла ли их ЮKassa. Платежа при этом не создаётся вовсе. Если ключи не подошли, ответ CRM показывается вам целиком. Пока изменения в полях не сохранены, кнопка не нажимается: проверяются сохранённые ключи, и ответ был бы про прежние. После успеха кнопка становится «Ключи проверены»; отметка сбрасывается сменой ключей или CRM.
«Тестовый платёж» открывает настоящую страницу оплаты на один рубль - ту же, что увидит ученик. Пройдите её до конца.

Вторая кнопка здесь важнее первой: только оплаченный рубль показывает, что адрес для уведомлений вписан верно. Проверка ключей об этом не говорит ничего - она не обращается к настройкам уведомлений вовсе. Тем же рублём проверяется и касса: если в поле «Кассовый чек» выбрана касса, подключённая в кабинете ЮKassa, она пробьёт настоящий чек и пришлёт его на вашу почту.

Сумма одна, а исход зависит от того, чьи ключи сохранены:

тестовые (test_) - оплата бесплатна, реквизиты тестовых карт ЮKassa даёт в своей документации;
боевые (live_) - рубль списывается по-настоящему, вернуть его можно в кабинете ЮKassa.

Пока тестовый платёж не прошёл, в блоке висит предупреждение. После него появляется отметка «Подключено» с датой полученного уведомления - вот с этого момента приём оплат действительно работает.

Если оплата прошла, а абонемента нет

Проверьте по порядку:

Вписан ли адрес для уведомлений в кабинете ЮKassa и включены ли перечисленные события.
Прошёл ли тестовый платёж - есть ли отметка «Подключено».
Тип платежей у магазина - одностадийный, деньги списываются сразу. На двухстадийном они сначала только замораживаются, и абонемент не оформится, пока списание не подтверждено.

Оплата, о которой уведомление не дошло, доводится сама: CRM перепроверяет её у ЮKassa. Если абонемент не появился и через несколько минут, напишите нам из формы поддержки.

Что дальше

Онлайн-касса и чеки - когда нужна касса и что попадает в чек.
Оплата на странице банка - что видит ученик и какой абонемент получится.
Заявки на оплату - где смотреть прошедшие оплаты и как вернуть деньги.