8 dk

Pazar Yeri Uyuşmazlıklarını Baştan Sona Yöneten Web Uygulaması Oluşturun

Pazar yeri anlaşmazlıklarını planlamayı, tasarlamayı ve yönetmeyi öğrenin: vaka alımı, delil, iş akışları, roller, denetim izi, entegrasyonlar ve raporlama.

Pazar Yeri Uyuşmazlıklarını Baştan Sona Yöneten Web Uygulaması Oluşturun

Bir Pazar Yeri Anlaşmazlık Uygulamasının Çözmesi Gerekenler

Bir anlaşmazlık uygulaması sadece “durumlu bir destek formu” değildir. Para, ürünler ve güven, bir şey ters gittiğinde pazar yerinizde nasıl hareket edeceğine karar veren sistemdir. Ekranlar veya tablolar çizmeye başlamadan önce problem alanını net biçimde tanımlayın—aksi halde kullanımı kolay ama uygulanması zor bir araç geliştirmiş olursunuz.

Pazar yeriniz için “anlaşmazlık” ne demek- bunu tanımlayın

İhtiyacınız olan anlaşmazlık türlerini ve aralarındaki farkları listeleyerek başlayın. Yaygın kategoriler şunlardır:

  • Ürün teslim edilmedi (kargo gecikmeleri, yanlış adres, kayıp paket)
  • Açıklamaya uymuyor / hasarlı (kalite sorunları, eksik parçalar)
  • Dolandırıcılık / izinsiz satın alma (hesap ele geçirilmesi, çalınmış ödeme yöntemi)
  • Chargeback'ler (bankanın başlattığı itirazlar; sıkı delil ve son tarihler gerekir)

Her tür genellikle farklı delil, zaman penceresi ve sonuç (iade, değişim, kısmi iade, satıcı ödemesinin geri alınması) gerektirir. Anlaşmazlık türünü iş akışı sürücüsü olarak ele alın—sadece bir etiket değil.

Hedefleri netleştirin (tavizleri doğru verin)

Anlaşmazlık yönetimi genellikle hız, tutarlılık ve zarar önleme arasında rekabet eder. Bağlamınızda başarının nasıl göründüğünü yazın:

  • Daha hızlı çözüm: daha az gidip gelme, net son tarihler
  • Daha az hata: standart kararlar ve daha az “özel durum” istisnası
  • Daha iyi alıcı/satıcı deneyimi: şeffaflık, durum açıklığı, öngörülebilir sonraki adımlar
  • Daha düşük kayıp: gereksiz iadeleri azaltma, istismarı önleme, daha fazla chargeback kazanma

Bu hedefler, hangi verileri toplayacağınızdan hangi eylemleri otomatikleştireceğinize kadar her şeyi etkiler.

Sistemi kim kullanır (ve neye ihtiyaçları var)

Çoğu pazar yerinde sadece “müşteri desteği” yoktur. Tipik kullanıcılar alıcılar, satıcılar, destek temsilcileri, yöneticiler ve finans/riske dahildir. Her grup farklı bir görünüm ister:

  • Alıcılar ve satıcılar: basit adımlar, net delil istekleri, son tarih hatırlatmaları
  • Destek temsilcileri: kuyruklar, şablonlar, dahili notlar, karar rehberliği
  • Yönetici/finans: denetim izi, ödeme kontrolü, chargeback dışa aktarımları, raporlama

v1'de ne olmalı, sonra ne gelmeli

Güçlü bir v1 genellikle şunlara odaklanır: vaka oluşturma, delil toplama, mesajlaşma, son tarihlerle izleme ve denetim iziyle bir kararın kaydı.

Sonraki sürümlere otomatik iade kuralları, dolandırıcılık sinyalleri, gelişmiş analizler ve daha derin entegrasyonlar ekleyebilirsiniz. Erken dönemde kapsamı dar tutmak, kimsenin güvenmediği "her şeyi yapan" bir sistemin önüne geçer.

Hızlı hareket ediyorsanız, tam inşaata karar vermeden önce iş akışını uçtan uca prototiplemek yardımcı olabilir. Örneğin ekipler bazen Koder.ai kullanarak içsel React yönetici paneli + Go/PostgreSQL backend'i sohbet tabanlı bir spesifikasyondan hızla oluşturarak, temel vaka durumları ve izinler doğru hissettikten sonra kaynak kodu dışa aktarırlar.

Anlaşmazlık İş Akışını ve Durumları Modelleyin

Bir anlaşmazlık uygulamasının başarısı, anlaşmazlıkların pazar yerinizde gerçekten nasıl ilerlediğini yansıtıp yansıtmadığına bağlıdır. Mevcut yolculuğu uçtan uca haritalamaya başlayın, sonra bu haritayı sistemin zorlayabileceği küçük bir durum ve kural setine dönüştürün.

Anlaşmazlık yolculuğunu adım adım haritalayın

“Mutlu yol”u bir zaman çizelgesi olarak yazın: intake → delil toplama → inceleme → karar → ödeme/iade. Her adım için not alın:

  • Sonra kim hareket edecek (alıcı, satıcı, temsilci, otomatik kontrol)
  • Hangi bilgiler gerekli (fotoğraflar, takip, mesajlar)
  • Sipariş/ödeme durumunda ne değişir (fon tutma, iade başlatma)

Bu, otomasyon, hatırlatmalar ve raporlama için iskeleti oluşturur.

Net durumlar tanımlayın (ve ne anlama geldikleri)

Durumları birbirini dışlayacak ve anlaşılır tutun. Pratik bir temel:

  • Açıldı: anlaşmazlık oluşturuldu, başlangıç bilgisi bekleniyor
  • Alıcı bekleniyor / Satıcı bekleniyor: tarafın eylemi gerekiyor
  • İncelemede: temsilci veya otomatik kurallar delili değerlendiriyor
  • Çözüldü: karar uygulandı (iade/serbest bırakma/değişim)
  • İtiraz: karar yeniden talep edildi, ikinci seviye inceleme

Her durum için giriş kriterlerini, izin verilen geçişleri ve ilerlemek için gereken alanları tanımlayın. Bu, takılı kalan vakaları ve tutarsız sonuçları önler.

Zaman limitleri, SLA'lar ve yükseltme kuralları

Durumlara son tarihler bağlayın (ör. satıcının takip sağlaması için 72 saat). Otomatik hatırlatmalar ekleyin ve süre dolunca ne olacağını belirleyin: otomatik kapatma, varsayılan karar veya manuel incelemeye yükseltme.

Sonuçlar ve eylemler

Sonuçları durumdan ayrı modelleyin ki neler olduğuna dair iz takip edebilin: iade, kısmi iade, değişim, fon serbest bırakma, hesap kısıtlama/ban veya iyi niyet kredisi.

İstisnaları erken yakalayın

Anlaşmazlıklar karışır. Eksik takip, ayrı gönderimler, dijital ürün teslim kanıtları ve birden çok ürün içeren siparişler (ürün düzeyinde karar vs sipariş düzeyi karar) için yollar ekleyin. Bu dalları erken tasarlamak, sonradan tutarlılığı bozan tek seferlik işlemlerin önüne geçer.

Veri Modelini Tasarlayın (Vakalar, Deliller, Kararlar)

Anlaşmazlık uygulaması, veri modelinin gerçek dünyadaki sorularla eşleşip eşleşmediğine bağlı olarak başarılı olur: “Ne oldu?”, “Kanıt ne?”, “Ne karar verdik?” ve “Daha sonra denetim izi gösterebilir miyiz?” gibi. Küçük bir çekirdek varlık seti isimlendirerek başlayın ve hangi alanların değişebileceği konusunda katı olun.

Çekirdek varlıklar (ve neden varlar)

En azından şunları modelleyin:

  • Order (ne satın alındı, ne zaman, kim tarafından)
  • Payment (tutarlar, para birimi, authorization/capture/refund referansları)
  • User (alıcı, satıcı, temsilci/admin)
  • Dispute / Case (iş akışını izleyen konteyner)
  • Claim reason (standartlaştırılmış sebep kodları ve açıklamalar)
  • Evidence (dosyalar, linkler, takip numarası gibi yapılandırılmış bilgiler)
  • Message (konuşma geçmişi ve sistem bildirimleri)
  • Decision (sonuç, gerekçe, tutarlar, yürürlük tarihleri)

“Dispute”u odaklı tutun: sipariş/ödeme referansı, durum, son tarihler ve delil/karar göstergelerini depolamalıdır.

Değiştirilemez vs düzenlenebilir veriler

İleride savunulması gereken her şeyi append-only olarak ele alın:

  • Durum değişiklikleri (kim/ne zaman/neden)
  • Kararlar ve geri almalarsa kayıtları
  • Delil yüklemeleri ve silinmeler (tombstone kaydı, hard delete yok)
  • İade/chargeback ile ilişkili tutar değişiklikleri

Sadece operasyonel kolaylık için düzenlemelere izin verin:

  • Dahili notlar, etiketler, kuyruk atamaları
  • Görüntüleme amaçlı meta veriler (ör. “satıcı katmanı”) — gerektiğinde yeniden senkronize edilir

Bu ayrımı bir denetim izi tablosu (olay günlüğü) artı vaka üzerindeki mevcut “snapshot” alanları ile yapmak en kolay yoldur.

Zorunlu alanlar ve doğrulama

Erken dönemde katı doğrulama kuralları koyun:

  • Sebep kodları kontrollü bir listeden (gerekirse ödeme sağlayıcı kodlarıyla eşleştirilecek)
  • Tutarlar para birimi, hassasiyet kuralları ve negatif olamaz kısıtlarıyla
  • Tarihler açılış/teslim alınma, yanıt son tarihleri, çözüm süreleri
  • Ekler bazı sebepler için zorunlu (ör. "ürün teslim edilmedi" için takip)

Ekler, güvenlik ve saklama

Delil depolama planlayın: izin verilen dosya türleri, boyut limitleri, virüs taraması ve saklama kuralları (ör. politika izin veriyorsa X aydan sonra otomatik silme). Dosya meta verisini (hash, yükleyen, zaman damgası) saklayın ve blob’u nesne depolamada tutun.

Vaka ID'leri ve aranabilir meta veriler

Tutarlı, insan tarafından okunabilir vaka ID şeması kullanın (ör. DSP-2025-000123). Arama hızını artırmak için order ID, alıcı/satıcı ID, durum, sebep, tutar aralığı ve anahtar tarihler gibi alanları indexleyin ki temsilciler vakaları kuyruktan hızlıca bulabilsin.

Roller, İzinler ve Hassas Veri Kontrolleri

Anlaşmazlıklar birden fazla tarafı ve yüksek riskli verileri içerir. Net bir rol modeli hataları azaltır, kararları hızlandırır ve uyumluluk beklentilerini karşılamaya yardımcı olur.

Roller ve yetkileri tanımlayın

Küçük, açık bir rol setiyle başlayın ve bunları sadece ekranlara değil, eylemlere eşleyin:

  • Alıcı / Satıcı: anlaşmazlık oluşturma, delil yükleme, yalnızca görmelerine izin verilen bilgileri görme, mesajlara yanıt verme, önerilen çözümü kabul/ret etme
  • Temsilci: vakaları triage etme, ek bilgi isteme, son tarih belirleme, karar taslağı hazırlama ve standart sonuçları uygulama (iade, değişim, reddetme)
  • Süpervizör: kararları geçersiz kılma, vakayı yeniden açma, yükseltmeleri onaylama, şablon/politika yönetimi
  • Finans: para hareketlerini yürütme/onaylama (iade, ödeme tutma/serbest bırakma), sadece gerekli ödeme alanlarını görme
  • Admin: roller, entegrasyonlar ve saklama kurallarını yapılandırma—ideal olarak varsayılan olarak vaka içeriğini okumadan

Az ayrıcalıklı varsayılanlar kullanın ve yalnızca denetlenebilir acil durumlar için "break glass" erişimi ekleyin.

Kimlik doğrulama ve ayrıcalıklı erişim

Personel için SSO (SAML/OIDC) destekleyin ki erişim HR yaşam döngüsüne uyumlu olsun. Ayrıcalıklı roller (süpervizör, finans, admin) ve para/nihai kararı değiştiren eylemler için MFA zorunlu kılın.

Oturum kontrolleri önemli: personel araçları için kısa ömürlü tokenlar, cihaz bağlamlı yenileme where mümkün ve paylaşılan iş istasyonları için otomatik çıkış.

KİB, ödeme verileri ve alan düzeyinde görünürlük

"Vaka gerçekleri" ile hassas alanları ayırın. Alan düzeyinde izinler uygulayın:

  • Kişisel tanımlayıcı bilgiler (adres, telefon, e-posta)
  • Ödeme detayları (tam PAN asla saklanmasın; tokenize ve maskelenmiş olsun)
  • Dahili notlar ve risk flag'leri

Arayüzde ve loglarda varsayılan olarak redaksiyon uygulayın. Birisi erişim gerektiğinde nedenini kaydedin.

Denetim izi ve delil görünürlük kuralları

Karar değişiklikleri, iadeler, ödeme tutma, delil silme, izin değişiklikleri gibi hassas eylemler için değiştirilemez denetim kaydı tutun. Zaman damgası, aktör, eski/yeni değer ve kaynak (API/UI) bilgilerini ekleyin.

Delil için onay ve paylaşım kurallarını tanımlayın: karşı tarafın neyi görebileceği, neyin dahili kaldığı (ör. dolandırıcılık sinyalleri) ve paylaşılmadan önce neyin kısmen redakte edilmesi gerektiği.

Kullanıcı Deneyimi: Vaka Kuyruğu ve Vaka Detay Ekranları

Bir anlaşmazlık aracının kaderi, bir temsilcinin vakayı ne kadar hızlı triage edip güvenli bir eylem alabileceğine bağlıdır. Arayüz “şimdi kimin ne yapması gerektiğini” açıkça göstermeli, hassas veriler ve geri alınamaz kararlar ise kazara tıklanmayı zorlaştıracak şekilde tasarlanmalıdır.

Vaka kuyruğu: hızlı triage için anlamlı filtreler

Vaka listeniz bir operasyon konsolu gibi davranmalı. Ekiplerin gerçek çalışma şeklini yansıtan filtreler ekleyin: durum, sebep, tutar, yaş/SLA, satıcı ve risk skoru. Günlük kullanım için kaydedilmiş görünümler sağlayın (örn. “Yeni yüksek değerli”, “Gecikmiş”, “Alıcı bekleniyor”).

Satırları hızlı okunur yapın: vaka ID, durum etiketi, açık geçen gün, tutar, taraf, risk göstergesi ve sonraki son tarih. Sıralamayı öngörülebilir tutun (varsayılan olarak aciliyet/SLA'ya göre). Toplu işlemleri güvenli eylemlerle sınırlayın.

Vaka detay: gereken her şey, dikkat dağıtmadan

Vaka detay sayfası saniyeler içinde üç soruyu yanıtlamalı:

  1. Ne oldu?
  2. Elimizde hangi deliller var?
  3. Bir sonraki eylem ve son tarih nedir?

Pratik bir düzen: merkezde bir zaman çizelgesi (olaylar, durum değişiklikleri, ödeme/kargo sinyalleri), sağ tarafta bir anlık görüntü paneli (sipariş toplamı, ödeme yöntemi, gönderi durumu, iadeler/chargeback'ler, anahtar ID'ler). İlgili nesnelere (order, payment, shipment) derin linkler bırakın; bu bağlantıları /orders/123 ve /payments/abc gibi göreli yollar olarak tutun.

Bir mesajlar alanı ve hızlı önizleme destekli bir delil galerisi ekleyin (fotoğraflar, PDF'ler) plus meta veriler (kim gönderdi, ne zaman, tür, doğrulama durumu). Temsilcilerin ekleri aramak zorunda kalmaması gerekir.

Net, güvenli eylemler (koruyucularla)

Karar eylemleri (iade, reddetme, ek bilgi isteme, yükseltme) net olmalı. Geri alınamaz adımlar için onay pencereleri kullanın ve yapılandırılmış girişler zorunlu kılın: zorunlu not, sebep kodu ve tutarlı ifade için şablonlar.

İç iş birliği kanallarını ayırın: dahili notlar (sadece temsilci için) ve harici mesajlar (alıcı/satıcı görünür). Atama kontrolleri ve “mevcut sahibi” görünürlüğü ekleyin ki aynı vaka üzerinde çift çalışma olmasın.

Erişilebilirlik ve mobil uyumluluk

Klavye navigasyonu, okunabilir durum kontrastı ve ekran okuyucu etiketleri için tasarlayın—özellikle eylem butonları ve form alanlarında. Mobil görünümde snapshot, son mesaj, sonraki son tarih ve delil galerisine tek dokunuşla erişim öncelikli olsun.

Mesajlaşma, Bildirimler ve Son Tarihler

Build and Earn Credits
Get credits by sharing what you build with Koder.ai or inviting teammates to try it.

Anlaşmazlıklar çoğunlukla zaman sınırlı iletişim sorunlarıdır. Uygulamanız “sırada kim var, ne zaman ve hangi kanal üzerinden” sorusunu açıkça göstermeli—e-posta zincirleri içinde kaybolmaya zorlamadan.

Kanallar: önce uygulama içi, e-posta her zaman, SMS isteğe bağlı

Her istek, cevap ve ekvakar timeline üzerinde saklanmalı; uygulama içi mesajlaşmayı kaynak olarak kullanın. Ardından önemli güncellemeleri e-posta ile yansıtın (yeni mesaj, delil istendi, son tarih yaklaşması, karar verildi). SMS ekliyorsanız sadece zaman duyarlı hatırlatmalar için kullanın ("24 saat içinde son tarih" gibi) ve metinde hassas bilgi vermeyin.

Geri-gideni azaltan şablonlar

Temsilcilerin tutarlı kalması ve kullanıcıların “iyi delil”in ne olduğunu bilmesi için ortak istekler için şablonlar oluşturun:

  • Teslimat kanıtı isteme (taşıyıcı, takip numarası, teslimat kaydı)
  • Fotoğraf isteği (ürün durumu, ambalaj, seri numarası)
  • İade talimatları (adres, RMA, son tarih, izin verilen taşıyıcılar)

Yer tutuculara (sipariş ID, tarihler, tutarlar) izin verin ve kısa bir "insan düzenleme" alanı bırakın ki cevaplar mekanik olmasın.

Son tarihler, hatırlatmalar ve süre dolunca ne olur

Her istek bir son tarih üretmeli (ör. satıcının 3 iş günü içinde yanıt vermesi). Bunu vakada belirgin gösterin, otomatik hatırlatmalar gönderin (48saat/24saat) ve yanıtsız kalma durumunda net sonuçlar tanımlayın (otomatik kapatma, otomatik iade veya yükseltme).

Çok dilli ve güvenli varsayılan ayarlar

Birden fazla bölgeye hizmet veriyorsanız, mesaj içeriğini dil etiketiyle saklayın ve yerelleştirilmiş şablonlar sağlayın. Kötüye kullanımı önlemek için vaka/kişi başına hız sınırlamaları, ek boyut/tipi limitleri, virüs taraması ve güvenli render (inline HTML yok, dosya isimlerini sanitize et) ekleyin. Kim ne gönderdiğini ve ne zaman gönderdiğini denetim günlüğünde tutun.

Delil Toplama ve Doğrulama

Delil, çoğu anlaşmazlığın kazanıldığı veya kaybedildiği noktadır; bu yüzden uygulamanız delili birinci sınıf iş akışı gibi ele almalı—eklerin yığıldığı bir depo gibi değil.

Hangi delilleri kabul edeceğinizi planlayın

Yaygın pazar yeri anlaşmazlıklarında beklediğiniz delil türlerini tanımlayarak başlayın: takip linkleri ve teslimat kayıtları, paket/ürün fotoğrafları, faturalar, sohbet geçmişi, iade etiketleri ve dahili notlar. Bu türleri açıkça yapmak doğrulamayı, standart incelemeyi ve ileride raporlamayı kolaylaştırır.

Anlaşmazlık nedenine göre delil talep edin

Genel "her şeyi yükleyin" istemek yerine, neden kodundan yapılandırılmış delil istekleri oluşturun (örn. "Ürün teslim edilmedi" → taşıyıcı takibi + teslimat kanıtı; "Açıklamaya uymuyor" → ilan görüntüsü + alıcı fotoğrafları). Her istek şu bilgileri içermeli:

  • Ne yüklenmeli
  • Kısa bir örnek ("iyi" olan neye benziyor)
  • SLA ile uyumlu son tarih

Bu, gidip gelmeleri azaltır ve incelemelerin karşılaştırılabilir olmasını sağlar.

Bütünlük ve delilin zincirini koruma kontrolleri ekleyin

Delili hassas kayıt gibi ele alın. Her yükleme için saklayın:

  • Dosyanın kriptografik hash'i (örn. SHA-256)
  • Sunucu tarafı zaman damgaları
  • Yükleyen kimlik (kullanıcı/servis), rol ve gerekliyse IP
  • Yükleme, indirme ve silme için değiştirilemez olay kayıtları

Bu kontroller içeriğin doğru olduğunu kanıtlamaz ama dosyanın gönderim sonrası değiştirilip değiştirilmediğini ve kim tarafından işlendiğini kanıtlar.

“Delil paketi” dışa aktarımı yapın

Anlaşmazlıklar sıklıkla harici incelemeye gider (ödeme sağlayıcı, taşıyıcı, tahkim). Ana dosyaları ve bir özet (vaka bilgileri, zaman çizelgesi, sipariş meta verileri, delil indeksini) paketleyen tek tıkla bir dışa aktarım sağlayın. Bunu tutarlı kılın ki ekipler baskı altında güvenebilsin.

Saklama ve silme iş akışları

Delil kişisel veri içerebilir. Bölgeye ve anlaşmazlık türüne göre saklama kuralları uygulayın, yasal gereklilik halinde onaylı silme süreci (onaylar ve denetim kayıtlarıyla) sağlayın.

Karar Verme, Sonuçlar ve İtirazlar

Model States Without Rework
Use Planning Mode to define states, deadlines, and roles before generating code.

Karar verme, anlaşmazlık uygulamasının ya güven inşa etmesini ya da daha fazla iş yaratmasını sağlar. Hedef tutarlılık: benzer vakalar benzer sonuçlar almalı ve her iki taraf da nedenini anlayabilmeli.

Karar politikalarını sade dille yazın

Politikaları okunabilir kurallar olarak tanımlayın, hukuki metin yerine. Her anlaşmazlık nedeni için belgeleyin:

  • Ne onaylanır, ne reddedilir, ne kısmi hak sağlar
  • Hangi deliller zorunlu (ve hangileri "iyi olur")
  • Hangi zaman pencereleri geçerli

Bu politikaları versiyonlayın ki geçmiş kararları eski kurallar çerçevesinde açıklayabilesiniz ve "politika kayması"nı azaltın.

Sadece butonlar değil, karar yardımcıları inşa edin

İyi bir karar ekranı inceleyicileri savunulabilir sonuçlara yönlendirmeli. Neden bazlı kontrol listeleri vaka görüntüsünde otomatik görünmeli (ör. "taşıyıcı taraması var", "fotoğraf hasarı gösteriyor", "ilan X vaat etmiş"). Her kontrol öğesi:

  • İlgili vakadaki delile bağlanmalı
  • Finalize etmeden önce eksik zorunlu delilleri işaretlemeli
  • Düzenlenebilir şablon gerekçe metni ekleyebilmeli

Bu, tutarlı bir denetim izi oluşturur ancak herkesi baştan yazmaya zorlamaz.

Gerçek para etkisini yansıtan sonuçlar

Karar mekanizması finansal etkiyi hesaplamalı, hesap tablolarına bırakmamalı. Saklayın ve gösterin:

  • İade tutarı (tam/kısmi), para birimi ve yuvarlama kuralları
  • Ücretler (işlemci, pazar yeri, itiraz ücretleri), gönderim maliyeti, stok iade tutarları
  • Beklenen chargeback riski veya maruziyet (basit bir skor bile olsa)

Sistemin iadeyi otomatik olarak başlatıp başlatmayacağını veya finans/destek için görev üreteceğini net belirtin (özellikle ödemeler split/parsiyel yakalanmışsa).

İtirazlar: izin verin ama kontrol altında tutun

İtirazlar yeni bilgi ortaya çıktığında gerilimi azaltır—ama sonsuz döngülere de dönüşebilir. İtirazın ne zaman mümkün olduğunu, "yeni" delilin ne anlama geldiğini, kimlerin yeniden incelediğini (mümkünse farklı bir inceleyici kuyruğu) ve kaç deneme izinli olduğunu tanımlayın. İtiraz sırasında orijinal kararı dondurun ve raporlamanın ilk/sonuçlandırılmış kararları ayırt etmesi için bağlı bir itiraz kaydı oluşturun.

Kararları her iki tarafa da açıklayın

Her karar alıcıya ve satıcıya yönelik iki mesaj üretmeli. Net dil kullanın, dikkate alınan ana delilleri listeleyin ve sonraki adımları (itiraz hakkı ve son tarih dahil) belirtin. Jargon kullanmaktan ve tarafları suçlamaktan kaçının—olayları ve politikayı temel alın.

Entegrasyonlar: Siparişler, Ödemeler, Kargo ve Destek Araçları

Entegrasyonlar, anlaşmazlık aracını bir "notlar uygulaması" olmaktan çıkarıp gerçek dünyayla doğrulama yapabilen ve güvenle sonuçları yürütebilen bir sisteme dönüştürür. Öncelikle gerçeğin anlaşılması için hangi dış sistemlerin anlaşması gerektiğini listeleyin: sipariş yönetimi, ödeme sağlayıcıları, kargo taşıyıcıları ve e-posta/SMS sağlayıcılarınız.

Doğru senkron stratejisini seçin (webhook vs zamanlı çekme)

Zaman duyarlı değişiklikler için—chargeback uyarıları, iade durumu veya ticket güncellemeleri gibi—webhook tercih edin. Bunlar gecikmeyi azaltır ve vaka zaman çizelgesini güncel tutar.

Webhooks olmayan veya güvenilir olmayan sağlayıcılar için zamanlı çekme (polling) kullanın (kargo sağlayıcılarında yaygın). Pratik bir hibrit:

  • Ödemeler ve dahili sipariş olayları için webhooks
  • Gönderim taramaları ve teslimat onayları için zamanlı çekme

Hangi yöntemi seçerseniz seçin, vaka üzerinde “son bilinen dış durum”u saklayın ve audit/debug için ham yükü (raw payload) tutun.

İdempotentlik: para hareketleri için güvenlik rayı

Finansal eylemler tekrara karşı güvenli olmalı. Ağ yeniden denemeleri, çift tıklama ve webhook yeniden teslimleri duplicate iadeler tetikleyebilir.

Her para etkileyen çağrıyı idempotent yapın:

  • Her vaka sonucu için benzersiz bir eylem anahtarı üretin (örn. case_id + decision_id + action_type)
  • Ödeme API çağrısından önce bir “entegrasyon eylem” kaydı persist edin
  • Aynı anahtar tekrar geldiğinde no-op döndürün (ilk sonucu verin)

Bu desen kısmi iadeler, void'ler ve ücret iade işlemleri için de geçerlidir.

Destek ve hata ayıklama için entegrasyon olay günlükleri

Bir şey uyuşmadığında (iade "pending" diyor veya teslimat taraması eksik) ekibin görünürlüğe ihtiyacı olur. Her entegrasyon olayını şu bilgilerle loglayın:

  • Zaman damgası, sağlayıcı, endpoint/olay türü
  • İstek/yanıt payload'ları (hassas alanları redakte ederek)
  • Vakaya ve birbirine bağlayan korelasyon ID'leri

Vaka detayında hafif bir “Entegrasyon” sekmesi açın ki destek kendi kendine sorun çözebilsin.

Sandbox ve test modları

Başından itibaren güvenli ortamlar planlayın: ödeme işleyici sandbox, kargo test takip numaraları (veya mock yanıtlar), e-posta/SMS test alıcıları. Üretim dışı ortamlarda sahte iade tetiklememek için belirgin bir "test modu" bandı gösterin.

Yönetici araçları inşa ediyorsanız, gereken kimlik bilgileri ve izinleri /docs/integrations gibi dahili bir sayfada belgelendirin ki kurulum tekrarlanabilir olsun.

Sürdürülebilir Tutacak Mimari Seçimleri

Bir anlaşmazlık yönetim sistemi hızla büyür: delil yüklemeleri, ödeme sorguları, son tarih hatırlatıcıları ve raporlama eklersiniz—bu yüzden mimari sıkıcı ve modüler olmalı.

Ekiplerinizin teslim edebileceği bir stack seçin

v1 için ekibinizin zaten bildiği teknolojilere öncelik verin. Geleneksel bir kurulum (React/Vue + REST/GraphQL API + Postgres) genellikle yeni bir framework denemekten daha hızlıdır. Amaç tahmin edilebilir teslim, yenilik değil.

Erken iterasyonu hızlandırmak için Koder.ai gibi platformlar, yazılı bir iş akışı spesinden çalışan bir React + Go + PostgreSQL temeli üretebilir ve kaynak kodu dışa aktarma seçeneğini sunar—kilitlenmeyi önler.

Sorumlulukları baştan ayırın

Açık sınırlar koyun:

  • Ön uç uygulama: yönetici paneli ve alıcı/satıcı görünümleri
  • API servisi: iş mantığı, izinler, doğrulama, denetim izi
  • Arka plan işleri: bildirimler, dışa aktarımlar, delil işleme, entegrasyonlar
  • Dosya depolama: delil dosyaları veritabanı dışında (nesne depolama), meta veriler tabloda

Bu ayrım, belirli parçaları (ör. arkaplan işlemleri) ölçeklendirirken tüm uygulamayı yeniden yazma ihtiyacını azaltır.

Uzun süren işler için kuyruk kullanın

Delil işleme virüs taraması, OCR, dosya dönüşümleri ve dış servis çağrıları içerebilir. Dışa aktarımlar ve zamanlı hatırlatmalar da ağır olabilir. Bu işleri bir kuyruğa koyun ki UI hızlı kalsın. İlgili iş durumunu vaka üzerinde takip edin ki operatörler neyin beklediğini görsün.

Arama ve filtreleme performansını planlayın

Vaka kuyrukları arama performansına bağlıdır. Durum, SLA/tarih, ödeme yöntemi, risk flag'leri ve atanmış temsilciye göre filtreleme için indeksler ekleyin. Erken dönemde indeks ekleyin; gerekirse tam metin arama düşünün. Sayfalama ve kaydedilmiş görünümler tasarlayın.

Ortamlar, dağıtımlar ve geri alma planı

Baştan staging ve production ortamlarını tanımlayın; chargeback, iade otomasyonu, itiraz iş akışı gibi gerçek senaryoları yansıtan seed verilerle. Versiyonlu migration'lar, riskli değişiklikler için feature flag'leri ve rollback planı oluşturun ki sık deploy yaparken aktif vakaları kırmayın.

Hızlı iterasyon önemliyse, Koder.ai gibi platformların sunduğu anlık "snapshot ve rollback" özellikleri geleneksel sürüm kontrollerine pratik bir tamamlayıcı olabilir—özellikle iş akışları ve izinler hâlâ evrilirken.

Raporlama, Analitik ve Sürekli İyileştirme

Collect Evidence the Right Way
Create buyer and seller evidence flows with uploads, templates, and due dates.

Bir anlaşmazlık yönetim sistemi, vakalar üzerinde hızlıca ne olduğunu görebildiğinizde gelişir. Raporlama sadece yöneticiler için değil; temsilcilerin öncelik belirlemesine, yöneticilerin operasyonel riskleri fark etmesine ve işletmenin maliyetleri büyümeden politika ayarlaması yapmasına yardımcı olur.

Kararları değiştiren metriklerle başlayın

Eyleme geçirilebilir küçük bir KPI seti izleyin ve bunları görünür yapın:

  • Çözüm süresi (ortalama ve p90), sebep kodu ve satıcı segmentine göre ayrılmış
  • Backlog büyüklüğü ve yaşlanma kutuları (0–2 gün, 3–7, 8+)
  • Chargeback ve itiraz kazanç oranları, ödeme yöntemi ve delil türüne göre
  • İade toplamları ve iade oranı, önlenebilir iadeler (politika boşlukları)
  • Tekrarlayan kötü niyetli kullanıcılar (alıcı/satıcı), eşik ve trendler

Temsilciler ve yöneticiler için panolar

Temsilciler için operasyonel bir görünüm: "Sırada ne çalışmalıyım?" sorusunu yanıtlayan kuyruk tarzı pano. Yöneticiler için desen tespiti: belirli sebep kodlarında artış, yüksek riskli satıcılar, beklenmedik iade toplamları ve politika değişikliklerinden sonra düşen kazanma oranları. Basit haftalık karşılaştırma genellikle abartılı grafik sayfalarından daha faydalıdır.

Hassas veri sızdırmadan dışa aktarımlar

CSV dışa aktarımlarını ve zamanlı raporları destekleyin, ama şu korumaları koyun:

  • Rol bazlı dışa aktarım izinleri
  • Sütun düzeyinde redaksiyon (PII, ödeme tanımlayıcıları)
  • Kim, ne zaman, hangi veriyi dışa aktardı kaydı

Veri kalitesini etiketler ve sebep kodlarıyla iyileştirin

Analitik ancak vakalar tutarlı etiketlendiğinde işe yarar. Kontrollü sebep kodları, normalize edilmiş opsiyonel etiketler ve temsilciler vakayı “Other” ile kapatırken doğrulama istemek veri kalitesini artırır.

İçgörüleri daha iyi politika ve otomasyona çevirin

Raporlamayı bir geri bildirim döngüsü olarak kullanın: aylık en çok kayba neden olan sebepleri gözden geçirin, delil kontrol listelerini iyileştirin, otomatik iade eşiklerini rafine edin ve değişiklikleri belgeleyin ki gelecekteki kohortlarda iyileşme görülsün.

Test, Lansman Kontrol Listesi ve Operasyonel Hazırlık

Bir anlaşmazlık yönetim sistemini göndermek, mükemmel UI'dan çok; eksik delil, geç yanıtlama, ödeme kenar durumları ve sıkı erişim kontrolleri altında doğru davrandığını bilmekle ilgilidir.

Tüm vaka yaşam döngüsünü (ve çirkin yolları) test edin

Gerçek akışları uçtan uca takip eden test senaryoları yazın: aç → delil istendi/alındı → karar → ödeme/iade/tutma. Negatif yollar ve zaman bazlı geçişleri dahil edin:

  • Satıcı hiç yanıtlamaz; son tarih dolar ve vaka otomatik ilerler.
  • Delil sonradan gelir; nasıl işaretleniyor ve kabul ediliyor kontrol edin.
  • Kısmi iadeler, bölünmüş gönderimler, tek siparişte birden çok ürün.
  • İdempotent işlemler için tekrar denemeler (örn. "iade zaten verilmiş").

Bunları API ve arka plan işleri etrafında entegrasyon testleriyle otomatikleştirin; UI regresyonu için küçük bir keşifçi el test kümesi tutun.

İzinler ve hassas verileri bir saldırgan gibi test edin

Rol bazlı erişim hataları yüksek etkili olur. Her rol (alıcı, satıcı, temsilci, süpervizör, finans, admin) için izin matrisi oluşturun ve doğrulayın:

  • Kim delilleri, PII/ödeme verilerini ve dahili notları görüntüleyebilir/düzenleyebilir
  • Alan düzeyinde kurallar (maskelenme, indirme kısıtları, redaksiyon)
  • Denetim izi tamamlığı: her karar değişikliği, iade, hassas dışa aktarma kaydı

İzleme, uyarılar ve "ya bozulursa ne yaparız?"

Sistem arka plan işleri ve entegrasyonlara bağımlı olduğundan monitörleme ekleyin:

  • Başarısız arka plan işleri, takılı vakalar, kaçırılan son tarih tetikleyicileri
  • Entegrasyon hataları ve webhook başarısızlıkları için eşik tabanlı uyarılar
  • Olağandışı artışlar (iade hataları, yükleme hataları, kuyruk birikimi)

Çalışma kitabı + aşamalı dağıtım

Yaygın sorunlar, yükseltme yolları ve manuel müdahale (vaka yeniden açma, son tarih uzatma, iade geri alma, delil yeniden isteme) için dahili bir runbook hazırlayın. Ardından aşamalı dağıtım yapın:

  1. Küçük bir ekip ve sınırlı anlaşmazlık türleriyle pilot
  2. Hacmi genişletin, ardından otomasyon kurallarını kademeli olarak açın
  3. Temsilcilerden haftalık geri bildirim toplayın ve üretime geçmeden önce iş akışlarını güncelleyin

Hızlı iterasyon yaparken, planlama modu (ör. Koder.ai'de bulunan türden) paydaşları durumlar, roller ve entegrasyonlar üzerinde hizalamada yardımcı olabilir.

SSS

What should a marketplace dispute app actually solve (beyond a support form)?

İlk olarak anlaşmazlık türlerini tanımlayın (ürün teslim edilmedi, açıklamaya uymuyor/hasarlı, dolandırıcılık/izinsiz satın alma, chargeback) ve her birini farklı delil gereksinimleri, zaman pencereleri ve sonuçlarla eşleştirin. Anlaşmazlık türünü sadece bir etiket değil, sistemin tutarlı adımları ve son tarihleri zorlayacağı bir iş akışı sürücüsü olarak ele alın.

What features belong in v1 versus later releases?

Pratik bir v1 genellikle şunları içerir: vaka oluşturma, yapılandırılmış delil toplama, uygulama içi mesajlaşma (e-postaya yansıtma), SLA tarihlerinin ve hatırlatmaların takibi, temel bir temsilci kuyruğu ve değiştirilemez bir denetim izi ile karar kaydı. İleri düzey otomasyonları (fraud scoring, otomatik iade kuralları, karmaşık analizler) temel iş akışı güvenilir hale gelene kadar erteleyin.

How do I model dispute states without creating a confusing workflow?

Küçük, birbirini dışlayan bir set kullanın. Örnek:

  • Açıldı (Opened)
  • Alıcı bekleniyor / Satıcı bekleniyor (Waiting on buyer / Waiting on seller)
  • İncelemede (Under review)
  • Çözüldü (Resolved)
  • İtiraz (Appealed)

Her durum için giriş kriterlerini, izin verilen geçişleri ve ilerlemeden önce gereken alanları (ör. belirli bir neden kodu için gerekli deliller) tanımlayın.

How should SLAs, deadlines, and escalations work in a dispute system?

Her durum/eylem için son tarih belirleyin (ör. satıcının takip bilgisini sağlaması için 72 saat). Ardından otomatik hatırlatmalar ekleyin (48 saat/24 saat) ve süre dolduğunda ne olacağını tanımlayın: otomatik kapatma, varsayılan karar veya manuel incelemeye yükseltme. Son tarihleri kuyruğa (önceliklendirme için) ve vaka detayına (açıklık için) görünür yapın.

Why should outcomes be modeled separately from case states?

Durumdan (state) ayrı olarak sonucu (outcome) modelleyin. Sonuçlar genellikle iade, kısmi iade, değişim, fon serbest bırakma, ödeme tersine çevirme, hesap kısıtlaması veya iyi niyet kredisi gibi finansal etkiler içerir. Aynı durum (“Resolved”) farklı finansal sonuçlar doğurabileceği için ayrı modelleme raporlama ve izleme için önemlidir.

What’s the minimum data model for disputes, evidence, and decisions?

En azından şu kayıtları modelleyin: Order, Payment, User, Case/Dispute, Claim reason (kontrollü kodlar), Evidence, Messages, Decision. Sorgulanması gerekebilecek bilgileri ekleme-only (append-only) bir olay günlüğü ile saklayın (durum değişiklikleri, delil yüklemeleri, kararlar, para hareketleri); operasyonel kolaylık için ise iç notlar, etiketleme ve atama gibi alanlara düzenleme izni verin.

Which records should be immutable, and how do I implement an audit trail?

Aşağıdakileri ekleme-only (değiştirilemez) kabul edin:

  • Durum değişiklikleri (kim/ne zaman/neden)
  • Delil yüklemeleri ve silinme tombstone'ları (hard delete yok)
  • Kararlar ve tersine çevirme kayıtları
  • İade/chargeback miktar değişiklikleri

Bu verileri hızlı sorgular için vaka üzerinde bir “anlık görüntü” (snapshot) ile eşleştirin. Böylece soruşturmalar, itirazlar ve chargeback paketleri savunulması kolay olur.

How do I design roles and permissions for sensitive dispute data?

Açık ve eylem bazlı roller tanımlayın (alıcı, satıcı, temsilci, denetçi, finans, admin) ve izinleri sadece ekranlara değil, yapılabilecek işlemlere göre verin. En az ayrıcalık (least-privilege) prensibini uygulayın, ayrıcalıklı roller için SSO + MFA zorunlu kılın ve PII/ödeme alanları için alan düzeyinde maskelenme sağlayın. "Break glass" erişimi yalnızca denetlenebilir acil durumlar için açın.

What should the agent case queue include to support fast triage?

Operasyonel bir kuyruk oluşturun: durum, neden, tutar, yaş/SLA, satıcı ve risk puanı gibi filtreler ekleyin. Satırların hızlı okunabilir olmasına dikkat edin: vaka ID, durum etiketi, açık geçen gün, tutar, taraf, risk göstergesi ve sonraki son tarih. "Overdue" veya "New high-value" gibi kaydedilmiş görünüm (saved views) sağlayın. Toplu işlemleri güvenli eylemlerle sınırlandırın (atanma/çıkarma, etiket ekleme gibi).

How should messaging and evidence requests be structured to reduce back-and-forth?

Uygulama içi mesajlaşmayı kaynak olarak kullanın; önemli güncellemeleri e-postaya yansıtın ve SMS'i yalnızca zaman duyarlı hatırlatmalar için (metinde hassas bilgi olmadan) tercih edin. Delil isteklerini neden kodundan türetin ve şablonlar kullanın (teslim kanıtı, fotoğraf, iade talimatları). Her isteğe bir son tarih ekleyin ki kullanıcılar ne yapmaları gerektiğini net biçimde bilsinler.

Related posts