Salla Docs
Merchant
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
  • Report Builder
  • App Onboarding
  • Communication Apps
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Component Bundle
  • Change Log
Salla CLI
Merchant
Merchant
  • Merchant API
  • Salla OAuth 2.0
  • Merchant Dashboard
Partner APIs
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
  • Billing System Salla partners
  • Report Builder
  • App Onboarding
  • Communication Apps
Storefront
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Component Bundle
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Merchant Dashboard
  • Embedded SDK
    • Overview
    • Getting Started
    • Installation
    • Authentication
    • App Design Guidelines
    • Create an Embedded App
    • Playground
  • Auth Module
    • Get Token
    • Client Introspect
    • Refresh Token
  • Page Module
    • Iframe Resizing
    • External Redirects
    • Navigation
    • Set Page Title
  • Nav Module
    • Create Navbar Action
    • Listen for Nav Actions
    • Clearing Nav Actions
  • UI Module
    • Confirm Dialogs
    • Toast Notifications
    • Loading States
  • Checkout Module
    • Create Checkout
    • Subscribe for Payment Result
    • Get App Add-ons
  • Endpoints
    • Token Introspect
  • Resources
    • Support
  1. Merchant Dashboard

Checkout Module

The Checkout Module allows your embedded application to initiate Salla's native payment flow directly from within your app. Merchants can purchase addons without leaving the dashboard context.
This module can be accessed via embedded.checkout and includes the following methods:
Create Checkout
Initiate a checkout flow with embedded.checkout.create().
Checkout Results
Listen for payment outcomes with embedded.checkout.onResult().
Get Addons
Fetch available addons with embedded.checkout.getAddons().

How It Works#

1.
Your app calls create() with one or more addon items.
2.
The Salla Dashboard opens its native payment drawer.
3.
The merchant completes the payment (which may include a 3DS redirect).
4.
Your onResult() callback fires with the payment outcome.
💡
Best Practices
Fetch Before Checkout: Call getAddons() first to verify addon availability and display accurate pricing before initiating a checkout.
Always Listen for Results: Register an onResult() handler before calling create() to ensure you capture the payment outcome, especially after 3DS redirects.
Use Context for State Recovery: Pass a context object to create() to restore your app's state after a 3DS redirect (e.g., the current route or selected plan).
Modified at 2026-02-11 20:21:40
Previous
Loading States
Next
Create Checkout