Ссылки на покупку

Ссылка на покупку – это ссылка, с помощью которой покупатель может добавить продукт в корзину и перейти к оформлению заказа.
Чтобы покупатель смог воспользоваться ссылкой, разместите её на сайте или в письме.

Базовый вариант ссылки на покупку содержит только идентификатор продукта, который нужно добавить в корзину.
Используйте дополнительные параметры в ссылке на покупку, чтобы добавить несколько продуктов в корзину, изменить их отображение и т.п.

Базовая ссылка на покупку позволяет добавить один продукт в корзину. При этом в корзину будет добавлено минимально допустимое количество единиц продукта.

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}

Вы можете получить ссылки в таком формате на странице управления продуктом через Merchant Portal.

Используете GET-параметры, чтобы получить дополнительные возможности, например, добавить по одной ссылке несколько продуктов в корзину, применить промокод на скидку, переключить язык или валюту корзины и т.п.

В одной ссылке может быть указано несколько параметров сразу, в этом случае необходимые параметры перечисляются после ?, разделенные знаком &.

Формат базовой ссылки:

https://{домен_корзины}/basket/add/{id_продукта}

Формат ссылки с одним дополнительным параметром:

https://{домен_корзины}/basket/add/{id_продукта}?{параметр}={значение}

Формат ссылки с несколькими дополнительными параметрами:

https://{домен_корзины}/basket/add/{id_продукта}?{параметр}={значение}&{параметр}={значение}

С помощью параметра clear=Y вы можете предварительно очистить корзину перед тем, как в нее будут добавлены продукты по ссылке.

После перехода по ссылке на покупку с дополнительным параметром:

  • В корзине будут только продукты, которые были переданы в ссылке
  • Если в корзине до этого были другие продукты - они будут удалены из нее

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?clear=Y

Где:

Пример:

Вы также можете использовать параметр clear=Y, чтобы выполнить удаление продуктов из корзины без добавления нового продукта.

Формат ссылки:

https://{домен_корзины}/basket/add/?clear=Y

С помощью параметра pricegroupid вы можете добавить в корзину сразу несколько продуктов по одной ссылке на покупку. Каждый продукт будет добавлен в минимально допустимом для него количестве.

Формат ссылки:

https://{домен_корзины}/basket/add/?pricegroupid={id_продукта_1},{id_продукта_N}

Где:

  • pricegroupid={id_продукта_1},{id_продукта_N} - параметр со списком продуктов, которые нужно добавить в корзину
    • Вместо значений в скобках подставьте идентификаторы нужных продуктов, разделенные запятыми
    • Вы можете получить эти идентификаторы из базовых url соответствующих продуктов

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &.

Пример:

Вы также можете использовать cross-sell offer, чтобы автоматически добавлять в корзину дополнительный продукт. Узнайте подробнее об этой возможности.

С помощью параметра quantity вы можете добавить в корзину несколько единиц одного продукта. По умолчанию (без дополнительного параметра) в корзину добавляется минимально допустимое количество продукта.

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?quantity={количество}

Где:

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &.

Пример:

Использование дополнительных параметров позволяет добавить в корзину несколько разных продуктов и указать их количество.

Формат ссылки:

https://{домен_корзины}/basket/add/?pricegroupid={id_продукта_1},{id_продукта_N}&quantity={количество_продукта_1},{количество_продукта_N}

Где:

  • pricegroupid={id_продукта_1},{id_продукта_N} - параметр со списком продуктов, которые нужно добавить в корзину
    • Вместо значений в скобках подставьте идентификаторы нужных продуктов, разделенные запятыми
    • Вы можете получить эти идентификаторы из базовых url
  • quantity={количество_продукта_1},{количество_продукта_N} - параметр для передачи количества продукта для каждого подукта.
    • Вместо значений в скобках подставьте количество единиц продукта для каждого продукта, которое нужно добавить в корзину
    • Количество разных продуктов разделяется запятыми
    • Значения не должны выходить за ограничения допустимого для продажи количества продукта.

Обратите внимание. Количество должно быть перечислено в том же порядке, в каком перечислены продукты в параметре pricegroupid. Если какой-либо продукт нужно добавить в корзину в минимально допустимом количестве (не определяя количество продукта в ссылке), то не передавайте его количество, но сохраните запятые вокруг отсутствующего значения: ...?pricegroupid={id_продукта_1},{id_продукта_2},{id_продукта_N}&quantity={количество_для_продукта_1},,{количество_для_продукта_группы_N}

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &.

Пример:

С помощью параметра currency вы можете добавить продукт в корзину с ценой в определенной валюте. Это доступно только в корзинах с продажами в нескольких валютах. Подключение валют к корзине выполняется согласно договору.

Особенности работы:

  • Можно передать только одну валюту, которая применяется к ценам всех продуктов в корзине
  • В корзине не может быть два продукта в разной валюте
  • Если в корзине уже есть один или несколько продуктов в одной валюте, и покупатель переходит по ссылке на покупку, которая содержит другую валюту, то валюта корзины изменится, только если для всех продуктов в корзине доступна продажа в этой валюте
  • Если хотя бы один продукт не доступен для продажи в переданной валюте, то продукты буду добавлены в корзину так, как если бы в ссылке на покупку не было валюты (то есть, валюта корзины не изменится)
  • После перехода по ссылке, в которой передана валюта, покупатель может изменить валюту корзины вручную (как обычно)

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?currency={валюта}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • currency={валюта} - параметр с кодом валюты, в которой продукт нужно добавить в корзину:
    • Вместо значения в скобках укажите код соответствующей валюты по ISO 4217 alpha-3, например, "USD" - доллары США
    • Список кодов см. в справочнике валют

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &.

Пример:

С помощью параметра lang вы можете открыть корзину с интерфейсом на определенном языке. Переданный язык должен быть подключен к корзине. Для локализации продуктов вы можете использовать Product API.

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?lang={язык_корзины}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • lang={язык_корзины} - параметр с кодом языка интерфейса корзины
    • Вместо значения в скобках укажите четырехбуквенныей код соответствующего языка вида xx_XX
    • Список кодов см. в справочнике языков

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &.

Пример:

С помощью параметра auto_renew вы можете управлять состоянием по умолчанию переключателя согласия на подписку у продуктов в корзине. Влияет только на состояние по умолчанию, покупатель сможет вручную изменить состояние переключателя.

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

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?auto_renew={значение}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • auto_renew={значение} - параметр, в котором передается состояние опции согласия на подписку:
    Вместо {значение} подставьте один из вариантов:
    • 0 - согласие на автопродление для продукта по умолчанию выключено
    • 1 - согласие на автопродление для продукта по умолчанию включено

Вы можете использовать этот параметр совместно с другими, для этого добавьте другие параметры через &. При использовании с параметрами для добавления в корзину нескольких продуктов, вы можете по-разному передать значение опции согласия на автопродление для каждого из них. 

Формат:

https://{домен_корзины}/basket/add/?pricegroupid={id_продукта_1},{id_продукта_N}&auto_renew={значение_для_продукта_1},{значение_для_продукта_2}

Обратите внимание. Значение опции должно быть перечислено в том же порядке, в каком перечислены продукты в параметре pricegroupid. Если какой-либо продукт нужно добавить в корзину не определяя значение опции в ссылке, то не передавайте его количество, но сохраните запятые вокруг отсутствующего значения: ...&auto_renew={значение_для_продукта_1},,{значение_для_продукта_3}

Пример:

С помощью параметра CustomID=PPMONTH вы можете отобразить в корзине дополнительную стоимость продукта за месяц рядом с обычной ценой. Может использоваться только продуктом, у которого задан срок действия в месяцах или годах. Узнайте подробнее о формате цен "за месяц".

Например:

  • Продукт имеет цену $120 и срок действия 1 год
  • Если формат "за месяц" отключен, то в корзине покупатель увидит цену: $120
  • Если формат "за месяц" включен, то в корзине покупатель увидит цену: $120 ($10 в месяц)

Использование параметра не поддерживается настройками корзины по умолчанию. Если у вас есть необходимость в использовании параметра, обратитесь в службу поддержки.

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?CustomID={значение}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • CustomID={значение} - параметр, в котором передаются дополнительные настройки для корзины. Чтобы отобразить цены в формате "за месяц", передайте значение параметра CustomID=PPMONTH.

Промокоды (купоны) - один из видов скидок на продукты. Для получения скидки необходимо активировать промокод в корзине. Узнайте подробнее об использовании промокодов.

Возможно несколько режимов работы корзины:

  • Блок активации промокода выводится всегда
  • Блок активации промокода скрыт

С помощью параметров в ссылке на покупку вы можете:

С помощью параметра coupon_seria вы можете предварительно заполнить блок активации промокода в корзине. Покупателю нужно будет нажать кнопку активации, чтобы применить промокод. При использовании этого параметра блок будет отображен в любом режиме работы корзины (если он выводится всегда или если по умолчанию скрыт).

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?coupon_seria={промокод}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • coupon_seria={промокод} - параметр с промокодом. Подставьте промокод, который нужно заполнить в поле активации

Пример:

С помощью параметра auto вы можете автоматически активировать промокод, переданный в параметре coupon_seria.

Особенности применения:

  • Если блок активации промокода в корзине отображается всегда, то покупатель увидит сообщение, что промокод с таким-то названием активирован, и скидка будет применена к продукту
  • Если блок активации промокода в корзине скрыт, то он не будет отображен при переходе по ссылке, покупатель увидит только примененную скидку в корзине

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?coupon_seria={промокод}&auto

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • coupon_seria={промокод} - параметр с промокодом. Подставьте промокод, который нужно заполнить в поле активации
  • auto - параметр для автоматической активации промокода. Подставляемых значений нет

Пример:

С помощью параметра show-coupon вы можете отобразить незаполненный блок для активации промокода в корзине. Используйте это, если по умолчанию блок для активации промокода скрыт в корзине. 

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?show-coupon

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • coupon_seria={промокод} - параметр с промокодом. Подставьте промокод, который нужно заполнить в поле активации
  • show-coupon - параметр отображения блока активации промокода. Подставляемых значений нет

Пример:

С помощью параметров referer1-referer6 вы можете передать любые значения, которые будут сохранены в заказе. Эти данные не отображаются покупателю на странице корзины (но он может их увидеть в строке URL. Узнайте подробнее об использовании этих данных.

Как это работает:

  • Рефереры, переданные в ссылке, фиксируются на стороне покупателя с помощью cookies (срок хранения - 45 дней)
  • Если покупатель завершает создание заказа, то эти параметры сохраняются в заказе (срок хранения этих данных в заказе ограничен)

Формат ссылки:

https://{домен_корзины}/basket/add/{id_продукта}?referer1={значение}&referer2={значение}&referer3={значение}&referer4={значение}&referer5={значение}&referer6={значение}

Где:

  • https://{домен_корзины}/basket/add/{id_продукта} - базовая ссылка на покупку
  • referer1={значение}&referer2={значение}&referer3={значение}&referer4={значение}&referer5={значение}&referer6={значение} - параметры, содержащие значение рефереров
    • Максимальное количество рефереров 6, т.е. допустимое названия параметров referer1 ... referer6
    • Значение реферера не может быть больше 255 символов

Пример: