Dynamic Product Checkout Link API

С помощью Dynamic Product Checkout API вы можете генерировать ссылки на покупку продуктов без необходимости создавать каждый продукт отдельно в каталоге на нашей стороне.

По ссылке на покупку, полученной в ответ на запрос к API, произойдет добавление в корзину продукта, у которого:

  • Часть свойств продукта (например: наименование, цена) будет взята из запроса к API,
  • Другая часть свойств будет взята из базового продукта, предварительного настроенного для вас на нашей стороне.

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

В этом разделе описана новая версия протокола в формате JSON. Предыдущая версия (XML) является устаревшей и более не обновляется. Если вы работаете через старый протокол, то рекомендуем обновить подключение. Если вам нужна документация для старой версии протокола, то обратитесь в нашу службу поддержки.
  1. Вы передаете в запросе:
    • Список динамических продуктов, которые должны быть добавлены в корзину.
      По каждому продукту: идентификатор базового продукта, динамические характеристики (название, цена и др).
    • Данные покупателя (опционально).
      Если данные переданы, то покупателю не нужно будет их заполнять в корзине для оформления заказа. Он увидит уже предварительно заполненные поля и сможет их отредактировать
  2. В ответ API возвращает ссылку на покупку, которую нужно предоставить покупателю для оформления заказа. 
  3. При переходе по ссылке в корзину будут добавлены переданные продукты и предварительно заполнены данные покупателя. 
  4. Далее покупатель может оформить заказ, как обычно.
Внимание! Ссылка является одноразовой, по ней можно оформить только один заказ. Динамические продукты не добавляются в каталог.
  • Продажа продуктов, у которых покупатель может выбрать конфигурацию в вашем каталоге.
    Например, на вашем сайте есть "калькулятор", который позволяет покупателю настроить совокупность свойств продукта и рассчитать цену.
    Если таких свойств достаточно много, то быстрее получать ссылку на покупку через API, чем создавать в каталоге продукты для каждой возможной комбинации свойств.
  • Продажа часто изменяемых продуктов, которые вы не хотите постоянно добавлять и обновлять через каталог на нашей стороне.
  • Продажа продуктов, для которых требуется выполнение дополнительных условий.
    Например, продукт можно приобрести, только если у покупателя есть корректный серийный номер предыдущей лицензии продукта.
    В этом случае вы на своей стороне запрашиваете у покупателя серийный номер, проверяете его корректность. В случае, если условие выполнено, то через API создаете одноразовую ссылку на покупку.
    Таким образом, покупатель сможет оформить заказ только в случае выполнения условия, и только один заказ.
  • Предоставление специальных условий для определенных покупателей.
    Например: особая цена на продукт или особая комплектация, предварительное заполнение данных покупателя в корзине.