API ЮKassa
Помощь
Подключить ЮKassa
Форма для Email-уведомлений
Параметры платежной формы
Адрес для отправки формы
https://yoomoney.ru/eshop.xml
Параметры формы
ПараметрТипОписание
Обязательные параметры
shopIdlongИдентификатор магазина, выдается при подключении к ЮKassa.
scidlongНомер витрины магазина, выдается при подключении к ЮKassa.
sumCurrencyAmountСумма заказа.
customerNumbernormalizedString,
128 символов
Идентификатор плательщика в системе магазина. В качестве идентификатора может использоваться номер договора плательщика, логин плательщика и т. п.
Возможна повторная оплата по одному и тому же идентификатору плательщика.
Необязательные параметры
orderNumbernormalizedString,
64 символа
Уникальный номер в системе магазина. Уникальность контролируется ЮKassa в сочетании с параметром shopId.
Если платеж с таким номер заказа уже был успешно проведен, то повторные попытки оплаты будут отвергнуты ЮKassa.
shopArticleIdlongИдентификатор товара, выдается при подключении к ЮKassa. Применяется, если магазин использует несколько платежных форм для разных товаров.
shopSuccessURLstring, URL path,
250 символов
URL, на который будет вести ссылка Вернуться в магазин со страницы успешного платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне ЮKassa (по запросу у менеджера).
shopFailURLstring, URL path,
250 символов
URL, на который будет вести ссылка Вернуться в магазин со страницы ошибки платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне ЮKassa (по запросу у менеджера).
cps_emailstring,
100 символов
Адрес электронной почты плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа).
Допустимо передавать только адрес электронной почты (проверяется соответствие).
cps_phonestring,
15 символов, только цифры
Номер мобильного телефона плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа). Номер телефона используется при оплате наличными через терминалы.
paymentTypenormalizedString,
5 символов
Способ оплаты. Рекомендуем передавать в этом поле пустое значение, в этом случае выбор способа оплаты будет происходить на стороне ЮKassa.
Примеры:
  • PC — оплата из кошелька ЮMoney;
  • AC — оплата с произвольной банковской карты или через Mir Pay (при оплате с мобильного устройства на Android).
custNamestringФИО плательщика
custAddrstringАдрес доставки товара или адрес проживания плательщика
custEmailstringАдрес электронной почты плательщика, только для отправки в email-уведомлениях
orderDetailsstringДетали заказа: список приобретенных товаров, их количество, назначение платежа и т. п.
ym_merchant_receiptstring
Данные для формирования чека в формате JSON.
Параметр передается и является обязательным, если вы настроили взаимодействие со своей онлайн-кассой через ЮKassa и передаете в платежной форме данные для формирования чека.
Примеры
Пример платежной формы
HTML
<form action="https://yoomoney.ru/eshop.xml" method="post">
    <input name="shopId" value="1234" type="hidden"/>
    <input name="scid" value="4321" type="hidden"/>
    <input name="sum" value="100.50" type="hidden"/>
    <input name="customerNumber" value="abc000" type="hidden"/>
    <input name="shopArticleId" value="567890" type="hidden"/>
    <input name="paymentType" value="AC" type="hidden"/>
    <input name="orderNumber" value="abc1111111" type="hidden"/>
    <input type="text" name="cps_email" value="user@domain.com" />
    <input type="text" name="cps_phone" value="79009009090" />
    <input name="custName" value="Иванов Петр Сидорович" type="hidden"/>
    <input name="custEmail" value="user@domain.com" type="hidden"/>
    <input name="custAddr" value="Москва, а/я 100" type="hidden"/>
    <input name="orderDetails" value="Счастье для всех. В пакетиках, россыпью." type="hidden"/>
    <input type="submit" value="Заплатить"/>
</form>
Что почитать еще
Email-уведомления о переводахТестирование оплаты