Форма — это набор полей с информацией о переводе. Форму можно разместить в своем интерфейсе (например, на сайте или в блоге). Когда отправитель нажимает на кнопку, данные формы отправляются в ЮMoney и инициируют распоряжение на перевод в ваш кошелек.
Метод отправки формы:
POST
Адрес для отправки формы
https://yoomoney.ru/quickpay/confirm.xml
| Параметр | Тип | Описание |
|---|---|---|
| Обязательные параметры | ||
| receiver | string | Номер кошелька ЮMoney, на который нужно зачислять деньги отправителей. |
| quickpay-form | string | Возможные значения:
|
| targets | string До 150 символов | Назначение платежа. |
| paymentType | string | Способ оплаты. Возможные значения:
|
| sum | CurrencyAmount | Сумма перевода (спишется с отправителя). |
| Необязательные параметры | ||
| formcomment | string До 50 символов | Название перевода в истории отправителя (для переводов из кошелька или с привязанной карты). Отображается в кошельке отправителя. Удобнее всего формировать его из названий магазина и товара. Например: Мой магазин: валенки белые |
| short-dest | string | Название перевода на странице подтверждения. Рекомендуем делать его таким же, как formcomment . |
| label | string До 64 символов | Метка, которую сайт или приложение присваивает конкретному переводу. Например, в качестве метки можно указывать код или идентификатор заказа. |
| successURL | string, URL path | URL-адрес для редиректа после совершения перевода. |
| need-fio | boolean | Нужны ФИО отправителя. |
| need-email | boolean | Нужна электронная почты отправителя. |
| need-phone | boolean | Нужен телефон отправителя. |
| need-address | boolean | Нужен адрес отправителя. |
О запросе контактных данных
- Лучше запрашивать контактные данные, только если они действительно необходимы (чтобы отправителю не пришлось заполнять лишние поля).
- Если в одних ситуациях контакты нужны, а в других — нет, вы можете изменять значение параметра (value="true"— запрашивать,value="false"— не запрашивать).
Рассчитать комиссию — например, чтобы показать пользователю до перевода — можно с помощью коэффициента по формуле с использованием этих параметров:
- amount_due— сумма к получению;
- sum— сумма к списанию;
- a— коэффициент комиссии.
Параметры
amount_due
и a
никуда не передаются: они используются только для расчетов. Параметр sum
передаете ЮMoney в форме.| Способ оплаты | Коэффициент комиссии (a) | Откуда комиссия | Формула для расчета | Пример |
|---|---|---|---|---|
| Кошелек ЮMoney PC | 0,005 | с получателя, от суммы к получению | amount_due = sum — sum * (a / (1 + a)) | Отправитель переводит 1000 рублей из кошелька, на счет получателя поступят 995 рублей 2 копейки. |
| Банковская карта AC | 0,02 | с получателя, от суммы к списанию | amount_due = sum * (1 — a) | Отправитель переводит 1000 рублей с карты, на счет получателя поступят 980 рублей. |
| Баланс телефона MC | Комиссия с отправителя, зависит от оператора мобильной связи | |||
Краудфандер Энтони Старк с помощью формы собирает деньги на свой проект.
- Название проекта: Железный человек
- Кошелек ЮMoney: 41001xxxxxxxxxxxx
- Назначение перевода: на реактор холодного ядерного синтеза
- Сумма: 4568,25 рублей
<form method="POST" action="https://yoomoney.ru/quickpay/confirm.xml"> <input type="hidden" name="receiver" value="41001xxxxxxxxxxxx"/> <input type="hidden" name="formcomment" value="Проект «Железный человек»: реактор холодного ядерного синтеза"/> <input type="hidden" name="short-dest" value="Проект «Железный человек»: реактор холодного ядерного синтеза"/> <input type="hidden" name="label" value="$order_id"/> <input type="hidden" name="quickpay-form" value="donate"/> <input type="hidden" name="targets" value="транзакция {order_id}"/> <input type="hidden" name="sum" value="4568.25" data-type="number"/> <input type="hidden" name="need-fio" value="true"/> <input type="hidden" name="need-email" value="true"/> <input type="hidden" name="need-phone" value="false"/> <input type="hidden" name="need-address" value="false"/> <label><input type="radio" name="paymentType" value="PC"/>ЮMoney</label> <label><input type="radio" name="paymentType" value="AC"/>Банковской картой</label> <input type="submit" value="Перевести"/> </form>