Marketplace Odeme Sureci

Marketplace odeme sureci manual-first ve enterprise-gated kalir. Amac, musterinin teklif secip siparis olusturabilmesi, manuel odeme kanitinin operasyon tarafindan onaylanmasi ve uretime alma kapisinin kontrollu sekilde acilmasidir.

Marketplace odeme ve siparis mutasyonlari server-side idempotency kullanir. Ayni aksiyon tekrar denenirse ilk kaydedilen yanit donmelidir; ayni anahtar degistirilmis istekle tekrar kullanilirsa tekrar islem olusturmak yerine reddedilir.

Manual-first akis

1. Musteri teklifleri karsilastirir.
2. Bir teklifi secer.
3. Siparis payment_pending ve not_started uretim durumuyla olusur.
4. Musteri havale/EFT, acik hesap veya anlasilan kurumsal yontem icin kanit/paylasim yapar.
5. Operasyon veya finans admin odemeyi manuel olarak onaylar ya da reddeder.
6. Odeme onaylaninca siparisin odeme durumu approved olur ve uretime alma kapisi acilir.
7. Uretim durumu ancak odeme onayindan sonra operasyon tarafindan in_production yapilabilir.
8. PrintTalk, matbaa bridge job'u, PDF Tools, Edge Hub, XJDF yurutme ve fulfillment bu fazin disindadir.

Desteklenen public yontemler

Public/self-service odeme yuzeyi dar tutulur:

• Havale/EFT ile odeme
• Kurumsal acik hesap
• Operasyon ekibinin manuel odeme onayi

document_payment, check, deferred_terms ve direct_deal package seviyesinde supplier-terms vocabulary olarak vardir. Bunlar public odeme secenegi degildir; yalniz operator onayli kurumsal sozlesme veya import senaryosunda kullanilir.

Platformda simdilik olmayanlar

• Kartla odeme ekrani
• Platform icinde para tutma modeli veya escrow release otomasyonu
• Otomatik odeme saglayici entegrasyonu
• Otomatik iade veya odeme cozumleme ekrani
• Odeme onayindan sonra otomatik uretim veya handoff

Provider-neutral contractlar gated package yuzeyinde bulunabilir; bu public enablement anlamina gelmez. Bu kabiliyetler mevcut public vaadin parcasi degildir.

Kanit ve tekrar deneme guvencesi

Odeme onayi, acik hesap onayi ve uretim asamasi guncellemeleri server-side idempotency ile korunur. Ayni islem tekrar denenirse ilk kaydedilen yanit doner; ayni anahtar farkli icerikle kullanilirsa islem reddedilir. Commit edilmis bir yanit x-marketplace-idempotency-recovery tasiyorsa ayni anahtari ve birebir ayni istek govdesini koruyun: retryable exact retry icin kaydin hazir oldugunu, lease-pending ise terk edilmis transport sahipliginin sinirli lease sonunda geri alinacagini belirtir. Response ve audit ozetleri raw idempotency key, actor id, provider secret veya local file path tasimaz.

Marketplace API istekleri rota calismadan once ortak dagitik admission limitinden de gecer. 429 yaniti Retry-After tasir; bu sureyi bekleyip idempotent istegi anahtarini veya govdesini degistirmeden yineleyin. 503 MARKETPLACE_ADMISSION_UNAVAILABLE fail-closed korumadir: yeni bir odeme denemesi baslatmayin, ayni istegi belirtilen gecikmeden sonra tekrar gonderin. Bu kontrol ham istemci IP adresi saklamaz.

Ic tarafta captured provider callback'i ayni transaction icinde dengeli settlement journal, reconciliation sonucu, kisitli audit kaydi ve kalici payment event uretmek zorundadir. Provider token ve callback body yalniz hash olarak saklanir. Bu hazirlik bir veri butunlugu kontroludur; kart odemesinin public olarak acildigi anlamina gelmez.

Provider inbox kayitlari, settlement journal/posting kayitlari, reconciliation snapshot'lari ve exact replay icin gereken settlement event kanit kopyasi finansal kanit sinifindadir. Teslimat outbox'i pilotla sifirlanabilse bile bu kanitlar toplu marketplace reset kapsaminda silinmez; duzeltmeler yeni ve izlenebilir kayitlarla yapilir.

Siparis ne zaman uretime alinir?

Siparis olusmasi tek basina uretime baslama anlamina gelmez. Odeme onayi uretime alma kapisini acar; uretim durumu ancak bundan sonra operasyon tarafindan ilerletilebilir. Otomatik matbaa job'u ve fulfillment entegrasyonu bu pilotun vaadi degildir.