Create Order -Salla Merchant API

This endpoint allows you to create an order related to your store. It supports both standard one-time purchases and subscription-based orders.

Scopes

orders.read_write - Orders Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "customer": {
        "id": 1209983424,
        "name": "new name",
        "mobile": "+966566666666",
        "email": "[email protected]"
    },
    "receiver": {
        "name": "i am the one",
        "country_code": "SA",
        "phone": "966566666666",
        "email": "[email protected]",
        "notify": false
    },
    "delivery_method": "shipping",
    "branch_id": 203948803,
    "courier_id": 1433878184,
    "ship_to": {
        "country": 1473353380,
        "city": 1939592358,
        "district": 674989864,
        "block": "الدور الثاني",
        "street_number": "8230",
        "address": "حي النزهة، الرياض",
        "address_line": "West",
        "postal_code": "51434",
        "geo_coordinates": {
            "lat": 79.0225,
            "lng": 53.5041
        }
    },
    "payment": {
        "status": "paid",
        "method": "bank",
        "store_bank_id": 234234,
        "receipt_image_path": "url",
        "accepted_methods": [
            "bank",
            "credit_card"
        ],
        "cash_on_delivery": {
            "amount": 10,
            "currency": "SAR"
        }
    },
    "products": [
        {
            "identifier_type": "id",
            "identifier": 892907448,
            "quantity": 1,
            "options": [
                {
                    "id": 1626535321,
                    "value": [
                        "96445177"
                    ]
                }
            ],
            "recurring":{
                "slug": "premium-subscription-plan",
                "interval_unit": "month",
                "interval_count": 12,
                "meta":{
                    "note": "Internal note"
                }
            }
        },
        {
            "identifier_type": "id",
            "identifier": 728473534,
            "quantity": 1
        },
        {
            "identifier_type": "sku",
            "identifier": "sku123",
            "quantity": 1
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.salla.dev/admin/v2/orders' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer": {
        "id": 1209983424,
        "name": "new name",
        "mobile": "+966566666666",
        "email": "[email protected]"
    },
    "receiver": {
        "name": "i am the one",
        "country_code": "SA",
        "phone": "966566666666",
        "email": "[email protected]",
        "notify": false
    },
    "delivery_method": "shipping",
    "branch_id": 203948803,
    "courier_id": 1433878184,
    "ship_to": {
        "country": 1473353380,
        "city": 1939592358,
        "district": 674989864,
        "block": "الدور الثاني",
        "street_number": "8230",
        "address": "حي النزهة، الرياض",
        "address_line": "West",
        "postal_code": "51434",
        "geo_coordinates": {
            "lat": 79.0225,
            "lng": 53.5041
        }
    },
    "payment": {
        "status": "paid",
        "method": "bank",
        "store_bank_id": 234234,
        "receipt_image_path": "url",
        "accepted_methods": [
            "bank",
            "credit_card"
        ],
        "cash_on_delivery": {
            "amount": 10,
            "currency": "SAR"
        }
    },
    "products": [
        {
            "identifier_type": "id",
            "identifier": 892907448,
            "quantity": 1,
            "options": [
                {
                    "id": 1626535321,
                    "value": [
                        "96445177"
                    ]
                }
            ],
            "recurring":{
                "slug": "premium-subscription-plan",
                "interval_unit": "month",
                "interval_count": 12,
                "meta":{
                    "note": "Internal note"
                }
            }
        },
        {
            "identifier_type": "id",
            "identifier": 728473534,
            "quantity": 1
        },
        {
            "identifier_type": "sku",
            "identifier": "sku123",
            "quantity": 1
        }
    ]
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
  "status": 201,
  "success": true,
  "data": {
    "id": 1107722485,
    "external_order_id": null,
    "external_reference_id": null,
    "checkout_id": "3058806946742845435",
    "reference_id": 279766354,
    "urls": {
      "customer": "https://demostore.salla.sa/dev-qemdv5vldnohhhpq/account/orders/XArYbdA",
      "admin": "https://s.salla.sa/orders/order/gdpNzmxoKnvLW0le85bXWyZR5DBAqwPl",
      "rating": null,
      "digital_content": null,
      "gift_confirmation": null
    },
    "date": {
      "date": "2026-08-24 17:38:20.000000",
      "timezone_type": 3,
      "timezone": "Asia/Riyadh"
    },
    "updated_at": {
      "date": "2026-08-24 17:38:20.453456",
      "timezone_type": 3,
      "timezone": "Asia/Riyadh"
    },
    "source": "223306543",
    "draft": false,
    "read": false,
    "source_details": {
      "type": "223306543",
      "value": null,
      "device": "desktop",
      "user-agent": "PostmanRuntime/7.56.1",
      "utm_source": "",
      "utm_campaign": "",
      "utm_medium": "",
      "utm_term": "",
      "utm_content": "",
      "ip": "192.0.2.1"
    },
    "status": {
      "id": 566146469,
      "name": "بإنتظار المراجعة",
      "slug": "under_review",
      "customized": {
        "id": 1503099289,
        "name": "بإنتظار المراجعة"
      }
    },
    "payment_method": "cod",
    "payment_methods": [
      {
        "amount": 0,
        "payment_method": "cod",
        "transaction_reference": null
      }
    ],
    "receipt_image": null,
    "currency": "SAR",
    "amounts": {
      "sub_total": {
        "amount": 200,
        "currency": "SAR"
      },
      "shipping_cost": {
        "amount": 0,
        "currency": "SAR",
        "original_cost": 0,
        "shipping_cost_discount": 0
      },
      "cash_on_delivery": {
        "amount": 9000,
        "currency": "SAR"
      },
      "tax": {
        "percent": "15.00",
        "amount": {
          "amount": 30,
          "currency": "SAR"
        }
      },
      "discounts": [],
      "total": {
        "amount": 230,
        "currency": "SAR"
      }
    },
    "exchange_rate": {
      "base_currency": "SAR",
      "exchange_currency": "SAR",
      "rate": "1.00000000"
    },
    "scope_exchange_rate": null,
    "campaign": {
      "medium": "",
      "source": "",
      "campaign": ""
    },
    "gateway": null,
    "show_weight": false,
    "shipping_status": "shipping_ready",
    "pending_payment_ends_at": 75598,
    "total_weight": "٢٤ كجم",
    "type": "normal",
    "is_overweighted": false,
    "has_customer_session": false,
    "features": {
      "shippable": true,
      "is_international": false,
      "internationally_shippable": false,
      "digitalable": false,
      "pickable": true,
      "multiple_shipments_supported": false,
      "order_type_price_quote": false,
      "has_suspicious_alert": false,
      "bullet_delivery": {
        "is_bullet_delivery": false,
        "bullet_countdown": 0,
        "on_demand_countdown": 0,
        "on_demand_delivery": false,
        "on_demand_timer": false
      },
      "wallet": true
    },
    "receiver": null,
    "actions": {
      "cancellable": false,
      "reorderable": true,
      "payable": false
    },
    "accepted_payment_methods": [
      ""
    ],
    "payment_actions": {
      "refund_action": {
        "refunded_transactions": [],
        "pending_refund_amount": null,
        "has_refund_amount": false,
        "payment_method_label": "دفع عند التسليم",
        "can_print_refund_invoice": false,
        "paid_amount": {
          "amount": 0,
          "currency": "SAR"
        },
        "refund_amount": {
          "amount": 0,
          "currency": "SAR"
        },
        "loyalty_point_programs": [],
        "can_send_sms": false,
        "can_send_sms_msg": "يرجى تفعيل احد مزودين خدمة SMS من صفحة ربط الخدمات",
        "can_refund_loyalty_prize_points": false,
        "can_restore_loyalty_buy_from_store_points": false,
        "can_refund_to_wallet": true
      },
      "remaining_action": {
        "has_remaining_amount": false,
        "payment_method_label": "دفع عند التسليم",
        "paid_amount": {
          "amount": 0,
          "currency": "SAR"
        },
        "checkout_url": "",
        "remaining_amount": null
      }
    },
    "address_incomplete": false,
    "customer": {
      "id": 1994632541,
      "full_name": "Mohammed Ahmed",
      "first_name": "Mohammed",
      "last_name": "Ahmed",
      "mobile": 557777777,
      "mobile_code": "+966",
      "email": "[email protected]",
      "urls": {
        "customer": "https://demostore.salla.sa/dev-qemdv5vldnohhhpq/account/profile",
        "admin": "https://s.salla.sa/customers/zAB3exRyLdXv5Wpk5lDarGg4p7Ej8ZKl"
      },
      "avatar": "https://cdn.assets.salla.network/prod/admin/cp/assets/images/avatar_female.png",
      "gender": "female",
      "birthday": {
        "date": "1987-08-12 00:00:00.000000",
        "timezone_type": 3,
        "timezone": "Asia/Riyadh"
      },
      "city": "الحميمة",
      "country": "السعودية",
      "country_code": "SA",
      "currency": "SAR",
      "location": "",
      "lang": "ar",
      "created_at": {
        "date": "2025-12-25 12:41:10.000000",
        "timezone_type": 3,
        "timezone": "Asia/Riyadh"
      },
      "updated_at": {
        "date": "2026-08-23 17:02:59.000000",
        "timezone_type": 3,
        "timezone": "Asia/Riyadh"
      },
      "type": "user",
      "groups": []
    },
    "notes": null,
    "fraud_reasons": [],
    "bank": null,
    "tags": []
  }
}

🟠422Error Validation

🟠401Unauthorized