Checkout•

ГлавнаяГлобальная электронная коммерция Интеграция Интеграция Checkout Пользовательская интеграция

Пользовательская интеграция

Создайте полнофункциональную интеграцию Checkout на свой пользовательский сайт.

Контрольный список интеграции

Следуйте этому подробному контрольному списку для настройки учетной записи Zonos Dashboard и интеграции Zonos Checkout на свой пользовательский сайт или платформу.

Создайте учетную запись Zonos

Чтобы начать, пожалуйста, свяжитесь с нашей командой по продажам для создания учетной записи и подписания соглашения. После подписания соглашения вы получите два микродепозита на ваш счет, которые необходимо подтвердить.

Пожалуйста, отправьте суммы микродепозитов по адресу accounting@zonos.com с указанием вашего ID хранилища Dashboard (поставьте в копию вашего торгового представителя).

После проверки ваши банковские реквизиты будут отображаться в Dashboard -> Settings -> Billing.

Настройте параметры Dashboard и Checkout

После создания учетной записи Zonos вам необходимо настроить параметры в Dashboard, чтобы убедиться, что Checkout работает правильно с вашим хранилищем. В этом разделе рассматриваются все важные конфигурации Dashboard.

Настройте выплаты

Подключите банковский счет для получения своевременных выплат от Checkout. Выплаты обрабатываются ежедневно с задержкой в 2 дня с момента получения платежа. Для этого выполните следующие шаги:

Перейдите в Dashboard -> Settings -> Checkout settings .
Нажмите Add bank account
Вы будете перенаправлены на портал Stripe для завершения настройки и предоставления следующей информации:
- Информация о банковском счете.
- EIN компании.
- Номер социального страхования владельца компании на 25%. Дополнительные сведения см. в документации Stripe.

Note: Если вам нужно обновить расписание выплат, пожалуйста, свяжитесь с support@zonos.com

Настройте разрешенные домены

Для целей безопасности сценарий Zonos JS требует список разрешенных доменов. Это предотвращает загрузку сценария на неавторизованных сайтах и гарантирует его запуск только на утвержденных вами доменах. Без этой конфигурации сценарий будет возвращать ошибки разрешений.

Для этого:

Перейдите в Dashboard -> Settings -> Checkout settings
В разделе URLs добавьте ваш полный домен и любые поддомены, где будет использоваться Checkout. Например, если ваш домен - example.com, вам следует добавить example.com и test.example.com.

Настройте параметры брендинга

Настройте параметры брендинга в Dashboard в соответствии с внешним видом и стилем вашего хранилища.

Для этого выполните следующие шаги:

Перейдите в Dashboard -> Settings -> Checkout settings -> Branding
Настройте следующие параметры:
- Логотип.
- Цвет бренда и акцента.
- Тема, стиль и шрифт.

Дополнительную информацию о параметрах брендинга см. в нашей документации.

Подключите перевозчика доставки

Чтобы предоставить цены доставки при оформлении заказа, вам необходимо подключить перевозчика доставки к вашей учетной записи Zonos. Это позволит вам включить конкретные уровни услуг доставки при оформлении заказа.

Чтобы подключить перевозчика доставки, выполните следующие шаги:

Перейдите в Dashboard -> Settings -> Shipping -> Rates
Нажмите Add carrier
Следуйте инструкциям по настройке перевозчика.

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

Настройте зоны доставки

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

Чтобы настроить зоны доставки, выполните следующие шаги:

Перейдите в Dashboard -> Settings -> Shipping -> Locations
Нажмите New zone
Введите имя зоны и выберите страны, в которые вы хотите отправлять товары.
Выберите перевозчика и уровень услуг, который вы хотите предложить.

Дополнительные сведения о зонах доставки см. в нашей документации.

Установите код страны происхождения и HS по умолчанию

Страна происхождения и код HS используются для расчета точных пошлин и налогов.

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

Чтобы установить страну происхождения и код HS по умолчанию:

Перейдите в Dashboard -> Settings -> Shipping -> Catalog.
Для страны происхождения выберите страну, где производится большинство ваших продуктов.
Для кода HS введите код HS вашего наиболее часто используемого продукта. Если у вас нет кода HS, перейдите к Classify в Dashboard и введите название и описание вашего продукта для создания точного кода HS.

Установите фрагмент Zonos JS

Фрагмент Zonos JS представляет собой интеграцию JavaScript на стороне клиента, которая обеспечивает глобальную функциональность оформления заказов на вашем сайте. Она служит мостом между вашей платформой электронной коммерции и сервисами Zonos, выполняя:

Checkout Experience: отрисовывает пользовательский интерфейс оформления заказов и обрабатывает платежи.
Location Services: обнаруживает местоположение посетителя и управляет конвертацией валюты.
Cart Integration: подключается к вашей существующей системе корзины и заказов.
Security: проверяет домены и аутентифицирует запросы API.

Фрагмент загружается асинхронно, чтобы избежать влияния на производительность вашего сайта. Он инициализируется с учетными данными API вашего хранилища и безопасно обрабатывает все взаимодействия на стороне клиента. Реализация предназначена для того, чтобы быть ненавязчивой, требуя минимальных изменений в существующем процессе оформления заказа.

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

Передайте соответствующие ID через ваш customHTML Checkout, чтобы релей знал, для какого свойства/пикселя он будет запускаться:

Пошаговые инструкции для iframe, полный справочник событий (включая сопоставление полезных данных purchase / Purchase) и советы по отладке см. в разделе:

Синхронизируйте отслеживание заказов и статус в Dashboard

Чтобы синхронизировать заказы между вашей системой и Zonos Dashboard, реализуйте эти вызовы API и вебхуки:

Необходимые мутации

Мутация↕	Описание↕
`orderUpdateAccountOrderNumber`	Синхронизирует номер вашего внутреннего заказа с Dashboard. Документация →
`orderAddTrackingNumber`	Требуется только если вы не печатаете этикетки в Dashboard. Обеспечивает отображение отслеживания в Dashboard, чтобы Zonos мог гарантировать расчет вашей финальной стоимости. Документация →

Необходимые вебхуки

Вебхук↕	Описание↕
`ORDER_CREATED`	Необходим для отправки заказов Checkout на вашу внутреннюю платформу. Документация →
`ORDER_STATUS_CHANGED`	Поддерживает синхронизацию вашей системы с Zonos при изменении статуса заказа (например, выполнен, отменен). Документация →

Протестируйте вашу интеграцию

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

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

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

Ниже приведены некоторые часто задаваемые вопросы о процессе интеграции.

Как Zonos обрабатывает подтверждение заказа?

Настройте опыт после покупки в Dashboard -> Settings -> Checkout settings в разделе Success page type. Доступны три варианта:

Show Zonos success page (по умолчанию, рекомендуется) - Zonos отображает встроенную страницу спасибо после размещения заказа. Страница всегда отображается, даже если заказ не импортируется в вашу систему, поэтому покупатель всегда получает подтверждение.
Redirect to a success page - Zonos ждет на короткой экран "Order complete" до создания заказа, а затем перенаправляет на ваш настроенный URL успеха с добавленными zOrderNumber (и orderId для унаследованных корзин) в качестве параметров запроса.
Close the checkout modal - Zonos закрывает свой модал после получения платежа. Если вы также настроите URL успеха, Zonos перенаправит на этот URL сразу после сбора Stripe платежа - без ожидания создания заказа - и добавит zonosCheckoutSessionId в качестве параметра запроса. Используйте этот вариант, когда вы хотите самую быструю передачу на вашу собственную страницу успеха.

Looking up the order from `zonosCheckoutSessionId`

Когда вы используете Close the checkout modal с URL перенаправления, заказ может занять несколько секунд для присоединения к сеансу оформления заказа после перенаправления. Прочитайте zonosCheckoutSessionId из URL и опросите запрос checkoutSession GraphQL с вашего сервера, используя ваш маркер секретных учетных данных, пока заказ не будет готов. Никогда не вызывайте это из браузера - маркер секретных учетных данных должен оставаться на стороне сервера.

1query getCheckoutSession($id: String!) {

2 checkoutSession(id: $id)

3 order

4 id

Отправьте запрос на https://api.zonos.com/graphql с вашим маркером секретных учетных данных из Dashboard -> Settings -> Integrations, переданным как заголовок запроса credentialToken.

Могу ли я получать уведомления о создании заказа?

Да. Если вы хотите получить уведомления при создании заказа, в Dashboard в разделе Email Checkout settings вы можете ввести адрес электронной почты членов команды, которые должны быть уведомлены при создании, отправке или отмене заказа.

Записаться на демонстрацию