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

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

Attention. Это старая версия API. Переходите на API Яндекс.Кассы.
https://money.yandex.ru/eshop.xml

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

ПараметрТипОграничениеОписание
Обязательные параметры

shopId

long

Идентификатор магазина, выдается при подключении к Яндекс.Кассе.

scid

long

Номер витрины магазина, выдается при подключении к Яндекс.Кассе.

sum

CurrencyAmount

Сумма заказа.

customerNumber

normalizedString

128 символов

Идентификатор плательщика в системе магазина. В качестве идентификатора может использоваться номер договора плательщика, логин плательщика и т. п.

Возможна повторная оплата по одному и тому же идентификатору плательщика.

Необязательные параметры

orderNumber

normalizedString

64 символа

Уникальный номер в системе магазина. Уникальность контролируется Яндекс.Кассой в сочетании с параметром shopId.

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

shopArticleIdlong

Идентификатор товара, выдается при подключении к Яндекс.Кассе . Применяется, если магазин использует несколько платежных форм для разных товаров.

shopSuccessURL

string, URL path

250 символов

URL, на который будет вести ссылка Вернуться в магазин со страницы успешного платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне Яндекс.Кассы (по запросу у менеджера).

shopFailURL

string, URL path

250 символов

URL, на который будет вести ссылка Вернуться в магазин со страницы ошибки платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне Яндекс.Кассы (по запросу у менеджера).

cps_email

string

100 символов

Адрес электронной почты плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа ).

Допустимо передавать только адрес электронной почты (проверяется соответствие).

cps_phone

string

15 символов, только цифры

Номер мобильного телефона плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа). Номер телефона используется при оплате наличными через терминалы.

paymentType

normalizedString5 символов

Способ оплаты. Р екомендуем передавать в этом поле пустое значение, в этом случае выбор способа оплаты будет происходить на стороне Яндекс.Кассы.

Примеры:

  • PC — оплата из кошелька в Яндекс.Деньгах;
  • AC —ß оплата с произвольной банковской карты.

Полный список значений

Restriction.

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

custNamestringФИО плательщика
custAddrstringАдрес доставки товара или адрес проживания плательщика
custEmailstringАдрес электронной почты плательщика, только для отправки в email-уведомлениях
orderDetailsstringДетали заказа: список приобретенных товаров, их количество, назначение платежа и т. п.
ym_merchant_receiptstring

Данные для формирования чека в формате JSON.

Параметр передается и является обязательным, если вы настроили взаимодействие со своей онлайн-кассой через Яндекс.Кассу и передаете в платежной форме данные для формирования чека.

См. Параметры для формирования чека

ПараметрТипОграничениеОписание
Обязательные параметры

shopId

long

Идентификатор магазина, выдается при подключении к Яндекс.Кассе.

scid

long

Номер витрины магазина, выдается при подключении к Яндекс.Кассе.

sum

CurrencyAmount

Сумма заказа.

customerNumber

normalizedString

128 символов

Идентификатор плательщика в системе магазина. В качестве идентификатора может использоваться номер договора плательщика, логин плательщика и т. п.

Возможна повторная оплата по одному и тому же идентификатору плательщика.

Необязательные параметры

orderNumber

normalizedString

64 символа

Уникальный номер в системе магазина. Уникальность контролируется Яндекс.Кассой в сочетании с параметром shopId.

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

shopArticleIdlong

Идентификатор товара, выдается при подключении к Яндекс.Кассе . Применяется, если магазин использует несколько платежных форм для разных товаров.

shopSuccessURL

string, URL path

250 символов

URL, на который будет вести ссылка Вернуться в магазин со страницы успешного платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне Яндекс.Кассы (по запросу у менеджера).

shopFailURL

string, URL path

250 символов

URL, на который будет вести ссылка Вернуться в магазин со страницы ошибки платежа. Чтобы этот параметр обрабатывался, необходимо включить обработку динамических URL на стороне Яндекс.Кассы (по запросу у менеджера).

cps_email

string

100 символов

Адрес электронной почты плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа ).

Допустимо передавать только адрес электронной почты (проверяется соответствие).

cps_phone

string

15 символов, только цифры

Номер мобильного телефона плательщика. Если он передан, то соответствующее поле на странице подтверждения платежа будет предзаполнено (шаг 3 на схеме платежа). Номер телефона используется при оплате наличными через терминалы.

paymentType

normalizedString5 символов

Способ оплаты. Р екомендуем передавать в этом поле пустое значение, в этом случае выбор способа оплаты будет происходить на стороне Яндекс.Кассы.

Примеры:

  • PC — оплата из кошелька в Яндекс.Деньгах;
  • AC —ß оплата с произвольной банковской карты.

Полный список значений

Restriction.

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

custNamestringФИО плательщика
custAddrstringАдрес доставки товара или адрес проживания плательщика
custEmailstringАдрес электронной почты плательщика, только для отправки в email-уведомлениях
orderDetailsstringДетали заказа: список приобретенных товаров, их количество, назначение платежа и т. п.
ym_merchant_receiptstring

Данные для формирования чека в формате JSON.

Параметр передается и является обязательным, если вы настроили взаимодействие со своей онлайн-кассой через Яндекс.Кассу и передаете в платежной форме данные для формирования чека.

См. Параметры для формирования чека

Примеры

Пример платежной формы
<form action="https://money.yandex.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>
Note.

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

Там же есть пример email-уведомления.

Смотрите также

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

Тестирование оплаты