# Welcome 👋


![image.png](https://api.apidog.com/api/v1/projects/451700/resources/377071/image-preview)

Welcome to [Salla](https://salla.sa/) [Partners'](https://salla.partners/) documentation. Here, you will discover a comprehensive collection of guidelines for developing [Apps](https://docs.salla.dev/doc-421410?nav=01HNA8M216X4HFNGWM9TWSTCKQ) and [Themes](https://docs.salla.dev/doc-421877?nav=01HNFTD5Y5ESFQS3P9MJ0721VM) for [Salla Online Stores](https://salla.sa/). 
:::info[Note]
This resource is designed to support both developers and business owners who aim to integrate with the [Salla](https://salla.sa/) Platform.
:::

Whether you're starting a new project or improving your current e-commerce solution, this collection provides essential insights and instructions. Designed to simplify your integration with Salla, these guidelines cover everything from technical requirements to seamless execution, ensuring a smoother development process.




<!-- focus: false -->
![](https://cdn.salla.network/docs/MerchantAPI/Banner-getting-started.svg)



[Salla](https://salla.sa/) empowers its e-commerce platform for developers while allowing merchants to establish, operate, and manage their online stores with no technical hassle. Moreover, it grants them the ability to enable (or disable) the connection with any logistics company and/or payment gateway with a click of a button.


:::note[Good To Know]
Visit the [Salla Partners Blog](https://salla.dev/blog/) to check out the latest updates on the [Salla developers community](https://t.me/salladev).

:::





## 📝 Salla Documentations

<CardGroup cols={3}>
  <Card title="Salla Merchant API" href="https://docs.salla.dev/doc-426392" Icon icon="material-outline-api">
    Salla Merchant APIs are RESTful endpoints for secure, fast access to Merchant data.
  </Card>
    
     <Card title="Embedded SDK" href="https://docs.salla.dev/embedded-sdk/overview" Icon icon="material-outline-close_fullscreen">
   Salla Embedded SDK helps embedded apps integrate seamlessly with the Salla Dashboard.
  </Card>   
  <Card title="Report Builder" href="https://docs.salla.dev/2140725m0?nav=01KR616DXMV8EZG9Z1NQNQXPZ9" Icon icon="material-outline-assignment">
   Report Creator lets developers build custom analytics and reports that appear directly in the Salla Merchant Dashboard.
  </Card> 
     <Card title="Salla OAuth 2.0" href="https://docs.salla.dev/doc-421118" Icon icon="material-outline-lock">
   Learn how to authenticate Salla Apps using OAuth 2.0, manage access tokens, and securely access merchant data.
  </Card> 

  <Card title="Apps API" href="https://docs.salla.dev/doc-421412/?nav=01HNA8M216X4HFNGWM9TWSTCKQ" Icon icon="material-outline-sync_alt">
    Partner Portal features including App Settings, Subscriptions, and App Events.
  </Card>

  <Card title="Salla Shipping and Fulfillment API" href="https://docs.salla.dev/doc-422988/?nav=01HNA8MH78MVX1S0DRXDHE3A1K" Icon icon="material-outline-local_shipping">
    Manage and track shipments and orders seamlessly.
  </Card>

  <Card title="Salla CLI" href="https://docs.salla.dev/doc-429774/?nav=01HNA8QHCPJTCY5VSEZ616JCAK" Icon icon="material-outline-code">
    CLI tool for creating, testing, and publishing Salla Apps and Themes.
  </Card>

  <Card title="Twilight Engine" href="https://docs.salla.dev/doc-422053/?nav=01HNFTD5Y5ESFQS3P9MJ0721VM" Icon icon="material-outline-border_style">
    Build and customize themes for Salla stores.
  </Card>

  <Card title="Twilight SDK" href="https://docs.salla.dev/doc-422610/?nav=01HNFTDZPB31Y2E120R84YXKCX" Icon icon="material-outline-build_circle">
    JavaScript SDK for storefront APIs and frontend-backend communication.
  </Card>

  <Card title="Twilight Web Components" href="https://docs.salla.dev/doc-422688/?nav=01HNFTE06J4QC24T0D5BPRYKMD" Icon icon="material-outline-view_compact">
    Prebuilt web components such as login forms, search bars, and localization menus.
  </Card>
    
     <Card title="E-commerce Events" href="https://docs.salla.dev/1724365m0" Icon icon="material-outline-event_available">
   Capture and process e-commerce events in real time through client-side or server-side integrations.
  </Card>  
         <Card title="Component Bundle" href="https://docs.salla.dev/2140782m0?nav=01KGPCWMCJ29FN4A2BYME7JQYW" Icon icon="material-outline-group_work">
   Create and publish reusable theme component bundles for the Salla Themes Marketplace.
  </Card>  
    <Card title="Checkout APIs" href="https://docs.salla.dev/2129395m0" Icon icon="material-outline-shopping_cart_checkout">
   Manage carts, products, discounts, and checkout flows through the Checkout APIs.
  </Card> 
<Card title="App Functions" href="https://docs.salla.dev/1726817m0" Icon icon="material-outline-apps_outage">
   Run custom serverless logic in response to Salla events.
  </Card> 
    
        
    <Card title="Communication Apps" href="https://docs.salla.dev/2006115m0" Icon icon="material-outline-comment">
   Communication Apps let developers handle SMS, Email, and WhatsApp delivery through their own providers using Salla App Functions.
  </Card>
    
    
</CardGroup>

<CardGroup cols={2}>
    
<Card title="Salla AWB" href="https://docs.salla.dev/1792089m0?nav=01KATGDQ3GEW2R20XFAAJZJR9K" Icon icon="material-outline-newspaper">
   Integrate shipping providers into Salla’s AWB workflow with App Functions.
  </Card> 
<Card title="Recurring Payments" href="https://docs.salla.dev/1650500m0" Icon icon="material-outline-payment">
   Manage subscriptions, renewals, and recurring payments through Salla APIs.
  </Card>
 
</CardGroup>
<!--

| Documentation                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Salla Merchant API](https://docs.salla.dev/doc-426392)                                                 | Salla Merchant APIs are a suite of RESTful endpoints purpose-built for secure, fast, and easy access to Merchant data. Developers can build their Apps by consuming Salla's standard APIs, scale their Apps to encompass a mass base of over 60,000 online stores, and publish their innovations to one central hub, the Salla App Store.<TipInfo>Read about Salla APIs Docs [here](https://salladev.hashnode.dev/review-on-salla-merchants-apis )</TipInfo>|
| [Apps API](https://docs.salla.dev/doc-421412/?nav=01HNA8M216X4HFNGWM9TWSTCKQ)                           | The Apps API enables the use of functionalities within the Salla Partners Portal, such as [App Settings](https://salla.dev/blog/how-to-build-app-settings-form/) and [Subscriptions](https://salla.dev/blog/partners-portal-hidden-gem/), to customize and enhance your applications usage for [Salla Merchants](https://salla.sa). Additionally, discover the [App Events](https://docs.salla.dev/doc-421413/?nav=01HNA8M216X4HFNGWM9TWSTCKQ) that will be sent from the [Salla Partners Portal](https://salla.partners) concerning any activities related to your app.                                                                                                                                                                                                                                                                                    |
| [Salla Shipping and Fulfillment API](https://docs.salla.dev/doc-422988/?nav=01HNA8MH78MVX1S0DRXDHE3A1K) | Salla Shipping and Fulfillment API  enable you to manage and track Salla Store's **shipments and orders** seamlessly. With this API, you can integrate with a [Salla](https://salla.sa/) Store's shipping process to make shipping as well as order fulfillment more efficient and streamlined.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [Salla CLI](https://docs.salla.dev/doc-429774/?nav=01HNA8QHCPJTCY5VSEZ616JCAK)                          | Salla CLI is a tool designed for developers to create Salla Apps and Themes. Once the App or Theme has been developed, it can go through the publication process to be featured in the Salla App Store. This process typically involves testing, quality assurance, and verification of the App or Theme to ensure that it meets the necessary [standards and guidelines](https://salla.dev/blog/standards-salla-apps-publications/). Once the App or Theme has been approved, it can be published in the [Salla App Store](https://apps.salla.sa/) and made available for installation in any of the Salla Merchant Stores. This gives the flexibility for merchants and other users who use the Salla Platform to be able to easily install and customize their store with a variety of apps or themes that can match their needs. |
| [Twilight Engine](https://docs.salla.dev/doc-422053/?nav=01HNFTD5Y5ESFQS3P9MJ0721VM)                    | Twilight enables developers to create a memorable experience for the [Salla Store](https://salla.sa/)'s look and feel for the benefit of merchants and their customers. Developers can create themes for merchant stores to suit the uniqueness of each store on the Salla Platform. With custom themes, developers will have a much easier time adapting the merchant's store to the store's growing needs as time goes on. This documentation covers several topics, from creating a complete theme for Salla's Store with easy steps to changing multiple items in the store with your own style.                                                                                                                                                                                                                                 |
| [Twilight SDK](https://docs.salla.dev/doc-422610/?nav=01HNFTDZPB31Y2E120R84YXKCX)                       | Twilight comes with a JavaScript SDK for the Salla storefront APIs. This is to provide the developers with helper methods, or REST API endpoints, that allow communication between the frontend and backend.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| [Twilight Web Components](https://docs.salla.dev/doc-422688/?nav=01HNFTE06J4QC24T0D5BPRYKMD)            | Twilight comes with a ready-designed and styled set of web components for Salla stores. For example, ready components to display the [login form](https://docs.salla.dev/doc-422711/?nav=01HNFTE06J4QC24T0D5BPRYKMD), [product availability](https://docs.salla.dev/doc-422717/?nav=01HNFTE06J4QC24T0D5BPRYKMD) section, [search bar](doc-422730/?nav=01HNFTE06J4QC24T0D5BPRYKMD), [localization menu](https://docs.salla.dev/doc-422710/?nav=01HNFTE06J4QC24T0D5BPRYKMD), and many more                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-->

## ⚒️ Resources

Utilize the following materials to familiarize yourself with the Merchant APIs: a compilation of curated blogs, a list of frequently asked questions, and a community of developers that is always willing to offer assistance:

<CardGroup cols={2}>
  <Card title="Salla Partners Resources" href="https://portal.salla.partners/help/resources">

  </Card>
  <Card title="Salla Developer Blog" href="https://salla.dev/blog/">
    
  </Card>
  <Card title="Frequently Asked Questions" href="https://portal.salla.partners/help/faq">
    
  </Card>
  <Card title="Global Developer Community" href="https://t.me/salladev">
    
  </Card>
</CardGroup>


## 💡 Contact Support
Contact support either at [support@salla.dev](mailto:support@salla.dev) or the [Global Developers Community](https://t.me/salladev) on Telegram to get help from our team of in-house experts.

## 🔗 Service Status
Check current Salla service status from [Salla Status](https://status.salla.sa/).