Order Create

Developing

POST

https://app.lamha.sa/api/v2/create-order

Request

Header Params

Body Params application/json

Example

{
    "sub_total": 100,
    "discount": "10",
    "shopping_cost": 15,
    "total": 90,
    "payment_method": "cod",
    "date": "2024-07-01 22:05:00",
    "ShipmentCurrency": "SAR",
    "reference_id": "123456",
    "order_id": "132456",
    "create_shippment": false,
    "shipper": {
        "name": "متجر 9",
        "phone": "+966512345678",
        "Country": "SA",
        "District": "العليا",
        "City": "Riyadh",
        "AddressLine1": "الرياض  ,العليا, قرب صيدلية الازهر",
        "AddressLine2": "",
        "national_address": "RJYB2357"
    },
    "customer": {
        "name": "Lamha Customer",
        "phone1": "+966512345678",
        "phone2": "+966512345678",
        "Country": "SA",
        "District": "البوادي",
        "City": "Jeddah",
        "AddressLine1": "جدة , البوادي ,  بجوار مخبز الحمد",
        "AddressLine2": "",
        "email": "",
        "national_address": "RJYB2357"
    },
    "items": [
        {
            "name": "شنطة جلد",
            "quantity": 1,
            "Sku": "123",
            "amount": "10",
            "weight": "0.5"
        },
        {
            "name": "ساعة يد منقوشة",
            "quantity": 3,
            "Sku": "123456",
            "amount": "25",
            "weight": "1"
        }
    ],
    "coupon": "",
    "parcels": "1",
    "callback_url": "https://webhook.site/a0cd5172-fbda-4366-bf4b-f8e0d1ddc2fb",
    "callback_pdf_url": "https://webhook.site/a0cd5172-fbda-4366-bf4b-f8e0d1ddc2fb",
    "carrier_id": "10"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.lamha.sa/api/v2/create-order' \
--header 'X-LAMHA-TOKEN: Lamha_rPAHG9wey1xjYJErCz9678EuBkyExIzOksbHygh0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sub_total": 100,
    "discount": "10",
    "shopping_cost": 15,
    "total": 90,
    "payment_method": "cod",
    "date": "2024-07-01 22:05:00",
    "ShipmentCurrency": "SAR",
    "reference_id": "123456",
    "order_id": "132456",
    "create_shippment": false,
    "shipper": {
        "name": "متجر 9",
        "phone": "+966512345678",
        "Country": "SA",
        "District": "العليا",
        "City": "Riyadh",
        "AddressLine1": "الرياض  ,العليا, قرب صيدلية الازهر",
        "AddressLine2": "",
        "national_address": "RJYB2357"
    },
    "customer": {
        "name": "Lamha Customer",
        "phone1": "+966512345678",
        "phone2": "+966512345678",
        "Country": "SA",
        "District": "البوادي",
        "City": "Jeddah",
        "AddressLine1": "جدة , البوادي ,  بجوار مخبز الحمد",
        "AddressLine2": "",
        "email": "",
        "national_address": "RJYB2357"
    },
    "items": [
        {
            "name": "شنطة جلد",
            "quantity": 1,
            "Sku": "123",
            "amount": "10",
            "weight": "0.5"
        },
        {
            "name": "ساعة يد منقوشة",
            "quantity": 3,
            "Sku": "123456",
            "amount": "25",
            "weight": "1"
        }
    ],
    "coupon": "",
    "parcels": "1",
    "callback_url": "https://webhook.site/a0cd5172-fbda-4366-bf4b-f8e0d1ddc2fb",
    "callback_pdf_url": "https://webhook.site/a0cd5172-fbda-4366-bf4b-f8e0d1ddc2fb",
    "carrier_id": "10"
}'

Responses

🟢200Success Create Order Only

application/json

Body

Examples

SuccessSuccessSuccessWebhook When Status Order Change In Lamha

{
    "success": true,
    "msg": "The Order has been Created",
    "order_id": 79311
}

🟢200Success Create Order With Shippment

🟢200Webhook Callback PDF

🟢200Webhook Status

Modified at 2025-12-28 08:23:26

Orders List

Order Show