Panel — Operasyonlar & Müdahale

Bu bölüm iki işi yapar: izleme (ne oldu) ve müdahale (takılan paraya ne yapılacak). Müdahaleler doğrudan yürütülmez: bir operatör talep açar, başka bir yetkili onaylar.

İzleme

GET operations                      # filtre: endUserId, walletAccountId, status, operationType
GET operations/:id
GET operations/:id/receipt
GET operations/:id/receipt.pdf
GET operations/export
GET topups/:id
GET withdrawals/:id
GET bill-payments
GET bill-payments/:id

Operasyon alanlarının anlamı: Operasyonlar.

Ops-health — takılı ve askıdaki paranın tek bakışta özeti

GET ops-health

İzin: wallet:operation:read

Liste ekranındaki sayaçlar yalnız o an çekilen sayfayı sayar; ops-health aynı soruyu sunucu tarafında, kiracı genelinde cevaplar. Operasyon ekranında gördüğünüz KPI ile bu ucunuz sayısı farklıysa, otoriter olan budur.

Yanıt ayrıca generatedAt, postingStuckMinutes (varsayılan 5) ve failedLookbackHours (24) alanlarını taşır.

Dört-göz talepleri

Paraya dokunan her müdahale iki adımlıdır:

1. Talep. Bir operatör müdahaleyi talep eder. Talep kalıcı olarak kaydedilir; talep eden, oturumunuzdan alınır.
2. Onay. Talebi açandan farklı bir yetkili talebi onaylar. İşlem ancak bu anda yürütülür.

İstek gövdesinde kişi alanı yoktur. Gövdeye requesterPrincipal ya da approverPrincipal eklenirse istek 400 ile reddedilir. Talebi açan kişi kendi talebini onaylamaya çalışırsa istek 403 WALLET_FOUR_EYES_VIOLATION ile reddedilir; karşılaştırma talep kaydındaki kalıcı "talep eden" alanıyla yapılır.

GET  intervention-requests                 # status, kind, targetId, limit, cursor
GET  intervention-requests/:id
POST intervention-requests/:id/approve     # { reason? }
POST intervention-requests/:id/reject      # { reason }

Talep durumları:

Onaydan sonra sistem bir arıza nedeniyle yürütmeyi tamamlayamazsa talep APPROVED durumunda kalmaz: birkaç dakika içinde otomatik olarak ele alınır. İşlem uygulanmamışsa onaylayanın kaydıyla uygulanır; uygulanmışsa talep EXECUTED olarak kapanır. İşlemin bu taleple uygulandığı kanıtlanamazsa talep FAILED olur ve failureCode: WALLET_INTERVENTION_OUTCOME_UNVERIFIED taşır. Bu durumda kaydın geçmişine bakıp gerekiyorsa yeni talep açın.

Panelde onay kuyruğu Cüzdan → Operasyon → Dört-Göz Onayları ekranındadır. Kendi açtığınız talepte Onayla düğmesi pasiftir ve nedeni yazılıdır.

Askıda fon

Hesabınıza gelen ama sahibi çözülemeyen para askıya alınır.

GET  suspense-funds                       # status ile filtre
POST suspense-funds/:id/match-requests    # { instructionId, reason } — dört-göz talebi
POST suspense-funds/:id/return            # { reason }

Operasyon ve çekim müdahalesi

Takılmış veya tutulmuş bir operasyonu sonuçlandırmak için talep açın. Çekim de bir operasyondur; iki uç aynı talep türünü (OPERATION) üretir.

POST operations/:id/intervention-requests
POST withdrawals/:id/intervention-requests

Geri alma (force_reverse) nasıl ilerler

Geri alma, para hareketinden önce operasyonu REVERSING durumuna alarak başlar. Bu sahiplenmeyi kazanamayan eşzamanlı bir işlem (ör. aynı anda gelen banka sonucu ya da başka bir müdahale) defter kaydına hiç ulaşmaz; para yalnız bir kez geri alınır.

Tutulan nakit çekim kodu

POST cash-out/:id/hold-requests           # { action, reason }

Risk incelemesine takılmış (HELD) bir nakit çekim kodu için talep açar. Aksiyon kümesi farklıdır:

Yükleme iadesi

POST topups/:id/refund-requests           # { reason }

Tamamlanmış bir kart yüklemesinin iadesi için talep açar; iade onay anında yürütülür.

Komisyon

GET business-accounts/:id/commission
PUT business-accounts/:id/commission

İşletme hesabının komisyon yapılandırması. Şema sürümleme: Panel — Limit & Ücret Şemaları.

Müdahale disiplini

1. Önce okuyun, sonra dokunun. Operasyon geçmişi (durum geçişleri) neredeyse her soruyu cevaplar.
2. Gerekçe yazın. reason alanı denetim kaydıdır; sonradan "neden yapılmış" sorusunun tek cevabı.
3. Belirsizde bekleyin. AWAITING_RECON bir karar değil, bir bekleme durumudur.
4. Onaylamadan önce talebi okuyun. Talebi açan ve onaylayan oturumlardan alınır ve aynı kişi olamaz; ikinci gözün değeri, onaylayanın talebi gerçekten incelemesindedir.