Формы оплаты товаров и услуг
API предназначен для работы с формами оплаты, с его помощью можно:
- делать запросы описаний форм оплаты;
- проверять данные, введенные покупателем;
- получать параметры для вызова функций оплаты из кошелька ЮMoney.
Например, с помощью этого API можно перевести деньги любой российской компании через форму оплаты квитанций:
pattern-id=5551.Формы оплаты в формате JSON доступны не для всех товаров и услуг.
Формы оплаты могут быть простыми и многошаговыми.
Многошаговые формы предназначены для реализации динамических пользовательских сервисов, когда дальнейшие действия сервиса зависят от данных, введенных покупателем.
С технической точки зрения API представляет собой инструмент для работы с документами на удаленном сервере по протоколу HTTP/1.1 (RFC-7231).
Поведение клиента соответствует поведению браузеров при работе с ресурсами интернета.
Для работы с API авторизация клиента не требуется.
Описание формы оплаты доступно на разных языках: нужный язык можно указать в запросе. По умолчанию загружается описание на русском.
Сценарий использования форм оплаты:
- Описание формы загружается и показывается покупателю.
- Покупатель заполняет поля формы.
- Форма отправляется серверу на проверку:
- если введенные покупателем данные верны, сервер возвращает набор параметров для оплаты;
- если найдены ошибки, сервер возвращает список ошибок и описание формы с заполненными покупателем полями.
Описания простых одношаговых форм можно кэшировать на стороне клиента.
Описание полей формы содержит правила проверки значений, вводимых покупателем. Клиенту следует проверять содержимое полей формы по этим правилам до отправки данных формы на сервер.