Sipariş Servisleri

Bu bölümdeki uçlarla mağazanın siparişlerini kendi sisteminize alabilir, kargolama ve teslim gibi durum değişikliklerini mağazaya geri yazabilirsiniz.

İşlem Uç İzin
Sipariş listesi ve tek sipariş GET /orders, GET /orders/{id} orders:read
Sipariş durumu güncelleme PUT /orders/{id}/status orders:write
Sipariş bildirimi (webhook) Mağaza sizin adresinize POST eder —

Sipariş durumları (status)

Değer Anlamı
Pending Sipariş oluşturuldu, ödeme adımı sürüyor.
AwaitingPayment Havale/EFT ödemesi bekleniyor.
Processing Ödeme onaylandı (kapıda ödemede sipariş alındı). Hazırlanmayı bekliyor.
Preparing Hazırlanıyor.
Shipped Kargoya verildi.
Delivered Teslim edildi.
Cancelled İptal edildi.
Returned İade edildi.
PartiallyRefunded Kısmi iade yapıldı.

Ödeme durumları (paymentStatus)

Değer Anlamı
Pending Ödeme bekleniyor.
AwaitingPayment Havale/EFT bekleniyor.
Paid Ödendi.
PayOnDelivery Kapıda ödenecek (nakit ya da kart). Tahsilat teslimde kaydedilir.
Failed Ödeme başarısız.
RefundPending İade bekliyor.
Refunded İade edildi.
PartiallyRefunded Kısmi iade edildi.

Ödeme yöntemleri (paymentMethod)

paymentMethod makinenin okuyacağı anahtardır. paymentMethodName aynı yöntemin okunabilir adıdır ("Kredi/Banka Kartı (PayTR)", "Havale/EFT" gibi). e-Arşiv faturadaki ödeme şekli için paymentMethodName alanını kullanabilirsiniz.

Anahtar Yöntem
bank_transfer Havale/EFT
paytr Kredi/Banka kartı (PayTR)
bank_vpos Kredi/Banka kartı (bankanın sanal POS'u)
cod_cash Kapıda ödeme, nakit
cod_card Kapıda ödeme, kartla
Diğer Mağazanın bağladığı diğer ödeme kuruluşları (iyzico, Moka gibi). Ad paymentMethodName alanında yazar.

Tutarlar

  • Bütün tutarlar KDV dahil ve Türk lirasıdır.
  • totalAmount = ürünler (subTotal, indirimler sonrası) + kargo (shippingCost) + taksit vade farkı (installmentFee) + kapıda ödeme hizmet bedeli (paymentFee).
  • installmentFee ve paymentFee sipariş kalemlerinde yer almaz. Faturada bunları ayrı hizmet satırı olarak yazın. Aksi halde kalem toplamı tahsil edilen tutarı tutmaz.