> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plata-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Підключення Shopify

> Створення Shopify App, Install, Client ID/Secret і OAuth для магазину в plata.

Підключення відбувається через **ваш власний Shopify-застосунок**. Це дає offline-токен і можливість змінювати тему (inject скрипта).

## Крок 1. Відкрийте «Додати магазин»

1. Увійдіть у [кабінет](https://app.plata-app.com).
2. Відкрийте **Додати магазин** (`/{username}/~/add-store`).
3. На екрані з’являться готові значення для копіювання:
   * **App URL**
   * **Allowed redirection URL** (callback)
   * **Scopes**

Залиште цю вкладку відкритою — значення потрібні в Shopify.

## Крок 2. Створіть застосунок у Shopify

1. Відкрийте [dev.shopify.com/dashboard](https://dev.shopify.com/dashboard).
2. Створіть **новий app**.
3. У налаштуваннях URL вставте з plata:
   * **App URL** → як на екрані «Додати магазин»
   * **Allowed redirection URL(s)** → callback API (`…/shopify/callback`)
4. Додайте **Scopes** рівно з поля на екрані plata (потрібні зокрема `read_themes`, `write_themes`, orders, products, Storefront unauthenticated scopes).
5. Переконайтесь, що **Embed app in Shopify admin** — **вимкнено**. plata працює в окремому кабінеті, не всередині адмінки Shopify.

## Крок 3. Встановіть застосунок на магазин

1. У Dev Dashboard натисніть **Install** і оберіть свій store.
2. Підтвердіть доступ (scopes).
3. Shopify відкриє **App URL** з параметрами `shop` і `hmac` — ви знову на сторінці plata, але вже з формою підключення.

## Крок 4. Client ID і Client Secret

1. У Shopify Dev Dashboard скопіюйте **Client ID** і **Client Secret** вашого app.
2. Вставте їх у форму plata.
3. Натисніть підключити / продовжити.

plata перевірить HMAC launch-параметрів секретом, створить pending install і відправить вас на OAuth consent.

## Крок 5. OAuth і повернення

1. Підтвердіть доступ у Shopify.
2. Callback (`/shopify/callback`) зберігає магазин, реєструє webhooks і **інжектить** checkout-скрипт у активну тему.
3. Вас поверне на сторінку магазину в кабінеті (`/{username}/{storeSlug}`).

<Check>
  Магазин у списку зі статусом активний, у темі з’явились `plata-script.js` і snippet `plata-checkout`.
</Check>

## Що далі

1. [Підключити інтеграції](/liquid/integrations)
2. [Перевірити скрипти](/liquid/scripts)
3. [Зробити тестове замовлення](/liquid/test-checkout)

<Tip>
  Якщо магазин уже підключений до **іншого** акаунта plata, форма покаже помилку власності. Зверніться в підтримку або використайте той акаунт, який підключав магазин раніше.
</Tip>