Адрес для отправки формы
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>