Маркет для магазинов

Подключение Быстрого заказа

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

Разместите специальную кнопку на странице с формой ввода адреса доставки на сайте вашего магазина. Во время оформления доставки при нажатии на данную кнопку пользователь перенаправляется в свой профиль на Яндексе, где может выбрать любой адрес из сохраненных ранее. После выбора пользователь перенаправляется на страницу магазина, указанную при размещении кнопки. На ту же страницу передаются параметры выбранного адреса. Таким образом, пользователю не требуется каждый раз заполнять поля формы ввода адреса.

Для использования интерфейса Быстрого заказа необходимо последовательно выполнить следующие действия:

Шаг 1. Подключение интерфейса

Для подключения интерфейса необходимо заполнить форму регистрации. В данной форме обязательно укажите URL страницы, на которую необходимо отправлять параметры адреса доставки и перенаправлять пользователя после выбора адреса.

После регистрации вам будет предложен код кнопки, которую необходимо установить на форме оформления заказа вашего магазина. Также будет сгенерирован параметр url_id.

Далее вы можете перейти к следующему шагу — установке кнопки на сайте вашего магазина.

Шаг 2. Установка кнопки

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

URL кнопки должен быть вида:

http://market.yandex.ru/addresses.xml?callback={callback_url}&size={mini}&type={xml|json}

и содержать следующие параметры:

  • callback — обязательный параметр. Содержит указанный при подключении интерфейса URL, на который необходимо отправлять параметры адреса доставки и перенаправлять пользователя после выбора адреса. URL должен быть в URL-encoded виде.

  • size — необязательный параметр. Допустимое значение: mini. Предназначен для отображения интерфейса адресов доставки в небольшом окне.

  • type — необязательный параметр. Задает формат, в котором на страницу магазина передается выбранный пользователем адрес. Допустимые значения: json, xml. При отсутствии данного параметра адрес передается в виде пар «key=value», разделенных символом &.

Пример URL кнопки:
http://market.yandex.ru/addresses.xml?callback=http%3A%2F%2Fexample.org%2Fshop%2Forder&size=mini&type=json
Примеры отображения кнопки:

Шаг 3. Передача данных

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

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

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

Авторизованный пользователь с сохраненными в профиле Яндекса адресами может выбрать любой адрес для доставки заказа. После выбора адреса пользователь перенаправляется на URL, указанный при подключении интерфейса. Данные выбранного адреса передаются на этот же URL в виде POST-запроса.

Если в URL кнопки отсутствует параметр type, то в POST-запросе передаются следующие параметры:

  • operation_id — уникальный идентификатор операции передачи адреса (строка).

  • id — идентификатор адреса (целое число).

  • title — название адреса (строка).

  • street — улица (строка).

  • building — номер дома (целое число).

  • suite — корпус (строка).

  • flat — квартира (целое число).

  • entrance — подъезд (целое число).

  • floor — этаж (целое число).

  • intercom — домофон (строка).

  • city — город (строка).

  • country — страна (строка).

  • zip — индекс (целое число).

  • metro — станция метро (строка).

  • cargolift — наличие грузового лифта (значение «yes» при наличии, значение «no» при отсутствии).

  • firstname — имя (строка).

  • lastname — фамилия (строка).

  • fathersname — отчество (строка).

  • phone — телефон (строка).

  • phone-extra — дополнительный телефон (строка).

  • email — электронный адрес для связи (строка).

  • comment — комментарий к адресу (строка).

Если в URL кнопки задан параметр type, то в POST-запросе передаются следующие параметры:

  • operation_id — уникальный идентификатор операции передачи адреса (строка).

  • address — адрес доставки и информация о пользователе в URL-encoded виде в формате, указанном в параметре type (xml или json).

Пример значения параметра address в формате json (после декодирования специальных символов):
"{"id":"131420142986084","title":"Домашний","street":"Широкая","building":"1","suite":"1",
"flat":"116","entrance":"1","floor":"7","intercom":"116#22","city":"Санкт-Петербург","country":"Россия",
"zip":"192197","metro":"","cargolift":"yes","firstname":"Ваня","lastname":"Иванов","fathersname":"Иванович",
"phone":"+7 812 123-23-23","phone-extra":"","comment":"Теперь эта улица называется
Ленина","email":"example@yandex.ru"}"
Пример значения параметра address в формате xml (после декодирования специальных символов):
"<address><id><![CDATA[131420142986084]]></id><title><![CDATA[Домашний]]></title>
<street><![CDATA[Широкая]]></street><building><![CDATA[1]]></building><suite><![CDATA[1]]></suite>
<flat><![CDATA[116]]></flat><entrance><![CDATA[1]]></entrance><floor><![CDATA[7]]></floor>
<intercom><![CDATA[116#22]]></intercom><city><![CDATA[Санкт-Петербург]]></city>
<country><![CDATA[Россия]]></country><zip><![CDATA[192197]]></zip><metro><![CDATA[]]></metro>
<cargolift><![CDATA[yes]]></cargolift><firstname><![CDATA[Ваня]]></firstname>
<lastname><![CDATA[Иванов]]></lastname><fathersname><![CDATA[Иванович]]></fathersname>
<phone><![CDATA[+7 812 123-23-23]]></phone><phone-extra><![CDATA[]]></phone-extra>
<comment><![CDATA[Теперь эта улица называется Ленина]]></comment>
<email><![CDATA[example@yandex.ru]]></address>"

Если в URL страницы перенаправления в строке запроса содержатся параметры, то данные параметры также будут переданы в POST-запросе вместе с адресом пользователя.

Оцініть статтю
Дякуємо за ваш відгук!