Introduction
Web Checkout SDK is a JavaScript library that lets your customer pay directly in your e-shop — without having to leave for a payment gateway. Simply put: you add a few lines of code and the customer completes the payment in a few seconds.
Main features
The customer stays on your page and pays using one of these methods:
- Apple Pay — payment via Face ID / Touch ID,
- Google Pay — button, payment via Google Wallet,
- Card payment — secure payment form directly on the page.
Additional features
- 3D Secure — handled automatically by the SDK, without developer intervention,
- Surcharge — if the customer enters a card that incurs a surcharge (e.g. business or non-EU card), the SDK automatically displays the surcharge amount before the payment is completed. This feature is optional and is not enabled by default.
- Dynamic amount — change the amount of an already created payment without having to reload the page. This feature must be activated by Comgate.
- Appearance customisation — customise the checkout appearance according to your needs so that it fits the design of your store.
How it works
The whole process has five steps — and the SDK does most of the work for you:
- You add the SDK to your page (script tag or NPM package).
- You prepare HTML containers (empty
<div>elements) where the SDK will render the buttons and form. - You call a single function —
useCheckout()— and pass the required configuration to it. - The SDK renders the buttons and card form itself.
- The customer pays → the SDK tells you the result via a callback (
onPaid,onCancelled, …).
One call to useCheckout() = the entire integration. Nothing more is needed.
Warning
The integration requires JavaScript knowledge and experience with integrating external services. If you do not have the necessary technical skills, please pass this documentation on to your developer, who will know how to proceed.
Features
Apple Pay- Google Pay
- Card payment (Secured Fields)
- 3D Secure (automatic)
Coming soon
- Click to Pay
Compatibility
| Feature | Supported methods |
|---|---|
| Apple Pay | CARD_CZ_COMGATE, CARD_CZ_CSOB_2 |
| Google Pay | CARD_CZ_COMGATE, CARD_CZ_CSOB_2 |
| Card payment | CARD_CZ_COMGATE |