Після оплати: своя Thank You сторінка

1. Повернення на ваш сайт

Вкажіть адресу сторінки, куди веде кнопка «Повернутися до магазину». За бажанням увімкніть автоперехід — через 3–10 секунд після підтвердження оплати. До адреси додаються два параметри:

https://ваш-сайт.com/order-success?splata_order=ks_…&splata_token=spo_…

• splata_order — id покупки в Splata;
• splata_token — токен саме цієї покупки: з ним ваша сторінка може прочитати її дані.

2. Своя Thank You сторінка

Прочитайте параметри з адреси й запитайте дані покупки — прямо з браузера, свій сервер не потрібен:

const q = new URLSearchParams(location.search);
const order = q.get("splata_order");
const token = q.get("splata_token");

async function loadOrder() {
  const url = `https://splata.app/api/session/${order}/receipt?token=${token}`;
  for (let attempt = 0; attempt < 5; attempt++) {
    const res = await fetch(url);
    if (!res.ok) return null; // невідома покупка або чужий токен
    const r = await res.json();
    // Замовлення в Shopify з'являється за кілька секунд після оплати
    if (r.orderStatus !== "creating") return r;
    await new Promise((ok) => setTimeout(ok, 2000));
  }
  return null;
}

Відповідь:

{
  "orderRef": "ks_2m4qz8p0k6vhc7wf3jrd",
  "completed": true,
  "paid": true,
  "cod": false,
  "test": false,
  "orderStatus": "created",
  "orderNumber": "#1001",
  "currency": "UAH",
  "totalUah": 2970,
  "discountCode": "SALE",
  "items": [
    { "variantId": "4401", "title": "Сукня", "quantity": 2, "priceUah": 1500 }
  ],
  "shopifyOrderId": "6123456789"
}

• completed — покупку завершено: оплачено карткою або оформлено післяплатою.
• paid — гроші списано повністю. Для післяплати — false, cod — true.
• test — «Тестова оплата»: таке замовлення не відправляйте.
• orderStatus — creating: замовлення в Shopify ще створюється (перші секунди), created: готово.
• orderNumber — номер, який покупець бачить у листі Shopify.
• totalUah — сума з доставкою і знижкою; items — товари.

Імені, телефону, адреси й email покупця у відповіді немає — їх бачить лише ваша адмінка Shopify. Токен відкриває тільки одну покупку, а за номером замовлення дані не віддаються.

3. Перевірка з вашого сервера

Якщо за покупку ви щось видаєте (бонуси, доступ, промокод) — перевіряйте її на своєму сервері, а не в браузері: код сторінки покупець може змінити. Для цього в «Після оплати» є ключ для перевірки покупок:

curl https://splata.app/api/session/ks_…/receipt \
  -H "X-Splata-Key: spk_…"

Ключ відкриває будь-яку покупку вашого магазину, тому лише на сервері — не вставляйте його в код сайту. Якщо ключ потрапив не туди — натисніть «Новий ключ», старий перестане працювати протягом хвилини.

4. Google Analytics 4 і Google Ads

Вкажіть ID GA4 (G-…) і конверсію Google Ads (AW-…/мітка). Подію purchase надсилаємо ми зі сторінки подяки — лише після того, як банк підтвердив оплату, один раз на покупку, навіть якщо покупець не повернеться на сайт. Тестові оплати не надсилаються.

У події: transaction_id (= splata_order), value, currency UAH, shipping (доставка), items і coupon, якщо був промокод. Що можна змінити в «Після оплати»:

• Сума покупки — з доставкою (за замовчуванням) або без неї.
• Післяплата — за замовчуванням рахується як покупка, можна вимкнути.
• Покращені конверсії Google Ads — за замовчуванням вимкнено. Якщо увімкнути, ми передаємо email і телефон покупця, Google хешує їх перед відправкою. Увімкніть їх і в Google Ads (Цілі → Налаштування).

Щоб не було дублів, зі свого сайту purchase не надсилайте (сторінка після оплати, GTM, застосунок Google у Shopify). Якщо все ж надсилаєте — ставте transaction_id = splata_order. Щоб реклама точно звʼязалась із покупкою, підключіть домен чекаута на піддомені свого сайту (Налаштування → «Домен чекаута»).

5. Замовлення у вашій системі

Замовлення створюється у вашому Shopify, тож для CRM, складу чи розсилок беріть його з вебхука Shopify orders/create — він приходить, навіть якщо покупець закрив вкладку. Покупку з замовленням звʼязує тег kasa-session:<splata_order>.

Google Tag Manager

На сторінці оплати не вмикаємо: там покупець вводить свої дані, а контейнер GTM може запустити будь-який скрипт. Для GA4 і Google Ads він не потрібен.

Питання — у Telegram @splata_supportbot.