Як підключити платформу інтернет-магазину Shopify до Mergado Editor#

Як згенерувати дані API Shopify для Mergado (з 1 січня 2026 року)?#

Важливі інструкції для підключення#

У поле URLs > App URL вставте: https://app.mergado.com/ 💡Цю URL-адресу потрібно вставити в поле App URL під час створення власного (custom) застосунку в Shopify.
Мінімальні дозволи (scopes), які потрібні Mergado. ⚠️ Без цих дозволів інтеграція не працюватиме.

write_products,read_products,write_markets,read_markets,read_metaobjects

Дозволи (scopes), якщо хочете користуватися також Mergado Marketplaces

read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits

Ця інструкція суворо спирається на офіційну документацію Shopify та актуальний інтерфейс користувача для створення застосунків за допомогою Shopify Developer Dashboard.

Офіційні джерела: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Для кого призначена ця інструкція?#

Ця стаття призначена для:

продавців на Shopify, які хочуть підключити свій інтернет-магазин до Mergado
агенцій і розробників, які налаштовують інтеграцію Shopify ↔ Mergado для клієнтів
будь-кого, кому потрібно отримати токен доступу до API Shopify

Ви створюєте власний (custom) API-застосунок для одного конкретного інтернет-магазину. Застосунок не потрібно публікувати в Shopify App Store.

Що вам знадобиться?#

Обліковий запис Shopify з доступом адміністратора до інтернет-магазину
доступ до Shopify Developer Dashboard

Перш ніж почати: перевірте налаштування ринків (Markets) #

⚠️ Цей крок обов’язковий, щоб Mergado могло імпортувати товари для окремих ринків.

Ще до створення застосунку радимо перевірити налаштування Markets в адмініструванні Shopify.

Що потрібно налаштувати#

Для кожного ринку (Market) , з якого хочете імпортувати товари до Mergado, мають бути:

призначений домен
призначена мова
обидва значення мають бути явно додані до розділу Customized

Недостатньо, щоб вони були лише успадковані з розділу Inherited або встановлені як Primary .

Порядок дій в адмініструванні Shopify#

Відкрийте адміністрування Shopify
У головному лівому меню натисніть Markets
Відкрийте конкретний ринок (наприклад, Czechia )
Прокрутіть до розділу Inherited
Біля позиції Domain / language натисніть значок +
У модальному вікні:

позначте потрібний домен
позначте потрібну мову

Підтвердьте, натиснувши Done
Переконайтеся, що Domain / language перемістилися до розділу Customized
Зміни підтвердьте, натиснувши Save :warning:

Якщо Domain / language залишаться лише в частині Inherited , Shopify API не надасть дані для цього ринку, і Mergado не зможе імпортувати товари.

Крок 1: Відкрийте Shopify Developer Dashboard#

До Shopify Developer Dashboard можна потрапити двома способами:

Варіант А: Прямий доступ#

Відкрийте https://dev.shopify.com/
Увійдіть за допомогою свого облікового запису Shopify
У лівому меню відкрийте розділ Apps

Варіант Б: Через адміністрування Shopify#

Відкрийте адміністрування Shopify свого інтернет-магазину
Перейдіть до Settings → Apps
Натисніть Develop apps
Натисніть Build apps in Dev Dashboard

Крок 2: Створіть новий застосунок#

Переконайтеся, що ви в розділі Apps
Натисніть Create app
Виберіть Start from Dev Dashboard
Введіть назву застосунку (наприклад, Mergado integration)
Натисніть Create

Після створення застосунку вас буде перенаправлено на вкладку Versions.

Крок 3: Створіть версію застосунку й налаштуйте дозволи (scopes) #

Кожен застосунок мусить мати принаймні одну версію, щоб його можна було встановити в інтернет-магазин.

3.1 Налаштування URL-адреси застосунку та вбудовування#

У розділі URLs знайдіть поле App URL
Стандартне значення https://example.com замініть на:

https://app.mergado.com

Цей крок обов’язковий для правильної роботи інтеграції з Mergado . Якщо залишиться стандартне значення, авторизація не працюватиме правильно.

Під полем App URL зніміть позначку з варіанта Embed app in Shopify admin

3.2 Налаштування дозволів доступу#

У розділі Access натисніть Select scopes
У модальному вікні знайдіть і позначте:
- read_products
- write_products
- read_markets
- write_markets
- read_metaobjects
Підтвердьте, натиснувши Done

Ці дозволи потрібні, щоб Mergado могло завантажувати товари й дані, специфічні для окремих ринків.

3.3 Публікація (release) версії #

Прокрутіть сторінку нижче
Натисніть Release
У вікні підтвердження назву версії можна залишити порожньою
Підтвердьте, натиснувши Release

Версію застосунку тепер опубліковано, і вона готова до встановлення.

Крок 4: Встановіть застосунок в інтернет-магазин#

У лівому меню відкрийте Home
Праворуч угорі натисніть Install app
Виберіть інтернет-магазин Shopify, який хочете підключити до Mergado
Вас буде перенаправлено до адміністрування Shopify
Встановлення підтвердьте, натиснувши Install

Застосунок тепер встановлено в інтернет-магазині.

Крок 5: Отримайте дані доступу до API (Client ID і токен)#

Після встановлення застосунку потрібно отримати два значення, які ви використовуватимете для інтеграції з Mergado:

Client ID
Токен доступу до API (Secret)

Порядок дій:

Поверніться до Shopify Developer Dashboard
Відкрийте свій застосунок
Перейдіть до Settings
У розділі Credentials :

скопіюйте значення Client ID (поле розташоване над значенням Secret)
скопіюйте значення Secret

Client ID слугує для ідентифікації застосунку, Secret працює як токен доступу до API. Для правильної роботи інтеграції з Mergado потрібні обидва значення .

Крок 6: Отримайте URL-адресу інтернет-магазину#

Відкрийте адміністрування Shopify підключеного інтернет-магазину
У лівому меню відкрийте Home
У розділі Domains скопіюйте URL-адресу інтернет-магазину

Приклад:

your-store.myshopify.com

Крок 7: Підключіть Shopify до Mergado#

Відкрийте Mergado
Створіть новий проєкт
Як джерело даних виберіть Shopify
Заповніть:
- Shopify URL → вставте URL-адресу інтернет-магазину
- Client ID → вставте скопійований Client ID з Shopify Developer Dashboard
- Client Secret → вставте скопійований Secret
Натисніть Log in

Часті запитання#

Після вибору Market у мене не завантажується мова. Чому? #

Найчастіша причина — у налаштуванні розділу Markets в адмініструванні Shopify.

Якщо Domain / language вказано лише в розділі Inherited і не додано до розділу Customized , Shopify API для цього ринку не надасть дані. Унаслідок цього в Mergado після вибору Market не завантажиться мова.

Рішення:

Відкрийте Shopify admin → Markets
Відкрийте конкретний ринок
Біля позиції Domain / language натисніть +
Виберіть домен і мову
Натисніть Done, а потім Save
Переконайтеся, що позиція перемістилася до розділу Customized
Більше інформації див. у розділі: Перш ніж почати: перевірте налаштування ринків (Markets)

Mergado неправильно завантажує значення деяких metafield. Чому? #

Якщо в деяких metafield відображається правильна назва (key), але значення (value) вказано як ID (наприклад, ["gid://shopify/Metaobject/94942036012"] ) або з’являється повідомлення “Missing required scope” , застосунку бракує дозволу на читання метаоб’єктів.

Потрібно додати ще один scope:

read_metaobjects

Порядок дій:

Перейдіть до Shopify Developer Dashboard
Відкрийте застосунок, створений для інтеграції з Mergado
У лівому меню перейдіть до Versions
Натисніть New version
У розділі Scopes додайте новий scope read_metaobjects
Підтвердьте зміни й завершіть нову версію, натиснувши Release

Після випуску нової версії підключення потрібно знову авторизувати.

Повторна авторизація в Mergado:

Відкрийте розширення Mergado Keychain
Скасуйте наявне з’єднання
Знову заповніть дані для авторизації:

Shopify URL
Client ID
Secret

Увійдіть знову (Log in)

Після додавання scope і повторної авторизації значення metafield завантажуватимуться правильно.