Integration GuideAPI Reference
Integration Guide

Hosted Checkout Integration

๐Ÿ““

Hosted Checkout integration allows the partner to initiate a payment through our API and receive a checkout link in response.

The partner then redirects the payer to our hosted checkout page, where we manage the payment flow, including payer input, payment method handling, and any required authentication steps.

UI Example

This image is for reference purposes only. The final appearance and configuration of the checkout form may vary and can be customised based on your requirements.


Host-to-Host vs Hosted Checkout - Key Differences

AspectHost-to-Host (H2H)Hosted Checkout
Who handles the checkout flowMerchant / PSPOur platform
Main request objectPaymentPaymentIntent
Payment details provided upfrontYesNo, payer completes them later on the checkout form
When the actual Payment is createdDuring the initial API requestAfter the payer starts and completes the checkout flow
Typical use caseMerchant fully controls the payment experienceMerchant redirects the payer to our hosted checkout form

Supported Payment Methods

Payment MethodAvailability Status
Bank CardsBank Cards ๐Ÿ‡ท๐Ÿ‡บ Russia (RUB) - Available
๐Ÿ‡ฐ๐Ÿ‡ฟ Kazakhstan (KZT) - Available
๐Ÿ‡บ๐Ÿ‡ฟ Uzbekistan (UZS) - Will become available later

Checkout form customisation

๐Ÿ“˜

How to request changes

Self-service customisation is not available.
All changes are applied by our team โ€” contact your Integration Manager to request any update below.

The checkout form supports configurable language, displayed information, visual theme, external links, session lifetime, and post-payment return behaviour.

Configurable settings

Status legend: โ— Available ยท โ— Available with limitations ยท โ— Coming soon

SettingDefault behaviourStatus
Form LanguageFollows the payer's browser locale. Supported: RU, ENG, System.โ— Available
Language SelectorShown when locale is System; hidden if a specific language is forced.โ— Available
AppearanceFollows the payer's OS theme. Supported: light, dark, system. Selector shown when system; hidden if a specific theme is forced.โ— Available
Store NameHidden. Shown when the merchant's store name is configured on the account.โ— Available
Order NumberHidden. When enabled, sourced from clientReferenceId on the Intent.โ— Coming soon
Order DescriptionSourced from description on the payment Intent first, then the parent Intent. Hidden if neither is supplied. No explicit toggle.โ— Coming soon
Terms & Conditions URLLink hidden unless a URL is supplied.โ— Available
Privacy Policy URLLink hidden unless a URL is supplied.โ— Available
Legal URLLink hidden unless a URL is supplied.โ— Available
Contacts URLLink hidden unless a URL is supplied.โ— Available
Powered By SectionShown โ€” defaults to "Powered by Carusell" if no custom text is supplied.โ— Limited โ€” text only, no logo.
Session Lifetime20 minutes. After expiry, the session is unusable and a new Intent is required.โ— Available
Back to Store ButtonHidden. Requires a return URL on the Intent โ€” without it, the button cannot be shown.โ— Available
Auto-redirect to StoreDisabled. The completion screen stays until the payer leaves.โ— Coming soon
Auto-redirect DelayDepends on Auto-redirect to Store.โ— Coming soon