Getir

API anahtarı: Payout

Bir çekimin mevcut durumunu döndürür. Onaylanmış tx_hash ve explorer_url, ödeme çıkışı completed durumuna ulaştığında görünür.

Yanıt (200 OK)

{
  "withdrawal_id": "wdr_2M8K6Q4P9X1Z7A3B",
  "external_order_id": "payout-001",
  "status": "completed",
  "is_final": true,
  "is_test": false,
  "amount": "100.00",
  "fee": "1.00",
  "currency": "USDT",
  "network": "TRC20",
  "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "tx_hash": "9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "explorer_url": "https://tronscan.org/#/transaction/9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "created_at": 1739289600,
  "completed_at": 1739289932
}

Çekim durumları

Durum	Açıklama	Nihai
created	Çekim oluşturuldu, imzalama bekleniyor	Hayır
signed	İşlem imzalandı ve blockchain'e yayınlandı	Hayır
cancelling	Yönetici, pending_review durumundayken iptal başlattı; hangi işlemin zincire düşeceğinin zincir üstü onayı bekleniyor	Hayır
completed	İşlem zincir üzerinde onaylandı, ödeme çıkışı teslim edildi. Hatta nihai (is_final: true), ancak derin bir reorg onu signed durumuna geri gönderebilir — aşağıdaki geçişlere bakın	Evet
failed	Yayınlamadan önce imzalama başarısız oldu, bir operatör takılan çıkışı terk etti veya iptal zincir üzerinde onaylandı. Fonlar bakiyeye döndü	Evet
cancelled	Satıcı, hâlâ created durumundayken iptal etti	Evet
pending_review	İşlem imzalandı ama TTL dolması sonrası zincirde bulunamadı. Manuel çözüm gerektirir	Hayır

Durum Geçişleri

• created -> signed -- işlem imzalandı ve yayınlandı
• created -> cancelled -- satıcı iptal eder (iptal için tek geçerli geçiş)
• created -> failed -- imzalama başarısız oldu
• created -> completed -- satıcı, POST /v1/sandbox/withdrawals/{id}/simulate-completion ile tamamlanmayı simüle eder (yalnızca sandbox — imzalama yok, zincir yok)
• signed -> completed -- işlem zincir üzerinde onaylandı
• signed -> pending_review -- imzalı TX, TTL sonrası zincirde bulunamadı (veya geri çevrildi); geri çevrilen TX, TTL onu yükseltinceye kadar signed kalır
• pending_review -> cancelling -- yönetici iptal başlatır
• pending_review -> completed -- asıl TX zincirde bulunur ve onaylanır (tarayıcı yönlendirmeli, yönetici işlemi değil)
• pending_review -> failed -- yönetici takılan çıkışı terk eder
• cancelling -> completed -- asıl işlem önce onaylandı, yani ödeme çıkışı gerçekleşti
• cancelling -> failed -- iptal işlemi onun yerine zincir üzerinde onaylandı; fonlar bakiyeye döndü
• completed -> signed -- nadir: bir zincir reorg'u onaylanmış çıkış TX'ini yerinden etti; çıkış signed durumuna geri düşer ve o işlem (veya yerine geçeni) madenciliğe alındığında yeniden tamamlanır

Hatalar

Tam katalog için bkz. Hata Kodları. Her hata yanıtındaki type URI'si ilgili satıra doğrudan bağlanır.