​
Orders

Orders endpointleri dış vitrin veya entegrasyon üzerinden sipariş oluşturmak ve sipariş detaylarını okumak için kullanılır.

​
Sipariş oluşturma akışı

Sipariş oluştururken üç ana bilgi gönderilir:
  • customer: Müşteri iletişim bilgileri.
  • shipping_address: Teslimat adresi.
  • items: Sipariş kalemleri.
curl -X POST "https://api.hemenmagaza.com/v1/orders" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "customer": {
      "name": "Ayşe Yılmaz",
      "email": "ayse@example.com",
      "phone": "+905551112233"
    },
    "shipping_address": {
      "country": "Türkiye",
      "city": "İstanbul",
      "district": "Kadıköy",
      "address": "Caferağa Mah. Moda Cad. No:12",
      "postal_code": "34710"
    },
    "items": [
      {
        "product_id": 101,
        "quantity": 2
      }
    ]
  }'

​
Customer bilgileri

name ve email zorunludur. Telefon alanı önerilir; kargo ve müşteri hizmetleri süreçlerinde kullanılır.

​
Shipping address

Teslimat adresi en az ülke, şehir, ilçe ve açık adres içermelidir.

​
Items

Her sipariş kalemi product_id ve quantity taşır. 
[
  {
    "product_id": 101,
    "quantity": 2
  }
]

​
Sipariş status değerleri

  • pending: Sipariş alındı, ödeme veya operasyon onayı bekliyor.
  • paid: Ödeme tamamlandı.
  • preparing: Sipariş hazırlanıyor.
  • shipped: Sipariş kargoya verildi.
  • cancelled: Sipariş iptal edildi.
  • refunded: İade süreci tamamlandı.

​
Başarılı response örneği

{
  "id": 9001,
  "status": "pending",
  "total": 1199.8,
  "currency": "TRY"
}