Orders

Import COD Order

Bring a cash-on-delivery order into the store: it joins the agents' call queue as pending_confirmation. Refused with 403 while the store does not take new orders (see GET /store).

POST https://rassmi.com/api/v1/orders

Authorization

Authorizationheaderrequired

Bearer rsk_…: the store's API key, from API Key in your Rassmi dashboard.

Body

customer_name string required

Up to 255 characters.
customer_phone string required

Algerian phone number, any common format.
customer_address string required

Up to 500 characters.
customer_wilaya string required

Wilaya code (16) or name (Alger, الجزائر). See List Wilayas.
customer_commune string

Commune ID or name. See List Communes.
total_amount number required

What the courier collects, in DZD.
shipping_fee number

Delivery fee included in the total. Default 0.
payment_method string

Default COD.
notes string

Shown to the agent. Up to 1,000 characters.
items array

1 to 100 lines. Each line: product_id (a product of this store) or product_name + unit_price, quantity, optional attributes ({"Taille": "M"}).

Responses

Status	Meaning
`201`	Success. The body is shown on the right.
`403`	The store does not take new orders (no agent past its grace period, or its monthly cap reached). `code` says which.
`422`	Validation failed.
`401`	Missing, unknown, paused or expired API key.
`429`	More than 60 requests in a minute. See Rate limits.

POST /orders

curl -X POST "https://rassmi.com/api/v1/orders" \
  -H "Authorization: Bearer $RASSMI_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "Amina Benali",
    "customer_phone": "0555123456",
    "customer_address": "Cité 200 Logements, Bt 4",
    "customer_wilaya": "16",
    "customer_commune": "Bab Ezzouar",
    "total_amount": 5000,
    "shipping_fee": 500,
    "items": [
        {
            "product_id": "0199a3c2-1b2c-7a10-8e3d-5f6a7b8c9d0e",
            "quantity": 1,
            "attributes": {
                "Taille": "M"
            }
        }
    ]
}'

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('RASSMI_API_KEY'))
    ->acceptJson()
    ->post('https://rassmi.com/api/v1/orders', [
        'customer_name' => 'Amina Benali',
        'customer_phone' => '0555123456',
        'customer_address' => 'Cité 200 Logements, Bt 4',
        'customer_wilaya' => '16',
        'customer_commune' => 'Bab Ezzouar',
        'total_amount' => 5000,
        'shipping_fee' => 500,
        'items' => [
            [
                'product_id' => '0199a3c2-1b2c-7a10-8e3d-5f6a7b8c9d0e',
                'quantity' => 1,
                'attributes' => [
                    'Taille' => 'M',
                ],
            ],
        ],
    ]);

$data = $response->json();

const response = await fetch('https://rassmi.com/api/v1/orders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RASSMI_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "customer_name": "Amina Benali",
      "customer_phone": "0555123456",
      "customer_address": "Cité 200 Logements, Bt 4",
      "customer_wilaya": "16",
      "customer_commune": "Bab Ezzouar",
      "total_amount": 5000,
      "shipping_fee": 500,
      "items": [
          {
              "product_id": "0199a3c2-1b2c-7a10-8e3d-5f6a7b8c9d0e",
              "quantity": 1,
              "attributes": {
                  "Taille": "M"
              }
          }
      ]
  }),
});

const data = await response.json();

import os
import requests

response = requests.request(
    "POST",
    "https://rassmi.com/api/v1/orders",
    headers={"Authorization": f"Bearer {os.environ['RASSMI_API_KEY']}"},
    json={
        "customer_name": "Amina Benali",
        "customer_phone": "0555123456",
        "customer_address": "Cité 200 Logements, Bt 4",
        "customer_wilaya": "16",
        "customer_commune": "Bab Ezzouar",
        "total_amount": 5000,
        "shipping_fee": 500,
        "items": [
            {
                "product_id": "0199a3c2-1b2c-7a10-8e3d-5f6a7b8c9d0e",
                "quantity": 1,
                "attributes": {
                    "Taille": "M",
                },
            },
        ],
    },
)

data = response.json()

Response · 201

{
    "data": {
        "id": "0199a3c2-6f1e-7d55-9c1a-2b8f6e4d1a07",
        "status": "pending_confirmation",
        "customer": {
            "name": "Amina Benali",
            "phone": "0555123456",
            "address": "Cité 200 Logements, Bt 4",
            "wilaya": "16",
            "commune": "Bab Ezzouar"
        },
        "items": [
            {
                "product_id": "0199a3c2-1b2c-7a10-8e3d-5f6a7b8c9d0e",
                "product_name": "Robe kabyle",
                "quantity": 1,
                "unit_price": 4500,
                "subtotal": 4500,
                "attributes": {
                    "Taille": "M"
                }
            }
        ],
        "total_amount": 5000,
        "shipping_fee": 500,
        "payment_method": "COD",
        "payment_status": "unpaid",
        "notes": null,
        "tracking_number": null,
        "shipping_company": null,
        "shipping_status": null,
        "created_at": "2026-10-30T09:12:44+00:00",
        "updated_at": "2026-10-30T09:12:44+00:00"
    }
}