DOCS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для этого:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Required Mutations 

Mutation↕Description↕
orderUpdateAccountOrderNumberSyncs your native account number with Dashboard. Docs →
orderAddTrackingNumberRequired only if you're not printing labels in Dashboard. Ensures tracking shows in Dashboard so Zonos can guarantee your landed cost calculations. Docs →

Required Webhooks 

Webhook↕Description↕
ORDER_CREATEDNeeded to send Checkout orders to your native platform. Docs →
ORDER_STATUS_CHANGEDKeeps your system in sync with Zonos when order statuses change (e.g., fulfilled, canceled). Docs →

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

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

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

How does Zonos handle order confirmation? 

Настройте опыт после покупки в 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 )
3 order
4 id

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

Can I be notified when an order is created? 

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

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

Была ли эта страница полезной?

Получить поддержку·Юридические документы·© 2026 Zonos
На этой странице:
  • Создайте учетную запись Zonos
  • Настройте параметры Dashboard и Checkout
  • Установите фрагмент Zonos JS
  • Настройте Hello
  • Настройте Checkout
  • Синхронизируйте отслеживание заказов и статус в Dashboard