Налаштування Checkout

Перевірте схвалення мерчанта та керуйте адресами повернення, гаманцями, брендингом і ключами Checkout у Tapaya Platform.

Відкрийте Checkout у Tapaya Platform. Сторінка показує Organization defaults (типові налаштування організації) і список Checkout merchants (мерчанти Checkout) вашої організації. Виберіть мерчанта, щоб відкрити сторінку його налаштувань. Налаштуйте мерчанта тут, перш ніж інтегрувати Hosted Checkout або Embedded Checkout.

Що потрібно кожній інтеграції

Пройдіть налаштування, які використовує ваша інтеграція, згори донизу:

Налаштування	Hosted Checkout	Embedded Checkout
Онбординг мерчанта до статусу Ready	Обов'язково	Обов'язково
Checkout-ключі мерчанта	Режим мерчанта	Режим мерчанта
Адреси повернення	Обов'язково	Не використовується
Назва для клієнтів	Необов'язково	Необов'язково
Гаманці та зовнішній вигляд	Необов'язково	Необов'язково
Домени магазину для Apple Pay	Не використовується	Для Apple Pay

Режим платформи замість checkout-ключа мерчанта використовує Secret key організації зі сторінки API Keys.

Онбординг мерчанта для Checkout

Пройдіть онбординг мерчанта, вибравши онлайн-платежі або одночасно онлайн-платежі та платежі в торговій точці. Онлайн-онбординг збирає адресу вебсайту магазину та відомості про онлайн-бізнес. Мерчанту, який використовує лише Checkout, термінали не потрібні.

Мерчанти, які запитують онлайн-платежі, автоматично з'являються в Checkout merchants, зокрема ті, що очікують схвалення. Створення запису мерчанта чи checkout-ключа не означає схвалення онлайн-платежів. Саме лише схвалення платежів у торговій точці не вмикає Checkout.

Таблиця показує готовність мерчанта:

Статус	Значення	Наступний крок
Merchant inactive	Обліковий запис мерчанта неактивний.	Вирішіть питання зі статусом облікового запису, перш ніж приймати платежі.
Pending approval	Процесор онлайн-платежів ще не схвалив мерчанта.	Завершіть онбординг і надайте всю запитану інформацію.
No payment gateway	Онлайн-платежі схвалено, але в мерчанта не налаштовано шлюз.	Зв'яжіться з Tapaya, щоб завершити налаштування шлюзу.
Ready	Мерчант активний, онлайн-платежі схвалено, шлюз налаштовано.	Налаштуйте ключі, способи оплати та, за потреби, URL повернення для Hosted Checkout.

Скопіюйте Merchant token для режиму платформи або виберіть Settings, щоб налаштувати мерчанта. Редагувати налаштування Checkout можуть лише адміністратори організації.

Створення checkout-ключів мерчанта

У розділі Settings мерчанта список Merchant checkout keys містить ключі для власного бекенду цього мерчанта. Введіть назву ключа та виберіть Create merchant key. Ключі починаються з tapaya_test_ у пісочниці (sandbox) і з tapaya_live_ у робочому середовищі.

Одразу скопіюйте секрет. Platform показує його лише один раз і зберігає тільки його хеш. Ключ працює лише для свого мерчанта. Відкличте ключ, щоб зупинити запити, які його використовують; інші ключі мерчанта та ключі вашої організації залишаються чинними. Див. автентифікацію Checkout.

Налаштування адрес повернення

Hosted Checkout повертає клієнта до вашого магазину після оплати або коли клієнт залишає сторінку. Вбудовані платежі не використовують URL переспрямування.

Адреси повернення належать до облікових даних, якими створюється сесія:

Облікові дані	Де налаштовуються	На що поширюються
Secret key організації з `X-Tapaya-Merchant-Token` (режим платформи)	Organization defaults › Redirect URLs	Сесії всіх мерчантів, створені бекендом вашої платформи
Checkout-ключ мерчанта	Налаштування мерчанта › Merchant API key redirects	Лише сесії, створені ключами цього мерчанта

Ці два налаштування ніколи не поєднуються, і жодне з них не використовується як резервне для іншого. Сесія в режимі платформи може повернутися лише на дозволені вебсайти організації, а сесія, створена ключем мерчанта, лише на дозволені вебсайти мерчанта. Якщо сесія не містить successUrl або cancelUrl, а її облікові дані не мають типового значення, створення відхиляється.

У розділі для ваших облікових даних додайте свій магазин до Allowed websites, а потім задайте Default success URL і Default cancel URL. Магазин може використовувати, наприклад:

Дозволений вебсайт: https://shop.example.
URL успіху: https://shop.example/checkout/return.
URL скасування: https://shop.example/checkout/cancel.

Дозволений вебсайт є origin: схема, хост і необов'язковий порт, без шляху, запиту чи фрагмента. Порівнюється точний origin, включно з портом. Символи підстановки та суфікси імені хоста не дають збігу. Використовуйте HTTPS для розгорнутих магазинів; HTTP приймається для локальних хостів.

Сесія може перевизначити типові значення за допомогою successUrl або cancelUrl, коли ви її створюєте. Перевизначені значення все одно мають відповідати дозволеному вебсайту тих самих облікових даних. Платформа, яка обслуговує мерчантів на різних шляхах або субдоменах, зазвичай передає обидва URL у кожній сесії.

Статус Ready описує схвалення мерчанта та налаштування шлюзу. Він не підтверджує налаштування ваших URL повернення. Вбудованим платежам URL повернення не потрібні. Сесіям Hosted Checkout потрібні типові значення або явно дозволені URL для облікових даних, які вони використовують.

Відвідування будь-якого з URL повернення не доводить результат платежу. Перш ніж позначити замовлення як оплачене, отримайте сесію на своєму сервері.

Назва для клієнтів

Customer-facing name відображається під час оформлення замовлення та в платіжних гаманцях. Залиште поле порожнім, щоб використовувати юридичну назву мерчанта. Назву в банківській виписці це не змінює.

Гаманці та зовнішній вигляд

Кожен мерчант або вибирає Use organization wallets and appearance, або задає власні налаштування. Цей перемикач не впливає на адреси повернення, які залежать від облікових даних, як описано вище. Назва мерчанта та checkout-ключі завжди задаються окремо для кожного мерчанта.

Organization defaults для гаманців і зовнішнього вигляду застосовуються до кожного мерчанта, який їх використовує, і зміни одразу доходять до цих мерчантів:

Apple Pay і Google Pay. Картки увімкнено завжди.
Hide powered by Tapaya.
Checkout color, шестизначний шістнадцятковий колір, наприклад #1380A5.
Checkout logo, зображення PNG або WebP розміром до 5 МБ. Завантаження та видалення логотипа зберігаються одразу.

Якщо типові налаштування не збережено, гаманці увімкнено, а колір і логотип беруться з брендингу вашої організації.

Кнопка гаманця також залежить від пристрою та браузера клієнта. Увімкнення гаманця не гарантує, що він з'явиться всюди. Google Pay у робочому режимі потребує налаштованого Google Pay merchant ID.

Hosted Checkout використовує всі ці налаштування. Embedded Checkout використовує налаштування гаманців і чинний колір Checkout як акцент фокуса полів картки (colorFocus). Змінні, які ваша сторінка передає в appearance.variables, його перевизначають. Увімкніть кнопки гаманців для вбудованої оплати на своїй сторінці, як описано в розділі Embedded Checkout.

За допомогою Checkout preview перегляньте брендинг і способи оплати в макетах для комп'ютера та мобільних пристроїв.

Реєстрація доменів магазину для Apple Pay

Для Apple Pay в Embedded Checkout зареєструйте кожне ім'я хоста магазину, де з'являється гаманець. Hosted Checkout працює на домені Tapaya. Allowed websites для переспрямувань Hosted Checkout не реєструють домен для Apple Pay.

Відкрийте Settings мерчанта, потім Apple Pay і Shop domains.
Виберіть Add domain і завантажте файл верифікації.
Віддавайте файл без змін і без розширення за адресою https://shop.example/.well-known/apple-developer-merchantid-domain-association. Використовуйте дійсний HTTPS-сертифікат і віддавайте файл напряму, без переспрямувань.
Введіть ім'я хоста, наприклад shop.example, і виберіть Verify and add. Якщо клієнти також використовують www.shop.example, зареєструйте його окремо.
Дочекайтеся, поки домен отримає статус Active, а потім увімкніть Apple Pay. Скористайтеся Check now, щоб діагностувати домен, з яким виникла проблема.

Залишайте файл верифікації доступним і після реєстрації. Кожному мерчанту потрібна власна реєстрація домену, навіть якщо гаманці та зовнішній вигляд беруться з типових налаштувань організації. Перш ніж можна буде зареєструвати домен, мерчант повинен мати налаштований платіжний шлюз.

Чогось бракує на цій сторінці?Надішліть запит на функцію. Ми додамо цю сторінку, щоб команда бачила контекст.