Форма — это набор полей с информацией о переводе.
Форму можно разместить в своем интерфейсе (например, на сайте или в блоге).
Когда отправитель нажимает на кнопку, данные формы отправляются в ЮMoney и инициируют распоряжение на перевод в ваш кошелек.
Метод отправки формы:
POST
Адрес для отправки формы
https://yoomoney.ru/quickpay/confirm.xml
| Параметр | Тип | Описание |
|---|---|---|
| Обязательные параметры | ||
| receiver | string | Номер кошелька ЮMoney, на который нужно зачислять деньги отправителей. |
| quickpay-form | string | Тип формы.
Фиксированное значение — button . |
| paymentType | string | Способ оплаты.
Возможные значения:
|
| sum | CurrencyAmount | Сумма перевода (спишется с отправителя). |
| Необязательные параметры | ||
| label | string До 64 символов | Метка, которую сайт или приложение присваивает конкретному переводу. Например, в качестве метки можно указывать код или идентификатор заказа. |
| successURL | string, URL path | URL-адрес для редиректа после совершения перевода. |
Рассчитать комиссию — например, чтобы показать пользователю до перевода — можно с помощью коэффициента по формуле с использованием этих параметров:
- amount_due— сумма к получению;
- sum— сумма к списанию;
- a— коэффициент комиссии.
Параметры
amount_due
и a
никуда не передаются: они используются только для расчетов.
Параметр sum
передаете ЮMoney в форме.
| Способ оплаты | Коэффициент комиссии (a) | Откуда комиссия | Формула для расчета | Пример |
|---|---|---|---|---|
| Кошелек ЮMoney PC | 0,01 | с получателя, от суммы к получению | amount_due = sum — sum * (a / (1 + a)) | Отправитель переводит 1000 рублей из кошелька, на счет получателя поступят 990 рублей 9 копеек. |
| Банковская карта AC | 0,03 | с получателя, от суммы к списанию | amount_due = sum * (1 — a) | Отправитель переводит 1000 рублей с карты, на счет получателя поступят 970 рублей. |
<form method="POST" action="https://yoomoney.ru/quickpay/confirm.xml"> <input type="hidden" name="receiver" value="41001xxxxxxxxxxxx"/> <input type="hidden" name="label" value="$order_id"/> <input type="hidden" name="quickpay-form" value="button"/> <input type="hidden" name="sum" value="4568.25" data-type="number"/> <label><input type="radio" name="paymentType" value="PC"/>ЮMoney</label> <label><input type="radio" name="paymentType" value="AC"/>Банковской картой</label> <input type="submit" value="Перевести"/> </form>