Simüle et

API anahtarı: Payment (sandbox)

Yalnızca sandbox. Mevcut bir sandbox iadesini (is_test: true) istenen uç duruma (completed, failed veya cancelled) geçirir, sandbox bakiyesini günceller ve tam iade yüküyle ilgili withdrawal.completed, withdrawal.failed veya withdrawal.cancelled webhook'unu yayar.

İstek gövdesi

Parametre	Tür	Zorunlu	Açıklama
status	string	Evet	Hedef uç durum: "completed", "failed" veya "cancelled"

{
  "status": "completed"
}

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"
}

Kurallar

• —Önce bir sandbox Payment anahtarı (pk_test_) kullanarak POST /v1/refunds ile sandbox iadesini oluşturun, ardından withdrawal_id değerini bu uç noktaya iletin.
• —Zaten istenen uç durumda olan bir iade üzerinde simulate çağırmak idempotenttir ve yinelenen bir webhook yaymadan 200 OK döndürür.
• —İade uç duruma ulaştıktan sonra farklı bir uç durumla simulate çağırmak 409 invalid_withdrawal_state döndürür.
• —"completed" simülasyonu ayrılan bakiye düşüşünü kesinleştirir ve sentetik bir tx_hash atar. "failed" veya "cancelled" simülasyonu ayrılan amount + fee tutarını sandbox bakiyenize geri bırakır ve fatura için yeni bir iade oluşturmanıza olanak tanır.

Hatalar

Kod	HTTP	Ne zaman
payment_key_required	403	İstek bir Payout (rk_) anahtarıyla imzalandı
refunds_not_enabled	503	Fatura iadeleri bu ortamda etkin değil
withdrawal_not_found	404	Kimlik mevcut değil, bir sandbox iadesi değil veya anahtarın proje kapsamı dışında
invalid_withdrawal_state	409	İade zaten farklı bir uç durumda
field_invalid_enum	400	status değeri "completed", "failed" veya "cancelled" değil

Tam sandbox iş akışı için bkz. Test ve tüm hata kodları için bkz. Hata Kodları.