Orders

Update Order

Correct the customer's details, the amounts or the notes of an order that is not shipped yet. Send only the fields to change; an order.updated webhook follows.

PATCH https://rassmi.com/api/v1/orders/{order}

Authorization

Authorizationheaderrequired

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

Path parameters

order string required

The order ID.

Body

customer_name string

Up to 255 characters.
customer_phone string

Any common format; stored as 0XXXXXXXXX.
customer_address string

Up to 500 characters.
customer_wilaya string

Wilaya code or name.
customer_commune string

Commune ID or name.
total_amount number

In DZD.
shipping_fee number

In DZD.
notes string

Up to 1,000 characters; null clears them.

Responses

Status	Meaning
`200`	Success. The body is shown on the right.
`404`	No such resource in this store.
`422`	Validation failed, or the order is shipped, delivered or returned.
`401`	Missing, unknown, paused or expired API key.
`429`	More than 60 requests in a minute. See Rate limits.

PATCH /orders/{order}

curl -X PATCH "https://rassmi.com/api/v1/orders/{order_id}" \
  -H "Authorization: Bearer $RASSMI_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_address": "Rue Didouche Mourad, 12",
    "customer_wilaya": "16"
}'

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('RASSMI_API_KEY'))
    ->acceptJson()
    ->patch('https://rassmi.com/api/v1/orders/{order_id}', [
        'customer_address' => 'Rue Didouche Mourad, 12',
        'customer_wilaya' => '16',
    ]);

$data = $response->json();

const response = await fetch('https://rassmi.com/api/v1/orders/{order_id}', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.RASSMI_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "customer_address": "Rue Didouche Mourad, 12",
      "customer_wilaya": "16"
  }),
});

const data = await response.json();

import os
import requests

response = requests.request(
    "PATCH",
    "https://rassmi.com/api/v1/orders/{order_id}",
    headers={"Authorization": f"Bearer {os.environ['RASSMI_API_KEY']}"},
    json={
        "customer_address": "Rue Didouche Mourad, 12",
        "customer_wilaya": "16",
    },
)

data = response.json()

Response · 200

{
    "data": {
        "id": "0199a3c2-6f1e-7d55-9c1a-2b8f6e4d1a07",
        "status": "pending_confirmation",
        "customer": {
            "name": "Amina Benali",
            "phone": "0555123456",
            "address": "Rue Didouche Mourad, 12",
            "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"
    }
}