Интеграция с онлайн магазин

Проследяване от страна на сървъра за CCV Shop

Свържете API ключовете на CCV Shop и натиснете Create webhook. След това CCV съобщава на ROASaurus за всяка платена поръчка, а ROASaurus я изпраща към вашите рекламни платформи от сървъра.

CCV Shop накратко
Поръчките пристигат чрезWebhook (платена поръчка) плюс проверка на всеки 5 минути
Настройка на webhook-оветеАвтоматична, с бутона Create webhook
Данни за достъпPublic key и secret key от API gegevens
Подписване на заявкитеHMAC-SHA512 при всяко извикване на API
Кодов фрагмент за благодарностСтраница за успешна поръчка, с Vertoshop.getOrder().getId()

Как се свързва CCV Shop

  1. Добавете скрипта на ROASaurus към всички страници: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML или кодов блок от приложение в хедъра.
  2. Добавете кодовия фрагмент за страницата за благодарност към страницата за успешна поръчка.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: копирайте public key и secret key. Ако не виждате API gegevens, първо инсталирайте приложението API.
  4. Въведете двата ключа в ROASaurus, запазете, после натиснете Create webhook.

Какво прави Create webhook

ROASaurus регистрира webhook в CCV за събитието order paid. След това CCV съобщава за всяка платена поръчка веднага. Когато CCV върне webhook secret, ROASaurus проверява HMAC-SHA512 подписа на всяко изпращане; всяко изпращане трябва да носи и токена, уникален за вашия магазин. След това ROASaurus изтегля пълната поръчка и нейните редове от API.

Всяко извикване на API от ROASaurus се подписва така, както изисква CCV: HMAC-SHA512 хеш на вашия public key, метода, адреса, тялото на заявката и времеви печат.

5-минутната проверка

ROASaurus пита CCV за платени поръчки и на всеки 5 минути. CCV филтрира само по дата на създаване, затова поръчка, отбелязана като платена дни след направата ѝ, се улавя от webhook-а, а не от проверката.

Какво чете ROASaurus от всяка поръчка

Пълен номер на поръчката, обща сума, валута, имейл на клиента, мобилен или телефонен номер, име, град, пощенски код и държава за фактуриране, ID на клиента и всеки ред от поръчката с номер на продукта, количество и цена.

Ограничения

  • Поръчките от CCV не съдържат IP адреса на купувача, затова резервното съпоставяне по IP не е налично. Добавете кодовия фрагмент за страницата за благодарност.
  • Дръжте webhook-а активен: закъснелите плащания разчитат на него.
  • Конекторът е изграден по официалната API документация на платформата. Натиснете Test connection, след като запазите данните си за достъп, после направете тестова поръчка и проверете Event log.

Свързани

ЧЗВ

Въпроси и отговори

Къде да намеря API ключовете на CCV Shop?

В Mijn webshop › Instellingen › Algemeen › API gegevens. Ако това меню липсва, първо инсталирайте приложението API на CCV.

Какво прави кодовият фрагмент за успешна поръчка?

Той чете ID на поръчката с Vertoshop.getOrder().getId() и задейства с него покупката в ROASaurus, което свързва поръчката с посетителя и с клика му върху реклама.

Изпращат ли се и поръчките, платени по-късно?

Да, чрез webhook-а за платена поръчка. 5-минутната проверка гледа само наскоро създадените поръчки, затова дръжте webhook-а активен.

Всяка продажба, проследена до рекламата, която я е донесла

Проследяване от страна на сървъра, печалба и пожизнена стойност на клиента в едно приложение. 14-дневен безплатен пробен период, без кредитна карта.

Започнете безплатния си пробен период →