İçeriğe atlayın

API

Bu sayfada

Getir

Kimliğiyle bir çekimi getirin, mevcut durumunu ve işlem referansını inceleyin, tamamlanmayı imzalı webhook ile mutabık kılın.

GET/v1/withdrawals/:withdrawal_id

API anahtarı: Payout

Bir çekimin mevcut durumunu döndürür. tx_hash ve explorer_url, izlenen bir zincir üstü işlem oluştuğu anda dolar — bu, completed durumundan önce gerçekleşir. Ödemenin tamamlandığını hash'in varlığı değil, status ve is_final söyler.

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, henüz ağa çıkmadı Hayır
signed İşlem imzalandı ve blok zincirine gönderildi Hayır
cancelling Çekim iptal ediliyor; nasıl sonuçlandığını bir sonraki durum söyler Hayır
completed İşlem zincirde onaylandı, para teslim edildi Evet
failed Çekim çıkmadı. Tutar bakiyeye geri döndü Evet
cancelled Satıcı çekimi iptal etti, çekim çıkmadı. Tutar bakiyeye geri döndü Evet
pending_review İşlem ağda henüz onaylanmadı, tutar rezervde kalır. Panelde bu durum "Onaylanmadı" olarak görünür Hayır

Kodda bunu nasıl okumalı

Üç durum nihaidir: completed, failed ve cancelled. Her yanıtta ve her webhook'ta is_final alanı bulunur; kendi tuttuğunuz bir isim listesine değil, ona göre dallanın.

Bir çekim yalnızca created durumundayken iptal edilebilir. Sonrasında iptal isteği reddedilir; bkz. Çekimi iptal etme. Çekimin neden çıkmadığını API döndürmez: failed bir durumdur, gerekçe alanı yoktur.

Sandbox'ta POST /v1/sandbox/withdrawals/{id}/simulate-completion çağrısı çekimi created durumundan completed durumuna taşır — imza da yoktur, zincir de.

Hatalar

Payment (pk_) anahtarı 403 payout_key_required ile reddedilir. Tam katalog için bkz. Hata Kodları. Her hata yanıtındaki type URI'si ilgili satıra doğrudan bağlanır.

Çekim Listele Çekim İptal Et