Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Merchant API
  • Welcome 👋
  • Get Started
  • Create Your First App
  • Authorization
  • Webhooks
  • Conditional Webhooks
  • Security Considerations
  • Multi-Language Support
  • Responses
  • Pagination
  • Rate Limiting
  • Versioning
  • Change Log
  • Support
  • APIs
    • Orders
      • Create Order
      • List Orders
      • Order Details
      • Create Drafted Order
      • Update Order
      • Duplicate Order
      • Order Actions
    • Order Status
      • Update Order Status
      • Create Custom Order Status
      • List Order Statuses
      • Order Status Details
      • Update Custom Order Status
      • Update Bulk Orders Statuses
      • Sort Orders Statuses
    • Order Histories
      • List Order Histories
      • Create Order History
    • Order Tags
      • Create Order Tag
      • List Order Tags
      • Delete Order Tag
    • Order Invoice
      • Create Invoice
      • List Invoices
      • Invoice Details
      • Send Order Invoice
      • Create Order Invoice
    • Order Reservations
      • List Order Reservations
    • Order Items
      • List Order Items
      • Create Order Item
      • Update Order Item
      • Delete Order Item
    • Products
      • Create Product
      • List Products
      • Product Details
      • Update Product
      • Delete Product
      • Change Product Status
      • Product Details By SKU
      • Update Product By SKU
      • Delete Product By SKU
      • Update Product Price By SKU
      • Update Bulk Product Prices
      • Import Products
      • Bulk Product Actions
    • Product Options
      • Create Product Option
      • Product Option Details
      • Update Product Option
      • Delete Product Option
    • Product Quantity
      • List Product Quantities
      • Update Bulk Quantities
      • List Quantity Change Reasons
      • List Quantity Audit
      • Update Bulk Quantities by SKU
      • Update Quantity
      • Update Quantity By SKU
    • Product Variants
      • List Product Variants
      • Product Variant Details
      • Update Product Variant
      • Update Product Variant Quantity
    • Product Tags
      • Create Product Tag
      • List Product Tags
    • Product Images
      • Attach Image by SKU
      • Attach Video by SKU
      • Attach Youtube Video
      • Attach Image
      • Update Image
      • Delete Image
    • Product Option Values
      • Create Product Option Value
      • Product Option Value Details
      • Update Product Option Value
      • Delete Product Option Value
    • Abandoned Carts
      • List Abandoned Carts
      • Abandoned Cart Details
    • Customer Groups
      • Create Customer Group
      • List Customer Groups
      • Add Customers To Group Customer
      • Update Default Customer Group
      • Update Customer Group
      • Delete Customer Group
    • Customers
      • Create Customer
      • List Customers
      • Customer Details
      • Update Customer
      • Delete Customer
      • Ban Customer
      • Un-Ban customer
      • Import Customers
    • Digitals Product
      • Attach Digital Code
      • Attach Digital File
      • Delete Digital File
    • Categories
      • Create Category
      • List Categories
      • Category Details
      • Update Category
      • Delete Category
      • Category Children
      • Categories Search
      • List Category Products
    • Exports
      • Export Orders
      • Exports Logs
      • List Export Templates
      • Create Export Template
      • Update Export Template
      • Delete Export Template
      • List Export Columns
      • Export Customers
      • Export Custom URLs
      • Export Products
    • Shipments
      • Create Shipment
      • List Shipments
      • Shipment Details
      • Shipment Tracking
      • Update Shipment Details
      • Cancel Shipment
      • Return Shipment
    • Shipping Companies
      • List Shipping Companies
      • Shipping Company Details
      • List Estimate Rates
      • Create Shipping Company
      • Update Shipping Company
      • Delete Shipping Company
      • Shipping Company Options
    • Shipping Zones
      • Create Shipping Zone
      • List Shipping Zones
      • Shipping Zone Details
      • Update Shipping Zone
      • Delete Shipping Zone
    • Shipping Rules
      • List Shipping Rules
      • Shipping Rule Details
      • Delete Shipping Rule
    • Countries
      • List Countries
      • Country Details
    • Product Option Templates
      • List Option Templates
      • Option Template Details
      • Delete Option Template
      • Update Option Template
      • Create Option Template
    • Taxes
      • Create Tax
      • List Taxes
      • Tax Details
      • Update Tax
      • Delete Tax
    • Coupons
      • Create Coupon
      • List Coupons
      • Coupon Details
      • Update Coupon
      • Delete Coupon
      • List Coupon Codes
    • Affiliates
      • List Affiliates
      • Affiliate Details
      • Create Affiliate
      • Update Affiliate
      • Delete Affiliate
    • Order Assignment
      • List Auto Assignment Rules
      • Order Assigned Employees Details
      • Update Auto Assignment Rule
      • Create Auto Assignment Rules
    • Special Offers
      • Create Special Offer
      • List Special Offers
      • Special Offer Details
      • Update Special Offer
      • Delete Special Offer
      • Change Special Offer Status
    • Transactions
      • List Transactions
      • Transaction Details
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank Details
    • Settlements
      • List Instant Settlements
      • Create Instant Settlement
      • Update Instant Settlement
      • Instant Settlement Details
    • Settings
      • Settings List
      • Update Setting Slug
      • Setting Details
    • Merchant
      • User Information Details
      • Store Information
    • Brands
      • Create Brand
      • List Brands
      • Brand Details
      • Update Brand
      • Delete Brand
    • Branches
      • Create Branch
      • List Branches
      • Branch Details
      • Update Branch
      • Delete Branch
    • Currencies
      • Activate Currencies
      • List Currencies
      • List Available Currencies
    • SEO
      • List SEO Settings
      • Update SEO Settings
    • Cities
      • List Cities
    • DNS Records
      • List DNS Records
      • Create DNS Record
      • Delete DNS Record
    • Languages
      • Add Language
      • List Languages
      • Update Language
    • Employees
      • List Employees
    • Advertisements
      • Create Advertisement
      • List Advertisements
      • Advertisement Details
      • Update Advertisement
      • Delete Advertisement
    • Webhooks
      • List Active Webhooks
      • List Events
      • Register Webhook
      • Deactivate Webhook
      • Update Webhook
    • Custom URLs
      • Import Custom URLs
    • Loyalty Points
      • Customer Loyalty Points
      • Update Customer Loyalty Points
    • Reviews
      • List Reviews
      • Review Details
      • Update Review
  • Webhooks - Store Events
    • Order
    • Product
    • Customer
    • Shippings
    • Shipments
    • Brand
    • Invoice
    • Category
    • Store
    • Special Offer
    • Cart
    • Miscellaneous
  1. Merchant API

Multi-Language Support

Developers are able to utilize the feature of multi-language in certain endpoints, as shown in the table of Applicable Locations, to assure that the content is fit to the language set in a store.
That said, it is achievable by setting header values, such as ACCEPT-LANGUAGE and CONTENT-LANGUAGE. Let's dive into each one of the header values settings.
header ValueImage

Accept Language#

Accept-Language, a request HTTP header, advertises which languages the merchant is able to understand, and which locale variant is preferred.
Set Language Code you want to get the response with. Use the iso_code value you get from the Language Endpoint as a value in this header.
By default, Accept-Language header is set to the Arabic language, with an iso_code of ar.

Content Language (Optional)#

Content-Language, an entity header, is used to describe the language(s) intended for the audience, allowing the developer to differentiate based on the merchant's preferred language.
Checkout the Languages Endpoint for more on the ISO Codes.
INFO
🧵 TL;DR
The best way to think of this is that Content-Language describes content and Accept-Language conveys a preference.

Usage#

The following cURL request example gets Product Details in the English and Arabic languages and returns a corresponding payload. Note that the header request is appending the ACCEPT-LANGUAGE to the specified language.
English Language
Arabic Language

cURL Request Sample#


Response Sample#

{
  "status": 200,
  "success": true,
  "data": {
    "id": 720881993,
    "promotion": {
      "title": "Order now",
      "sub_title": "veggie pizza"
    },
    "sku": "54534534",
    "mpn": null,
    "gtin": null,
    "type": "food",
    "name": "Pizza",
    "short_link_code": "zlrrRr",
    "urls": {
      "customer": "https://salla.sa/dev-wofftr4xsra5xtlv/pizza/p720881993",
      "admin": "https://s.salla.sa/products/720881993"
    },
    "price": {
      "amount": 51.75,
      "currency": "SAR"
    },
    "taxed_price": {
      "amount": 51.75,
      "currency": "SAR"
    },
    "pre_tax_price": {
      "amount": 45,
      "currency": "SAR"
    },
    "tax": {
      "amount": 6.75,
      "currency": "SAR"
    },
    "description": "<p><br/></p>",
    "quantity": null,
    "status": "sale",
    "is_available": true,
    "views": 0,
    "sale_price": {
      "amount": 51.75,
      "currency": "SAR"
    },
    "sale_end": "2022-05-26",
    "require_shipping": true,
    "cost_price": "15.00",
    "weight": 0.25,
    "with_tax": true,
    "url": "https://salla.sa/dev-wofftr4xsra5xtlv/pizza/p720881993",
    "main_image": "https://cdn.salla.sa/bYQEn/buItWZf4OLbaTmL7vTMlDUWLOn20hfpq3QUbD2AB.jpg",
    "images": [
      {
        "id": 1592532977,
        "url": "https://cdn.salla.sa/bYQEn/fruYYNomFLINttfdlKPAz7WYG50z0j5zPzzy2MjS.jpg",
        "main": true,
        "three_d_image_url": "",
        "alt": "",
        "video_url": "",
        "type": "image",
        "sort": 0
      }
    ],
    "sold_quantity": "1",
    "rating": {
      "total": 0,
      "count": 1,
      "rate": 0
    },
    "regular_price": {
      "amount": 51.75,
      "currency": "SAR"
    },
    "max_items_per_user": 2,
    "maximum_quantity_per_order": 2,
    "show_in_app": true,
    "notify_quantity": null,
    "hide_quantity": false,
    "unlimited_quantity": true,
    "managed_by_branches": false,
    "calories": "600.00",
    "metadata": {
      "title": null,
      "description": null
    },
    "allow_attachments": false,
    "is_pinned": false,
    "pinned_date": "2022-05-24 15:40:23",
    "sort": 0,
    "enable_upload_image": true,
    "updated_at": "2022-05-26 09:45:09",
    "options": [
      {
        "id": 1674915438,
        "name": "الاضافات",
        "description": "",
        "type": "checkbox",
        "required": true,
        "associated_with_order_time": 0,
        "availability_range": false,
        "not_same_day_order": false,
        "choose_date_time": null,
        "from_date_time": null,
        "to_date_time": null,
        "sort": 0,
        "advance": false,
        "display_type": null,
        "visibility": "always",
        "translations": {
          "ar": {
            "option_name": "الاضافات",
            "description": ""
          }
        },
        "values": [
          {
            "id": 152115913,
            "name": "بصل",
            "price": {
              "amount": 0,
              "currency": "SAR"
            },
            "display_value": null,
            "advance": false,
            "option_id": 1674915438,
            "image_url": null,
            "hashed_display_value": null,
            "translations": {
              "ar": {
                "option_details_name": "بصل"
              }
            }
          },
          {
            "id": 1526610378,
            "name": "فلفل",
            "price": {
              "amount": 0,
              "currency": "SAR"
            },
            "display_value": null,
            "advance": false,
            "option_id": 1674915438,
            "image_url": null,
            "hashed_display_value": null,
            "translations": {
              "ar": {
                "option_details_name": "فلفل"
              }
            }
          },
          {
            "id": 886790347,
            "name": "زيتون",
            "price": {
              "amount": 0,
              "currency": "SAR"
            },
            "display_value": null,
            "advance": false,
            "option_id": 1674915438,
            "image_url": null,
            "hashed_display_value": null,
            "translations": {
              "ar": {
                "option_details_name": "زيتون"
              }
            }
          }
        ]
      }
    ],
    "skus": [],
    "categories": [
      {
        "id": 399447873,
        "name": "Italian",
        "urls": {
          "customer": "https://salla.sa/dev-wofftr4xsra5xtlv/italian/c399447873",
          "admin": "https://s.salla.sa/categories"
        },
        "items": [
          {
            "id": 1887256138,
            "name": "Pizza",
            "urls": {
              "customer": "https://salla.sa/dev-wofftr4xsra5xtlv/pizza/c1887256138",
              "admin": "https://s.salla.sa/categories"
            },
            "items": [],
            "parent_id": 399447873,
            "status": "active",
            "sort_order": 0
          }
        ],
        "parent_id": 298280307,
        "status": "active",
        "sort_order": 0
      }
    ],
    "brand": {
      "id": 146591953,
      "name": "Pizza time",
      "description": "Pizza store since 1955",
      "banner": null,
      "logo": "https://cdn.salla.sa/bYQEn/LeeG0bRRnUvjaz31JQtWSwZNRsLiJUigt9LK0riW.jpg",
      "ar_char": "ب",
      "en_char": "B"
    },
    "tags": [
      {
        "id": 1285143056,
        "name": "أكل"
      },
      {
        "id": 1924963095,
        "name": "طعام"
      }
    ]
  }
}

Applicable Variables#

The following section showcases the endpoints with their respective available translation variables that developers may use to demonstrate multi-language support.

Create Product Endpoint#

Variable Title
metdata.title
metdata.description
metdata.url

List Products Endpoint#

Variable Title
name
promotion.title
promotion.subtitle
metdata.title
metdata.description
metdata.url
description
categories.name

Product Details Endpoint#

Variable Title
name
promotion.title
promotion.subtitle
metdata.title
metdata.description
metdata.url
description
categories.name

Update Product Endpoint#

Body Request
Body Response
Variable Title
metdata_title
metdata_description
metdata_url

Product Details by SKU Endpoint#

Variable Title
metdata.title
metdata.description
metdata.url

Update Product by SKU Endpoint#

Body Request
Body Response
Variable Title
metdata_title
metdata_description
metdata_url

Create Custom Sub-Status#

Variable Title
name
message

List Order Statuses#

Variable Title
name

Order Status Details#

Variable Title
name
message

Update Statuses #

Variable Title
name
message

List Branches Endpoint#

Variable Title
name
address_description
street
local

Branch Details Endpoint#

Variable Title
name
address_description
street
local

Update Branch Endpoint#

Variable Title
name
address_description
street
local

List Categories Endpoint#

Variable Title
name
items.name

Category Details Endpoint#

Variable Title
name
items.name

Update Category Endpoint#

Variable Title
name

List Brands#

Variable Title
name
description
metadata.title
metadata.description
metadata.url

Brand Details Endpoint#

Variable Title
name
description
metadata.title
metadata.description
metadata.url

Update Brand Endpoint#

Variable Title
name
description
metadata.title
metadata.description
metadata.url

List Special Offers#

Variable Title
name
message

Special Offer Details#

Variable Title
name
message

Update Special Offer#

Variable Title
name

List Advertisments Endpoint#

Variable Title
description

Advertisement Details Endpoint#

Variable Title
description

Update Advertisement Endpoint#

Variable Title
description

List SEO Settings Endpoint#

Variable Title
title
keywords
description

Update SEO Settings Endpoint#

Variable Title
title
keywords
description
Modified at 2025-03-04 12:54:02
Previous
Security Considerations
Next
Responses