> 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-baslatma.md).

# Toplu Ödeme Başlatma

## Toplu Ödeme Başlat

> Yeni bir toplu ödeme oluşturur. Geçerli kırılımlar INIT durumunda saklanır.<br>

```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/init":{"post":{"tags":["Mass Payout"],"summary":"Toplu Ödeme Başlat","description":"Yeni bir toplu ödeme oluşturur. Geçerli kırılımlar INIT durumunda saklanır.\n","parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"$ref":"#/components/parameters/LocaleQuery"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassPayoutInitializeRequest"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassPayoutInitializeResponse"}}}},"400":{"description":"Başarısız","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassPayoutInitializeResponse"}}}}}}}},"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":{"MassPayoutInitializeRequest":{"type":"object","description":"Toplu ödeme başlatma isteği.","required":["externalId","items"],"properties":{"externalId":{"type":"string","description":"Toplu ödeme isteği için benzersiz kimlik (idempotency)."},"conversationId":{"type":"string","description":"Toplu ödeme için korelasyon ID'si."},"purpose":{"type":"string","description":"Ödemenin iş amacı.","enum":["SALARY","BONUS","SETTLEMENT","GOODS","SERVICES"]},"items":{"type":"array","description":"Ödeme kırılımları.","items":{"$ref":"#/components/schemas/MassPayoutItem"}}}},"MassPayoutItem":{"type":"object","description":"Toplu ödeme kırılımı.","required":["itemExternalId","recipientType","recipientInfo","amount","description"],"properties":{"itemExternalId":{"type":"string","description":"Kırılım bazında ID."},"recipientType":{"type":"string","description":"Alıcı tanımlayıcı tipi.","enum":["PHONE","IBAN","IDENTITY_NUMBER","MEMBER_ID"]},"recipientInfo":{"type":"string","description":"recipientType ile uyumlu tanımlayıcı (telefon, IBAN vb.)."},"amount":{"$ref":"#/components/schemas/Amount"},"description":{"type":"string","description":"Kırılım açıklaması."},"recipientName":{"type":"string","description":"Alıcı adı. `recipientType = IBAN` ise **zorunludur**."},"nonWithdrawable":{"type":"boolean","description":"iyzico cüzdana gönderilecek ücretin çekilemez olmasını sağlar."}}},"Amount":{"type":"object","description":"Tutar bilgisi.","required":["value","currency"],"properties":{"value":{"type":"decimal","description":"Gönderilecek tutar."},"currency":{"type":"string","description":"Para birimi kodu.","enum":["TRY","USD","EUR"]}}},"MassPayoutInitializeResponse":{"type":"object","description":"Toplu ödeme başlatma yanıtı.","properties":{"requestId":{"type":"string","description":"Toplu ödeme için korelasyon / takip kimliği."},"conversationId":{"type":"string","description":"Varsa temel istekteki korelasyon kimliği."},"status":{"type":"string","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (`tr` veya `en`)."},"systemTime":{"type":"integer","description":"Sistem zamanı (epoch ms)."},"invalidItems":{"type":"array","description":"Kırılım seviyesinde hata detayları.","items":{"$ref":"#/components/schemas/InvalidItem"}}}},"InvalidItem":{"type":"object","description":"Geçersiz ödeme kırılım detayı.","properties":{"externalId":{"type":"string","description":"Hata veren kırılım external ID'si."},"errorCode":{"type":"string"},"errorMessage":{"type":"string"}}}}}}
```