Вы можете создавать новые заказы в вашем магазине на JustClick формируя запрос к API сервиса программными методами.

За один вызов функции формируется отдин заказ на имя одного покупателя, но возможно с несколькими продуктами. Продукты уже должны присутствовать в вашем магазине на JustClick.

Запрос передаётся методом POST в формате URLencode на адрес: http://username.justclick.ru/api/CreateOrder

где username — это логин пользователя в системе и заодно его домен 3-его уровня в JustClick.

Параметры передаваемые в запросе

  • goods — массив с данными о заказаных продуктах, состоит из пар ID продукта, цена продукта:
    • good_name — ID продукта в системе JustClick,
    • good_sum — цена данного продукта в данном заказе, может отличатся от указанной в магазине, если этот параметр опущен — берётся цена из настроек продукта в магазине;
  • bill_first_name — имя покупателя,
  • bill_surname — фамилия покупателя,
  • bill_otchestvo — отчество покупателя,
  • bill_email — e-mail покупателя,
  • bill_phone — телефон покупателя,
  • bill_country — страна доставки,
  • bill_region — регион доставки,
  • bill_city — город покупателя,
  • bill_address — адрес доставки,
  • bill_postal_code — почтовый индекс,
  • bill_kupon — купон скидки (как в настройках магазина),
  • bill_tag — произвольный маркер(метка) заказа,
  • bill_comment — комментарий к заказу,
  • bill_ip — IP покупателя,
  • bill_timer_kill — время отмены счета (true — время берется из настроек продукта; false — автоотмены счета не будет; время в формате UNIX timestamp — счет отменится именно в это время),
  • bill_created — время создания заказа в формате UNIX timestamp,
  • bill_domain — домен, на котором принят заказ.
  • utm[utm_medium] — утм-параметр канал (не обязательно)
  • utm[utm_source] — утм-параметр источник (не обязательно)
  • utm[utm_campaign] — утм-параметр кампания (не обязательно)
  • utm[utm_content] — утм-параметр объявление (не обязательно)
  • utm[utm_term] — утм-параметр ключ (не обязательно)
  • utm[aff_medium] — парнерский-параметр канал (не обязательно)
  • utm[aff_source] — парнерский-параметр источник (не обязательно)
  • utm[aff_campaign] — парнерский-параметр кампания (не обязательно)
  • utm[aff_content] — парнерский-параметр объявление (не обязательно)
  • utm[aff_term] — парнерский-параметр ключ (не обязательно)

Обязательными являются: bill_email и goods, а в нём good_name. Для физического товара отправляемого по почте так же обязательными будут данные для пересылки: bill_first_name, bill_surname, bill_country, bill_city, bill_address. Остальные параметры запроса отправляются на ваше усмотрение.

Если нужно передать информацию, что клиент пришел от партнера, то вам следует передавать 2 параметра utm[utm_medium] и utm[utm_source] следующим образом:

Вместе с ними можно использовать партнерские utm_метки (utm[aff_…]). При этом указанный партнер обязательно должен быть участником партнерсой программы и данные метки (utm[aff_…]) будут отображаться только в его партнерском кабинете.

В параметре bill_domain рекомендуем передавать адрес Вашего сайта в системе JustClick или адрес привязанного сайта без указания протокола (http://). Если в этом параметре Вы не передаёте ничего, то при обращении к ссылке на оплату заказа $resp->result[‘link’] после вызова getOrderDetails Вам необходимо самостоятельно проконтролировать переход на нужный домен. В противном случае эта ссылка уже будет содержать необходимый протокол и домен для использования, например так:

 

Как работает

Вы формируете в своей системе заказа и передаёте его данные через обращение к функции API CreateOrder.

В ответ на запрос ваша система получит результат выполнения функции и номер созданного заказа в переменной result->bill_id.
Ответ кодирован в формате JSON. Подробнее смотрите «Ответы API сервиса».

Пример на PHP создания нового заказа

В примере добавляем заказ с двумя товарами, логин в системе «username».

Функция GetHash — формирует подпись к передаваемым данным.

Функция CheckHash — проверяет подпись к ответу сервиса.

Оценить статью

1 Звезда2 Звезды3 Звезды4 Звезды5 Звезд (Пока оценок нет)
Загрузка...