Getir

API anahtarı: Payment

Bir fatura iadesinin güncel durumunu withdrawal_id (wdr_...) değerine göre döndürür. Çıkış işlemi completed durumuna ulaştığında yanıt, onaylanan tx_hash ve explorer_url alanlarını içerir.

Yanıt (200 OK)

{
  "withdrawal_id": "wdr_6Qm2fK8xR4vN7cT1bY9dL5",
  "invoice_id": "inv_7K2M9P4Q8R1X5Z3A0bC2dE",
  "mode": "full",
  "external_order_id": "refund-1042-full",
  "status": "completed",
  "is_final": true,
  "is_test": false,
  "amount": "100.00",
  "fee": "1.00",
  "currency": "USDT",
  "network": "TRC20",
  "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "first_sender": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "tx_hash": "9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "explorer_url": "https://tronscan.org/#/transaction/9f3b8c2a1d0e4f6789abc123def4567890abc123def4567890abc123def45678",
  "created_at": 1767225600,
  "completed_at": 1767225932,
  "type": "refund",
  "project_id": "prj_3F9xL2mN8pQ4rT6vW1yZ5b"
}

İade durumları

Durum	Açıklama	Uç durum
created	İade oluşturuldu ve bakiye ayrıldı, imzalama bekleniyor	Hayır
signed	İşlem imzalandı ve blockchain ağına yayınlandı	Hayır
pending_review	Yayınlanan işlem TTL süresi içinde onaylanmadı; operatör incelemesi bekleniyor	Hayır
cancelling	Operatör zincir üstü iptal başlattı; hangi işlemin onaylanacağı bekleniyor	Hayır
completed	İade zincir üstünde onaylandı ve first_sender adresine teslim edildi (is_final: true)	Evet
failed	İade sonuçlanmadan önce başarısız oldu veya vazgeçildi; ayrılan fonlar üye işyeri bakiyesine iade edildi	Evet
cancelled	İade yayınlanmadan önce iptal edildi; ayrılan fonlar üye işyeri bakiyesine iade edildi	Evet

Hatalar

Payout (rk_) anahtarı 403 payment_key_required ile reddedilir. withdrawal_id mevcut değilse, bir iade yerine normal çekime aitse veya anahtarınızın kapsamı dışındaki bir projeye aitse uç nokta 404 withdrawal_not_found döndürür. Bkz. Hata Kodları.