API Reference
Log in
API Reference

Overview

Currently, Subotiz supports two integration modes: ​​Checkout​​ and ​​Payment​​.

Checkout mode

Checkout is Subotiz's end-to-end transaction solution designed for subscription-based businesses. Its core strength lies in ​​integrating product management, subscription lifecycle management, multi-provider payment processing, and global operational capabilities​​. Ideal for scenarios requiring complete transaction closure (e.g., AI tools, SaaS platforms, Web3 applications).

​​Core Capabilities Include:​​

  • ​​Product & Subscription Management​​: Create products, configure flexible pricing (free trials, tiered pricing, coupons), and manage subscription cycles (monthly/annual) with mid-cycle adjustments.

  • ​​Smart Checkout Experience​​: Customizable checkout flows (standard/express/two-step), mobile-optimized layouts, and built-in global tax compliance.

  • ​​Multi-Payment Methods​​: Credit and debit cards, PayPal, Apple Pay, Google Pay, etc., with intelligent routing to boost success rates.

  • ​​Globalization​​: Auto-switching for 18+ languages (CN/EN/JP/ES) and multi-currency support.

​​Integration Methods:​​

  • Hosted Page: Subotiz provides a hosted checkout page. Merchants create a Checkout Session via API and then redirect customers to this hosted page to complete payment, eliminating frontend development efforts.

  • Embedded Form: Embed the checkout functionality directly into your own web pages using our SDKs. Supports interface customization (styles, components, flow) via a no-code editor, ensuring full brand consistency.

DimensionHosted PageEmbedded Form
TechnicalLow (API+Webhook only; no fronted development)Medium (SDK integration; no-code editor available)
CustomizationMedium ( logo/colors; fixed flow)High (Full UI styling, component layout, interaction flow)
Brand identityMediumHigh(Fully embedded in merchant pages)
Development1-3 days (API focus)3-7 days ( UI customization + testing)
CasesSMBs need a rapid launchBrands requiring deep customization with front-end resources

Payment mode

Payment is Subotiz's ​​lightweight solution focused strictly on payment processing​​. Core capabilities cover collections, refunds, reconciliations, and seamless tokenized renewals (no repeated payment info collection). Excludes product/subscription management. Ideal for merchants with existing systems (e.g., ERP/CRM) needing only payment processing.

​​Core Advantages:​​

  • Multi-Channel Support​​: Shared payment network with Checkout (cards, Google/Apple Pay).

  • ​​Seamless Embedding​​: Fully custom UI with no Subotiz branding.

Integration Methods:

DimensionEmbedded Form (Payment mode)
TechnicalMedium (SDK integration + renewal logic)
CustomizationHigh(Fully merchant-designed UI; zero Subotiz branding)
Key AdvantageTokenized renewals​ + multiple payment providers
Development3-5 days (SDK + logic adaptation)
CasesEnterprises with existing subscription systems

Comparison

DimensionCheckoutPayment
ScopeFull cycle ( Products + Subscriptions + Payments)Payments only (Incl. renewals)
ValueSimplify conversion optimization to boost subscription conversion rateIntegrate with the existing system. More focus on payment efficiency and renewal stability
SubscriptionBuilt-in (Plans, modifications, auto-renewals)None (Self-managed)
CustomizationNo-code checkout editor: Supports customizing checkout flow and UI styleFor the payment interface only
Global supportMulti-language/currency/tax complianceMulti-language/currency/tax compliance
IntegrationHosted + EmbeddedEmbedded only

Scenario Matching Guide

Checkout Mode Recommendations​

  • ​​Business Types​​: SaaS, AI tools, Web3 apps, mobile games

  • ​​Needs​​: Product catalog/subscription management or checkout optimization

  • ​​Tech Resources​​: Limited frontend capacity or no-code preference

  • Globalization​​: Multi-region customers needing local payment methods

Payment Mode Recommendations​

  • ​​Business Types​​: Enterprises with mature subscription systems

  • ​​Needs​​: Pure payment processing capability

  • ​​Tech Resources​​: Frontend capacity for custom UI design

  • Brand Control​​: Zero third-party page redirection