> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu/toplu-odeme-sorgulama.md).

# Toplu Ödeme Sorgulama

## Toplu Ödeme Kırılım Detayı Getir

> Belirtilen toplu ödeme kırılımına ait detay bilgilerini döndürür.

```json
{"openapi":"3.0.3","info":{"title":"Toplu Ödeme (Mass Payout) API","version":"1.0.1"},"tags":[{"name":"Mass Payout","description":"Toplu ödeme işlemleri"}],"servers":[{"url":"https://api.iyzipay.com","description":"Canlı (Production)"},{"url":"https://sandbox-api.iyzipay.com","description":"Sandbox"}],"paths":{"/v1/mass/payout/retrieve/items/{referenceCode}":{"get":{"tags":["Mass Payout"],"summary":"Toplu Ödeme Kırılım Detayı Getir","description":"Belirtilen toplu ödeme kırılımına ait detay bilgilerini döndürür.","parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"$ref":"#/components/parameters/LocaleQuery"},{"name":"referenceCode","in":"path","required":true,"description":"Toplu ödeme kırılımına ait benzersiz referans kodu.","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassPayoutItemRetrieveResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"İçerik tipi değeri.","schema":{"type":"string"}},"LocaleQuery":{"name":"locale","in":"query","required":true,"description":"Yanıt dili.","schema":{"type":"string","enum":["tr","en"]}}},"schemas":{"MassPayoutItemRetrieveResponse":{"type":"object","description":"Tekil toplu ödeme kırılımı detayı yanıtı.","properties":{"status":{"type":"string","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (`tr` veya `en`)."},"systemTime":{"type":"integer","description":"Sistem zamanı (epoch ms)."},"item":{"$ref":"#/components/schemas/MassPayoutItemDetail"}}},"MassPayoutItemDetail":{"type":"object","description":"Toplu ödeme kırılım detayı.","properties":{"itemExternalId":{"type":"string"},"referenceCode":{"type":"string"},"recipientType":{"type":"string","enum":["PHONE","IBAN","IDENTITY_NUMBER","MEMBER_ID"]},"recipientInfo":{"type":"string"},"recipientName":{"type":"string"},"description":{"type":"string"},"itemStatus":{"type":"string","description":"Toplu ödeme kırılımı statü durumu.","enum":["FAILED","SUCCESS","INIT","INVALID","PROCESSING","MASS_PAYOUT_CANCELED","QUEUED","DEPOSIT_SUCCESS","DEPOSIT_FAIL"]},"errorMessages":{"type":"array","items":{"type":"string"}},"totalAmount":{"type":"decimal"},"commissionAmount":{"type":"decimal"},"currencyCode":{"type":"string"}}}}}}
```

### Mass Payout Kırılım Statü Durumları

<table data-full-width="true"><thead><tr><th>Status</th><th>Description</th></tr></thead><tbody><tr><td>FAILED</td><td>Öğe bankaya iletilmiş ancak başarısız olmuştur.<br>Bu durum, bankadan dönen hataları veya genel işlem hatalarını içerir.</td></tr><tr><td>SUCCESS</td><td>Öğe bankaya iletilmiş ve başarıyla tamamlanmıştır.</td></tr><tr><td>INIT</td><td>Toplu ödeme oluşturulduğunda, öğeler yetkilendirme (auth) işlemi öncesinde bekleme durumunda (waiting state) saklanır.</td></tr><tr><td>INVALID</td><td>Parametre(ler) geçersiz, eksik veya tutarsızdır.</td></tr><tr><td>PROCESSING</td><td>Öğe bankaya iletilmiş ve işlem devam etmektedir.</td></tr><tr><td>MASS_PAYOUT_CANCELED</td><td><p>Ana toplu ödeme iptal edildiği için ilgili kırılım da iptal edilmiştir.</p><p></p></td></tr><tr><td>QUEUED</td><td>İlgili kırılım kuyruğa alınmıştır (hem banka transferi hem de cüzdan/mevduat akışları için geçerlidir).</td></tr><tr><td>DEPOSIT_SUCCESS</td><td>Başarısız olan kırılım ve buna ait komisyon tutarı, üye işyerinin toplu ödeme bakiyesine başarıyla iade edilmiştir.</td></tr><tr><td>DEPOSIT_FAIL</td><td>Başarısız olan ödeme tutarı ve komisyon tutarı, toplu ödeme bakiyesine iade edilememiştir. </td></tr></tbody></table>

<br>