50. Checkout widget

Как изглежда checkout widget-ът #

Интеграцията на Изпрати.БГ добавя към native checkout-а на ConvertBuilder актуални цени за доставка, отделни методи за офис, автомат и адрес и точен избор на офис/автомат. Цените, куриерите, логата и наличните точки идват от калкулатора на Изпрати.БГ. Поръчката продължава да се създава през стандартния ConvertBuilder checkout.

Какво получава клиентът #

• автоматично предложение за населено място по геолокация;
• при липса на геолокация за България се използва София като начална стойност за показване на офиси и цени;
• отделни цени и методи за офис, автомат и адрес;
• лога от отговора на куриерския калкулатор;
• търсене по град, офис или адрес, изглед „Списък“ и „Карта“ и подреждане по близост или по азбучен ред;
• точен избор на офис/автомат и компактно резюме след избора;
• блокирано завършване, когато методът изисква точка, но такава не е избрана.

Предварителни условия #

1. Активен профил в Изпрати.БГ, свързани куриерски договори и активен подател.
2. Създаден ConvertBuilder/Simvoly източник за точния storefront домейн с разрешен origin.
3. Публичен ключ за checkout widget-а и активирани желани куриерски услуги.

Ключът в браузъра е публичен идентификатор. Подписващата тайна и куриерските пароли остават само в Изпрати.БГ и никога не се поставят в ConvertBuilder.

1. Добавете полето octava #

В ConvertBuilder създайте едно V2 текстово поле с точно име:

octava

Widget-ът скрива полето от клиента и записва в него подписаната структурирана селекция за доставка. Не създавайте отделни octava_* полета и не променяйте името.

2. Добавете checkout script-а в demo режим #

Добавете script-а само веднъж в custom code секцията на checkout страницата:

<script
  src="https://simvoly-checkout.izprati.bg/widget.js"
  data-octava-api-base="https://pro.oawms.com"
  data-octava-key="ВАШИЯТ-ПУБЛИЧЕН-КЛЮЧ"
  data-octava-demo-only="1"
  defer
></script>

При data-octava-demo-only="1" интеграцията се показва само при URL с ?demo=1. Обикновеният checkout остава непроменен за клиентите по време на теста.

3. Проверете методите и цените #

Отворете demo URL-а в инкогнито прозорец или в отделна тестова сесия. Не въвеждайте реални клиентски данни.

Трябва да видите предложено населено място, реална цена до всеки метод, отделни редове за офис, автомат и адрес според възможностите на куриера, логото на съответния куриер и постоянен ред на методите.

4. Проверете избор на офис или автомат #

1. Изберете метод до офис или автомат.
2. Потърсете по град, име или адрес или използвайте „Близо до мен“.
3. По желание превключете между „Списък“ и „Карта“.
4. Изберете точна точка.
5. Уверете се, че списъкът се свива до резюме с точната точка, цена и бутон „Промени офис или автомат“.

При смяна на куриера или типа доставка предишната несъвместима точка се изчиства. Поръчката не може да бъде завършена, докато новият метод няма валидна селекция.

5. Проверете доставка до адрес #

Изберете метод „до адрес“. Полето за улица и номер трябва да се показва само за адресна доставка. При офис или автомат адресът се попълва от избраната точка и не се изисква ръчно от клиента.

6. Активирайте за всички клиенти #

1. Запазете копие на текущата checkout конфигурация.
2. Премахнете data-octava-demo-only="1" от script-а.
3. Публикувайте checkout страницата.
4. Отворете нормалния /checkout URL без ?demo=1 и направете финална проверка.

Контролен списък преди активиране #

• Обикновеният checkout не показва widget-а, докато demo режимът е активен.
• Demo URL-ът показва цени от калкулатора.
• Офисите/автоматите се филтрират по населено място; търсенето, картата и „Близо до мен“ работят.
• Избраната точка се показва в компактно резюме и смяната на метод изчиства несъвместимата точка.
• Адресното поле се показва само за доставка до адрес.
• Не може да се продължи без точка при офис/автомат.
• V2 полето octava остава скрито от клиента.
• „Работи с ИЗПРАТИ.БГ“ се вижда, когато планът изисква брандиране.

Ако нещо не се показва #

Widget-ът липсва #

При demo режим URL-ът задължително трябва да съдържа ?demo=1. Проверете дали script-ът е добавен само веднъж, публичният ключ е правилен и storefront origin-ът е разрешен.

Няма цени #

Проверете дали има избрано населено място, активен подател, валидни куриерски настройки и активирани услуги за ConvertBuilder източника.

Няма офиси или автомати #

Проверете избрания град и дали съответният куриер има синхронизирани активни точки за него.

Не може да се завърши поръчката #

При офис или автомат трябва да бъде избрана точна точка. Проверете също дали V2 текстовото поле е именувано точно octava.