Průvodce integrací služby Smart Checkout

Smart Checkout od Viva.com Vám umožňuje přijímat online platby prostřednictvím hostované platební stránky.

Tento průvodce vysvětluje hlavní kroky integrace Smart Checkout s Vaším webem nebo aplikací – od nastavení Vašeho Viva.com účtu a zdroje plateb až po přesměrování zákazníků a ověření výsledku platby.

Viva.com nabízí dvě prostředí. Ujistěte se, že používáte prostředí, které odpovídá tomu, co chcete provádět.

Při nastavování a testování integrace se ujistěte, že pracujete ve správném prostředí.

Zdroj plateb obsahuje nastavení, která Viva.com používá pro platby prováděné prostřednictvím Vašeho webu nebo aplikace.

Při nastavování zdroje plateb nakonfigurujte svou doménu a URL adresy, na které se mají zákazníci vrátit po dokončení procesu platby.

Například:

Chcete-li vytvořit zdroj plateb pro online platby, přejděte v ovládacím panelu Viva.com na Prodeje > Online platby > Webové stránky / aplikace.

Po vytvoření zdroje plateb si uložte jeho 4místný kód zdroje. Tento kód budete potřebovat při konfiguraci integrace.

Podrobné pokyny k nastavení naleznete v článku Zdroj pro online platby | Viva.com Podpora.

Integrace Smart Checkout se skládá ze tří hlavních kroků:

Než od zákazníka vyžádáte platbu, vytvořte platební příkaz.

Každému platebnímu příkazu je přiřazeno jedinečné 16místné ID nazývané orderCode.

Vytvořte platební příkaz ze svého serveru pomocí Create Payment Order API a poté předejte orderCode svému webu nebo aplikaci.

Informace o parametrech API a podrobnosti o implementaci naleznete na Viva.com Developer Portal. V nabídce vlevo vyberte APIs for payments, poté Payment API. V části Payments vyberte Create payment order.

Po vytvoření platebního příkazu přesměrujte zákazníka na Smart Checkout. Zákazník poté může zadat své platební údaje a dokončit proces platby na stránce Smart Checkout.

Po dokončení procesu platby je zákazník přesměrován na URL adresu nakonfigurovanou pro příslušný výsledek:

Tyto URL adresy můžete nakonfigurovat v ovládacím panelu Viva.com v části Prodeje > Online platby > Webové stránky / aplikace.

Ověřte stav transakce ve svém systému pomocí platebních údajů vrácených službou Viva.com. Informace o transakci používané k ověření zahrnují:

Viva.com nabízí následující způsoby kontroly výsledku platby.

Webhooks umožňují Vašemu systému přijímat oznámení o úspěšných nebo neúspěšných platbách a podporují synchronní i asynchronní platební metody.

Podrobnosti o implementaci, parametrech událostí a ukázkových payloadech naleznete na Viva.com Developer Portal, kde v nabídce vyberte Webhooks For Payments.

Informace o transakci můžete také načíst pomocí Retrieve Transaction API. Informace o parametrech API a podrobnosti o implementaci naleznete na Viva.com Developer Portal. V nabídce vlevo vyberte APIs for payments, poté Payment API. V části Transactions vyberte Retrieve transaction.

Podle potřeb Vaší integrace můžete nakonfigurovat také další nastavení Smart Checkout.

Logo své značky můžete přidat do Smart Checkout prostřednictvím nastavení zdroje plateb. Pokyny naleznete na Viva.com Developer Portal. Přejděte na Tutorials, vyberte Smart Checkout Configuration a poté klikněte na Add your brand logo.

Pro optimální zobrazení nahrajte jasné logo ve vhodné velikosti.

V pokročilém nastavení zdroje plateb můžete nakonfigurovat tlačítko Cancel. Zákazníci tak získají možnost svou objednávku zrušit.

Tlačítko Cancel je podporováno pro přímé integrace Smart Checkout a pluginy pro Shopify a PrestaShop.

Můžete také nakonfigurovat webhooks pro přijímání oznámení o událostech souvisejících se zrušením objednávky. Přejděte na Viva.com Developer Portal, vyberte Webhooks For Payments a poté Order Updated, kde naleznete další informace.

Smart Checkout podporuje také další konfigurace plateb, včetně:

Technické podrobnosti o implementaci a další dostupné konfigurace Smart Checkout naleznete na Viva.com developer portal.

Potřebujete ještě pomoc? Náš tým je Vám k dispozici. Kontaktujte nás prostřednictvím možnosti Napište nám ve svém Viva.com účtu.