E-Ticaret

orders

37 uç · /api/shop/v1/orders

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 37 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/shop/v1/admin/orders

Credential-listesi + kaldırma (müşteri-oturumu).

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{id}/tax-lines

Siparişin vergi kırılımı (kademe-başına) + siparişte yazılı toplam — mutabakat/beyan için.

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<id>/tax-lines" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}

Admin: retention config oku (gün eşikleri; null = o tablo için kapalı).

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/assign

Havuzdan bir anahtar tahsis et (atomik; çift-tahsis yok). Havuz boş → 409.

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/assign" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/assign-location

Order assign location

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/assign-location" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/authorize

Storefront: cüzdan-ödeme yetkilendir → tokenized ref (express-checkout ödeme external_ref seam).

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/authorize" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/cod-collect

Cod collect

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/cod-collect" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/conversations

List order

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/conversations" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/customs-doc

Doc

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/customs-doc" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/edits

Edit

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/edits" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/edits

Oturum mesaj-geçmişi (yalnız o token'a ait; başka oturum/tenant görünmez). Yoksa boş.

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/edits" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/fulfillment-requests

List requests

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/fulfillment-requests" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/fulfillment-requests

Havuzdan bir anahtar tahsis et (atomik; çift-tahsis yok). Havuz boş → 409.

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/fulfillment-requests" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/intents

Siparişin ödeme-niyetleri (admin gözlemi/mutabakat).

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/intents" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PATCH/api/shop/v1/admin/orders/{order_id}/items

Edit items

OturumYol parametresi: order_id
İstek
curl -X PATCH "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/items" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/ledger

Ledger

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/ledger" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/margin

Margin

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/margin" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/notes

Notes list

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/notes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/notes

Note add

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/notes" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/payments

Credential-listesi + kaldırma (müşteri-oturumu).

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/payments" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/payments

Capture

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/payments" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/request-invoice

Request

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/request-invoice" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/risk

Decide

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/risk" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/risk-evaluate

Ödeme-öncesi risk-değerlendirme ucu (BLE-6137): mevcut siparişi tablo-kurallarına karşı yeniden

OturumYol parametresi: order_id

değerlendirir (email+total siparişten; ülke opsiyonel body'den). risk_state güncellenir.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/risk-evaluate" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/risk-signals

Signals

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/risk-signals" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/routing-plan

Order routing plan

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/routing-plan" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/shipments

Credential-listesi + kaldırma (müşteri-oturumu).

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/shipments" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/shipments

VPOS tanımı ekle/güncelle (upsert bank). bank 1-32 char, threed_mode 3d|non3d. config_ref saklanır

OturumYol parametresi: order_id

ama response'ta dönmez.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/shipments" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/status

Public-api durum ucu: geçerli API versiyonu + deprecation/sunset (X-Api-Version başlığıyla).

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/status" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/{order_id}/tags

Sipariş etiketlerini ayarla (tam-değiştir; en çok 30 etiket, her biri 1-48 char, trim+dedup) — BLE-6056.

OturumYol parametresi: order_id
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/tags" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/{order_id}/timeline

Timeline

OturumYol parametresi: order_id
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/<order_id>/timeline" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/admin/orders/bulk-status

TF6 · toplu durum-değişikliği: her sipariş KENDİ tx'inde (kısmi başarı raporlanır; tek

Oturum

bozuk sipariş diğerlerini bloklamaz). En çok 200 id.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/bulk-status" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/admin/orders/export.csv

Orders export

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/admin/orders/export.csv" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/orders/{order_id}/pay

Sandbox Masterpass ödeme (iskelet). Bağlı cüzdanla sahte-provizyon → sandbox referansı. GERÇEK para

OturumYol parametresi: order_id

HAREKET ETMEZ + gerçek provizyon/kayıt = TF21 (canlı-key). Bağlı değilse 404; geçersiz tutar 400.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/orders/<order_id>/pay" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/orders/cancel

Müşteri iptali (code-guard). held/ready → cancelled + hold serbest.

Oturum
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/orders/cancel" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/orders/downloads

Order downloads

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/orders/downloads" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/orders/track

Track

Oturum
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/orders/track" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?