Email-протокол: простое подключение

Простой способ подключения: возьмите готовый код формы с этой страницы и подставьте в него параметры, которые получили при подключении. Разместите готовый код на сайте — вам понадобится минимальное знание HTML.

Сообщения о платежах приходят по электронной почте, которую вы указали при подключении. О каждом успешном платеже приходит отдельное письмо.

Возможности

Способы приема платежей: все, кроме кредитования.

Недоступны дополнительные опции: автоплатежи, привязка карты и предавторизация. Зато из личного кабинета можно выставлять счета клиентам по электронной почте.

Как включить

Шаг 1. Заполните заявку

Заполните заявку на подключение Кассы — у вас появится личный кабинет.

Шаг 2. Выберите способ подключения

  1. Зайдите в личный кабинет, во вкладке Настройки нажмите Заполнить.
  2. Выберите способ подключения Email-протокол и нажмите Продолжить.
  3. Укажите адрес, на который хотите получать сообщения об успешных платежах.
  4. Нажмите Отправить.

Вам придет письмо с параметрами для работы с платежами — shopId и scid.

Шаг 3. Создайте платежную форму

1. Возьмите наш образец формы.

<!-- Пример заголовков на странице оплаты, которые вы можете показать пользователю -->
    <h1>Название товара</h1>
    <div>Цена: 1 руб.</div><hr>
     
<!-- Платежная форма
     Эти поля обязательные, их нельзя удалять. -->
    <form action="https://money.yandex.ru/eshop.xml" method="post">
    <input name="shopId" value="впишите-сюда-значение-своего-shopId" type="hidden" required/>
    <input name="scid" value="впишите-сюда-значение-своего-scid" type="hidden" required/>
    К оплате<br>
    <input name="sum" value="" type="number" min="1" placeholder="0.0" required><br><br>
     
<!-- Поле name="customerNumber" обязательное, его нельзя удалять.
     По нему вы сможете понять, кто вам заплатил.
     Вы можете назвать это поле как угодно. Например, вместо "Имя покупателя" написать
     "Идентификатор плательщика", "Номер клиента", "Имя клиента" или "Номер заказа". -->
     Имя покупателя<br>
     <input required name="customerNumber" value="" size="64"/><br><br>
 
<!-- Эти поля можно убрать или переименовать.
     Например, вместо "Телефон покупателя" написать "Цвет глаз" или "Номер автомобиля".  -->
     Телефон покупателя<br>  
     <input name="custName" value="" size="64"/><br><br>
     Адрес доставки<br>  
     <input name="custAddr" value="" size="64"/><br><br>
     Эл. почта покупателя<br>   
     <input name="custEmail" value="" size="64"/><br><br>
     Комментарии к заказу<br>   
     <textarea name="orderDetails" value="" rows="5" cols="64" wrap="soft"></textarea><br><br> 
 
<!-- Кнопку "Заплатить" можно назвать как угодно.
     Например, "Оплатить подписку" или "Внести деньги"-->
     <input type="submit" value="Заплатить">
     </form>

Подробнее в документации

Как выглядит форма

2. Подставьте свои параметры.

Вам нужно обязательно поменять shopId (идентификатор вашего магазина) и scid (идентификатор витрины) — запросите их у менеджера или скопируйте в личном кабинете.

Подставьте shopId вместо XXXX:

<input name="shopId" value="XXXX" type="hidden" required/>

Что получится:

<input name="shopId" value="1234567" type="hidden" required/>

Пример готовой формы

<!-- Пример заголовков на странице оплаты, которые вы можете показать пользователю -->
    <h1>Гравицапа</h1>
    <div>Цена: 100 руб.</div><hr>
     
    <form action="https://money.yandex.ru/eshop.xml" method="post">
    <input name="shopId" value="1234567" type="hidden" required/>
    <input name="scid" value="12345" type="hidden" required/>
    К оплате<br>
    <input name="sum" value="" type="number" min="1" placeholder="0.0" required>
     
     Имя покупателя<br>
     <input required name="customerNumber" value="" size="64"/><br><br>
    
     Телефон покупателя<br>  
     <input name="custName" value="" size="64"/><br><br>
 
     Комментарии к заказу<br>   
     <textarea name="orderDetails" value="" rows="5" cols="64" wrap="soft"></textarea><br><br>
 
     <input type="submit" value="Заплатить">
     </form>

От того, какие параметры будут в вашей платежной форме, зависит содержание письма о платеже.

Шаг 4. Разместите форму на сайте

Вставьте код формы на ваш сайт — в исходный код, рядом с товаром или услугой, за которую будете принимать платежи.

Шаг 5. Проведите тестирование

Проверьте, что всё работает: попробуйте заплатить через эту форму.

Для тестовых платежей можно поставить самую маленькую сумму (параметр sum). Главное, чтобы она подходила по ограничениям для вашего способа оплаты. Например, с банковской карты можно заплатить минимум 1 рубль.

Убедитесь, что:

  • платеж проходит без ошибок: вы видите страницу с зеленой галочкой и результатами оплаты,
  • на ваш электронный адрес приходит письмо о платеже.

Письмо о платеже

Письмо приходит после каждого успешного платежа на электронную почту, которую вы указали при подключении. В письме приходят значения параметров из платежной формы:

  • sum и customerNumber — будут обязательно,

  • custName, custAddr, custEmail и orderDetails — если удалить их из кода платежной формы, то в письме эти поля будут пустыми.

От: Yandex.Money Demo Payment Center <paymentcenter@yamoney.ru>
Тема: Yandex.Dengi payment for Название-вашей-организации #56
------------------------------------------------------------------
Извещение № 56
Получатель: Название-вашей-организации
Время платежа: 23.10.2016 18:24:09
Сумма: 1000.00 RUB
Номер транзакции: 2000000942259
Идентификатор клиента: <То, что плательщик напишет в поле customerNumber>
Номер в магазине: 2000000942259
Заполнено плательщиком в платежной форме магазина:
ФИО: <Значение поля custName из платежной формы>
Адрес доставки: <Значение поля custAddr из платежной формы>
Email: <Значение поля custEmail из платежной формы>
Содержание заказа:
<Значение поля orderDetails из платежной формы>
------------------------------------------------------------------------------