Адрес для отправки формы
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. Примеры:
|
| custName | string | ФИО плательщика |
| custAddr | string | Адрес доставки товара или адрес проживания плательщика |
| custEmail | string | Адрес электронной почты плательщика, только для отправки в email-уведомлениях |
| orderDetails | string | Детали заказа: список приобретенных товаров, их количество, назначение платежа и т. п. |
| ym_merchant_receipt | string | Данные для формирования чека в формате JSON. Параметр передается и является обязательным, если вы настроили взаимодействие со своей онлайн-кассой через ЮKassa и передаете в платежной форме данные для формирования чека. |
Пример платежной формы
<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>