Форма для Email-уведомлений

Это старая версия API. Переходите на API ЮKassa.

Параметры платежной формы

Адрес для отправки формы

https://yoomoney.ru/eshop.xml

Параметры формы

Параметр	Тип	Описание
Обязательные параметры
shopId	long	Идентификатор магазина, выдается при подключении к ЮKassa.
scid	long	Номер витрины магазина, выдается при подключении к ЮKassa.
sum	CurrencyAmount	Сумма заказа.
customerNumber	normalizedString, 128 символов	Идентификатор плательщика в системе магазина. В качестве идентификатора может использоваться номер договора плательщика, логин плательщика и т. п. Возможна повторная оплата по одному и тому же идентификатору плательщика.
Необязательные параметры
orderNumber	normalizedString, 64 символа	Уникальный номер в системе магазина. Уникальность контролируется ЮKassa в сочетании с параметром `shopId`. Если платеж с таким номер заказа уже был успешно проведен, то повторные попытки оплаты будут отвергнуты ЮKassa.
shopArticleId	long	Идентификатор товара, выдается при подключении к ЮKassa. Применяется, если магазин использует несколько платежных форм для разных товаров.
shopSuccessURL	string, URL path, 250 символов	URL, на который будет вести ссылка Вернуться в магазин со страницы успешного платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне ЮKassa (по запросу у менеджера).
shopFailURL	string, URL path, 250 символов	URL, на который будет вести ссылка Вернуться в магазин со страницы ошибки платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне ЮKassa (по запросу у менеджера).
cps_email	string, 100 символов	Адрес электронной почты плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа). Допустимо передавать только адрес электронной почты (проверяется соответствие).
cps_phone	string, 15 символов, только цифры	Номер мобильного телефона плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа). Номер телефона используется при оплате наличными через терминалы.
paymentType	normalizedString, 5 символов	Способ оплаты. Рекомендуем передавать в этом поле пустое значение, в этом случае выбор способа оплаты будет происходить на стороне ЮKassa. Примеры: `PC` — оплата из кошелька ЮMoney; `AC` — оплата с произвольной банковской карты или через Mir Pay (при оплате с мобильного устройства на Android). Полный список значений Если в платежной форме указан способ оплаты, который не разрешен для магазина, плательщик не сможет совершить платеж.
custName	string	ФИО плательщика
custAddr	string	Адрес доставки товара или адрес проживания плательщика
custEmail	string	Адрес электронной почты плательщика, только для отправки в email-уведомлениях
orderDetails	string	Детали заказа: список приобретенных товаров, их количество, назначение платежа и т. п.
ym_merchant_receipt	string	Данные для формирования чека в формате JSON. Параметр передается и является обязательным, если вы настроили взаимодействие со своей онлайн-кассой через ЮKassa и передаете в платежной форме данные для формирования чека. См. Параметры для формирования чека
topped_up_phone	string, до 15 символов, только цифры	Только для тех, кто пополняет баланс телефона (МСС 4814) Номер телефона для пополнения. Пример: `79110000000`. Обязательный параметр, если оплата с банковской карты (`paymentType="AC"`), из кошелька ЮMoney (`paymentType="PC"`) или если выбор способа оплаты на стороне ЮKassa (`paymentType=""`).

Соответствие параметров платежной формы и полей из уведомления о платеже можно посмотреть на странице Email-уведомления о переводах. Там же есть пример email-уведомления.

Примеры

Пример платежной формы

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>

Пример платежной формы при пополнении баланса телефона

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="paymentType" value="AC" type="hidden"/>
    <input name="orderNumber" value="abc1111111" type="hidden"/>
    <input name="cps_phone" value="79110000000" type="hidden"/>
    <input name="cps_email" value="user@domain.com" type="hidden"/>
    <input required name="topped_up_phone" value="79000000000" type="hidden">
    <input type="submit" value="Заплатить"/>
</form>

Что почитать еще

Email-уведомления о переводах Тестирование оплаты