Old versions of the API
Help
Sign up for YooMoney
Электронный сертификат
Прием платежей по электронному сертификату, привязанному к карте «Мир».
Особенности
  • Тип способа оплаты в API: electronic_certificate
  • Сценарий подтверждения: Redirect
  • Срок оплаты: 1 час
  • Холдирование: нельзя платить в две стадии
  • Код в реестре: EC
  • Возврат: да, полный и частичный, есть особенности
  • Срок возврата: на электронный сертификат — от 1 до 3 дней, есть особенности; при доплате с банковской карты — от 0 до 3 дней (зависит от эмитента)
  • Автоплатежи: нет
  • Лимиты: минимальный размер платежа — 1 рубль, максимальный — 350 000 рублей, максимальная сумма платежей в месяц — 700 000 рублей; лимиты можно увеличить через менеджера
Сценарии интеграции
Самостоятельная интеграция:
О способе оплаты
Электронный сертификат — один из способов получения отдельных видов товаров, работ и услуг (ТРУ) для людей, которые получают социальную поддержку от государства. Например, по электронному сертификату можно приобрести технические средства реабилитации (ТСР).
Электронный сертификат — это запись в электронном реестре Государственной информационной системы электронных сертификатов (ГИС ЭС). Она содержит сведения о товарах, работах и услугах, которые можно приобрести по этому сертификату, предельную сумму и сроки действия сертификата и другие данные. Эта запись привязывается к карте «Мир» любого российского банка.
По электронному сертификату можно самостоятельно приобрести товары или оплатить часть их стоимости в магазинах. Потратить деньги можно только на то, что указано в сертификате.
При проведении платежей и возвратов использование сертификата предварительно одобряется во Фронт-офисе Электронных Сертификатов Национальной системы платежных карт (ФЭС НСПК).
Как это работает
Подготовка
Вы в своей системе определяете перечень товаров (ТРУ), которые можно оплатить по электронному сертификату. Каждому товару нужно присвоить специальный код (полный код товара, согласованный с перечнем ТРУ).
Проведение платежа
Пользователь при покупке формирует корзину заказа. В ней могут быть товары, которые можно оплатить по сертификату, и другие товары, которые нужно оплатить картой. Вы формируете корзину покупки (в терминах ФЭС НСПК) — выбираете из заказа только те товары, которые можно оплатить по сертификату.
Формирование корзины покупки
При оплате пользователь указывает банковскую карту «Мир», к которой привязан сертификат. Карту и состав корзины покупки нужно передать в ФЭС НСПК. Кто это делает — ЮKassa или вы — зависит от вашего варианта интеграции с ЮKassa.
ФЭС НСПК одобряет корзину — отмечает, какие товары и на какую сумму можно компенсировать по сертификату.
Одобрение корзины в ФЭС НСПК
После этого ЮKassa проводит платеж: одобренную сумму списывает с сертификата, а оставшуюся — с банковской карты.
Оплата покупки
Проведение возврата
Доступны полные и частичные возвраты. Вернуть можно как товары, оплата которых была по электронному сертификату, так и товары с оплатой по карте.
Особенности возвратов
  • Если оплата товаров была по сертификату, вернуть деньги можно только на него.
  • Если оплата товаров была частично по сертификату, частично по банковской карте, то сначала деньги возвращаются на сертификат, и если всё прошло успешно, то оставшаяся часть суммы возвращается на карту. Если при возврате на сертификат что-то пошло не так, вся операция отменяется, нужно повторять заново.
  • Если возвращаются те товары из корзины, которые оплачивались банковской картой, то допускается сделать возврат на ту же карту, но на сумму не больше суммы доплаты. Иначе возврат не пройдет.

То, что списали с электронного сертификата, можно вернуть только на сертификат. Любые другие способы нарушают законодательство РФ.

Особенности возвратов
Срок возврата
Срок возврата денег на электронный сертификат зависит от ГИС ЭС: сертификат снова станет активным после обработки операции в системе. В среднем эта процедура занимает от одного до трех дней. Если деньги не вернулись за это время, пользователю нужно обратиться в тот орган, который выдал электронный сертификат.
Если была оплата с банковской карты, то сроки фактического зачисления денег зависят от эмитента. Обычно деньги возвращаются в течение трех дней.
Отправка чеков в налоговую
При оплате по электронным сертификатам данные сформированных чеков нужно передавать не только в налоговую, но и в НСПК. Это касается всех чеков: чеков прихода, чеков возврата прихода, чеков коррекции и т.д.
Как передать чек в НСПК
Ваши действия зависят от того, как вы формируете чеки — через ЮKassa или самостоятельно:
  • Если вы передаете данные для чеков через ЮKassa, они отправятся в НСПК автоматически. Убедитесь в личном кабинете ЮKassa, что чек доставлен в НСПК. Если что-то пошло не так, передайте данные повторно в личном кабинете.
  • Если вы отправляете данные для чеков самостоятельно (не через ЮKassa), подайте данные о сформированных чеках в личном кабинете ЮKassa. Убедитесь, что чек доставлен в НСПК. Если что-то пошло не так, передайте данные повторно.

Подать данные о чеке и узнать статус доставки чека в НСПК можно только в личном кабинете ЮKassa в истории платежей.

Отправка чеков в НСПК
Подключение способа оплаты

Чтобы принимать оплату по электронным сертификатам, вам нужно зарегистрироваться в ГИС ЭС и личном кабинете (ЛК) ФЭС НСПК. Подробные актуальные инструкции — на сайте НСПК.

Шаг 1. Проверьте, что вы можете подключить этот способ оплаты
Шаг 2. Выберите вариант интеграции с ЮKassa
Выберите подходящий вам вариант интеграции:
Шаг 3. Подготовьтесь к интеграции
  1. Подготовьте данные о товарах, которые можно оплачивать по электронному сертификату (название, код в вашей системе, полный код по Перечню ТРУ).
  2. Если выбрали оплату со сбором данных на вашей стороне, заполните Лист самооценки SAQ D (PCI DSS).
Шаг 4. Зарегистрируйтесь в ГИС ЭС
Зарегистрируйтесь в Подсистеме обеспечения информационной безопасности Казначейства России. Добавьте сотрудников, наделите их необходимыми ролями и полномочиями. Добавьте ваше предприятие и список товаров для оплаты по сертификату. Отправьте на активацию в ЛК ФЭС НСПК.
Шаг 5. Зарегистрируйтесь в ЛК ФЭС НСПК
Ссылка для регистрации в ЛК ФЭС НСПК придет на почту после регистрации в ГИС ЭС.
Шаг 6. Выберите вендора и получите данные для интеграции
В ЛК ФЭС НСПК добавьте кассу для вашего предприятия. Подробнее в инструкциях на сайте НСПК
При добавлении кассы выберите вендора:
Получите ID кассы, MAC KEY и API KEY.
Шаг 7. Проинтегрируйтесь с ЮKassa
  1. Зарегистрируйтесь в ЮKassa (при необходимости).
  2. Сообщите менеджеру ЮKassa, что хотите принимать оплату по электронным сертификатам.
  3. Если выбрали оплату на готовой странице ЮKassa, передайте менеджеру ID кассы, MAC KEY и API KEY, которые вы получили в ЛК ФЭС НСПК.
  4. Проинтегрируйтесь по инструкциям в зависимости от вашего вариант интеграции с ЮKassa:
Шаг 8. Активируйте ваше предприятие в ГИС ЭС
В ГИС ЭС активируйте ваше предприятие. Подробнее в инструкциях на сайте НСПК
Готово! Можно принимать платежи от реальных пользователей.
Подготовка данных о товарах
При проведении платежей и возвратов необходимо одобрять в ФЭС НСПК использование электронного сертификата и возврат на него. Для этого нужны определенные сведения о товаре: полный код товара по Перечню ТРУ (код ТРУ), название и код товара в вашей системе.
Когда и как нужно передавать эти данные:
  • Для оплаты на готовой странице ЮKassa — в объекте articles в запросах к ЮKassa на создание платежа и на создание возврата.
  • Для оплаты со сбором данных на вашей стороне — в запросах к ФЭС НСПК на предварительное одобрение использование сертификата и на предварительное одобрение возврата.
Полный код товара по Перечню ТРУ (код ТРУ)
Полный код товара нужен для одобрения платежа или возврата в ФЭС НСПК. Код товара состоит из кода вида ТРУ, кода производителя, кода модели и кода страны производителя.
Полный код товара по Перечню ТРУ
Чтобы сформировать код для ТРУ, изучите Каталог технических средств реабилитации. Дальнейшие действия зависят от того, есть в каталоге нужный товар или его нет.
В каталоге есть нужный товар
Скопируйте код ТРУ и приведите его к формату: NNNNNNNNN.NNNNNNNNNYYYYMMMMZZZ.
Пример:
  • код из каталога: 329921120.060010102.0008.0001.643
  • код для проведения платежа (остается только первая точка): 329921120.06001010200080001643
Готово! Используйте этот код при проведении платежей и возвратов.
В каталоге нет нужного товара
Сформируйте код самостоятельно. Для этого:
Шаг 2. Скопируйте код вида ТРУ из Перечня.
Пример: 329921120.060010102
Шаг 3. Добавьте код производителя в формате YYYY. Если неизвестен, добавьте ноли: 0000.
Примеры:
  • Код известен: 329921120.0600101020008
  • Неизвестен: 329921120.0600101020000
Шаг 4. Добавьте код модели в формате MMMM. Если неизвестен, добавьте ноли: 0000.
Примеры:
  • Код известен: 329921120.06001010200080001
  • Неизвестен: 329921120.06001010200000000
Шаг 5. Добавьте цифровой код страны производителя по Общероссийскому классификатор стран мира (ОКСМ, OK (MK (ИСО 3166) 004-97) 025—2001) в формате ZZZ. Если неизвестен, добавьте ноли: 000.
Примеры:
  • Код известен: 329921120.06001010200080001643
  • Неизвестен: 329921120.06001010200000000000
Готово! Используйте этот код при проведении платежей и возвратов.
Код товара в вашей системе
Этот код товара нужен, чтобы одобрить платеж или возврат в ФЭС НСПК. Требования к формату приведены в Справочнике API .
Название товара в вашей системе
Если для оплаты используете готовую страницу ЮKassa, это название отобразится на платежной форме при проведении платежа. Требования к формату приведены в Справочнике API .
See also
Информация о проекте на сайте НСПК