Hosted-чекаут

Hosted-чекаут — це готова платіжна сторінка Tranzzo, на яку ви перенаправляєте свого клієнта для проведення оплати.

Як отримати URL на платіжну сторінку:

через API-інтеграцію: у відповіді на hosted-запит створення платежу,
через мерчант-портал за допомогою сервісу створення платіжних посилань.

Hosted-чекаут включає:

Інформацію про замовлення (номер, опис).
Суму платежу.
Платіжні методи, що налаштовані на вашому проєкті.
Форму для збору даних про платника (опційно)

Функціонал, що підтримується на hosted-чекаутах:

Оплата картками та альтернативними платіжними методами.
Валідація карткових даних.
Повідомлення про помилки.
Безпека даних відповідно до стандартів PCI DSS.
Підтримка різних мов.
Оплата збереженими картками.
Можливість роботи з вільною сумою.
Управління result-page.
Можливість перекласти сплату комісії на клієнта.
Збір даних про платників.
Автоматична переадресація клієнтів на ваш сайт після оплати.

Кастомізація hosted-чекаута:

Розміщення платіжної сторінки на вашому субдомені: наприклад, pay.example.com, checkout.example.com.
Брендований фавікон (потребує зображення у ico-форматі).
Ваш логотип (потребує зображення у svg-форматі).
Фірмові кольори прелоадера та кнопки оплати (потребує інформації про колір у hex-форматі).

Щоб кастомізувати чекаут для свого проєкту, напишіть у Службу підтримки Tranzzo та вкажіть бажані параметри кастомізації.

Важливо

При використанні hosted-чекаута в режимі iframe або платіжного віджета, з міркувань безпеки метод Apple Pay підтримується лише на пристроях з Safari версій 17 та вище.

Важливо

Платіжний метод Google Pay не підтримується при використанні рішення, що передбачає відображення чекаута в режимі WebView у мобільних застосунках на Android. Щоб скористатися цим методом рекомендуємо використовувати інтеграцію через Мобільний SDK.

При використанні hosted-чекаута в режимі iframe є можливість отримання івентів про статус платежу. Для того, щоб їх отримувати, необхідно в запиті на виклик чекаута в iframe передати інформацію про домен, на якому чекаут відкривається та де будуть отримуватись відповідні івенти, у форматі: ?parentOrigin=https://example.com"

Приклад виклику чекаута в режимі iframe:

<iframe src="https://cpay-stg.tranzzo.com/api/v1/checkout/.../form?parentOrigin=https://example.com"></iframe>

Hosted-чекаут у iframe-режимі підтримує відправку таких івентів:

Event status name	Description
`payment.success`	Payment has been successfully completed
`payment.failed`	Payment has failed. It also contains error code (errorCode) and its description (errorMessage)
`payment.redirect`	Payer was redirected to 3ds page

Приклад івенту при неуспішній оплаті:

{
    status: 'payment:failed',
    errorCode: '123',
    errorMessage: 'Insufficient funds'
}