> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Siparişi geri al

> Siparişin bant genişliğini süresi dolmadan geri al

## Siparişi geri al

Siparişinizin bant genişliği delegasyonunu hemen geri çeker — örneğin adres, kaynağın kiralandığı transferi zaten yaptıysa — sürenin bitmesini beklemeden. **Kullanılmayan süre iade edilmez.** Yalnızca bant genişliği siparişleri erken geri alınabilir.

### Yol parametreleri

**order\_id** `number` *required*

Sipariş kimliği — Buy Bandwidth'in döndürdüğü `id`.

### Yanıt

Get Order ile aynı şekilde sipariş nesnesini döndürür. `status` ne olduğunu gösterir:

| Durum | Anlamı |
| - | - |
| `reclaimed` | Bant genişliği istek beklerken geri alındı (istek en fazla yaklaşık 10 saniye bekler); `undelegate_txid` zincirdeki işlemdir |
| `filled` | Geri alma istek süresi içinde tamamlanmadı; bir sonraki geri alma döngüsü onu tamamlar, genellikle 30 saniye içinde. Sonuç `order.updated` webhook'u ile gelir veya Get Order'ı sorgulayın |
| `reclaiming` | Bu siparişin geri alınması zaten sürüyor |
| `reclaim_failed` | Geri alma, tekrar denemelerden sonra bizim tarafımızda gerçekleşmedi. Sizin yapmanız gereken bir şey yok |

Zaten `reclaiming`, `reclaimed` veya `reclaim_failed` durumundaki bir sipariş için tekrar çağrı siparişi değiştirmeden döndürür, bu yüzden tekrar denemek güvenlidir. API anahtarının `buy_bandwidth` yetkisi olmalıdır.

### Hatalar

| Kod | Durum | Ne zaman |
| - | - | - |
| `ORDER_NOT_FOUND` | `404` | Hesabınızda böyle bir sipariş yok |
| `ORDER_NOT_RECLAIMABLE` | `409` | Sipariş henüz teslim edilmedi (`filled`) veya başarısız oldu |
| `BAD_REQUEST` | `400` | Bant genişliği siparişi değil |
| `FORBIDDEN` | `403` | API anahtarında `buy_bandwidth` yetkisi yok |

### Örnek

```bash theme={null}
curl -X POST https://api.tronrental.com/v1/orders/12345/reclaim \
  -H "X-API-Key: your_api_key"
```

```json Response theme={null}
{
  "id": 12345,
  "type": "bandwidth",
  "target_address": "TRecipientAddress...",
  "volume": 350,
  "duration": "1h",
  "price_trx": "0.42",
  "fixed_fee_trx": "0.2",
  "status": "reclaimed",
  "delegate_txid": "a1b2c3d4e5f6...",
  "undelegate_txid": "f6e5d4c3b2a1...",
  "reclaim_at": "2026-11-11T11:00:00Z",
  "source": "api",
  "activation_id": null,
  "activation_cost_trx": null,
  "fail_reason": null,
  "refunded_trx": null,
  "created_at": "2026-11-11T10:00:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.