# Kısmi Ödeme
Bir satışın farklı ödeme yöntemleri ile parçalı olarak tahsil edilmesini sağlar.
* Kısmi ödeme akışında [**Complete**](#post-v2-terminal-host-gmu-partial-payment-complete) çağrılmadan akış tamamlanmaz ve mali kayıt oluşmaz.
### Kısmi Ödeme Başlatma
## POST /v2/terminal-host/gmu/partial-payment/start
> Aynı satışın farklı ödeme araçlarıyla karşılanabileceği kısmi ödeme akışını başlatır. Dönen saleNumber sonraki adımlarda kullanılır.
```json
{"openapi":"3.0.3","info":{"title":"Terminal API - GMU Ödeme ve İşlem Servisleri","version":"1.0.0"},"tags":[{"name":"GMU Payment","description":"GMU satış ve işlem servisleri"}],"servers":[{"url":"https://sandbox-api.iyzipay.com","description":"Sandbox Ortam"},{"url":"https://api.iyzipay.com","description":"Canlı Ortam"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token kullanılarak Bearer Token doğrulaması yapılır."}},"parameters":{"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İçerik tipi"}},"schemas":{"GmuPaymentRequest":{"type":"object","required":["deviceUniqueId","transactionReferenceId","price","paidPrice","saleAppName","saleAppVersion","saleDocumentType","saleItems","paymentType"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan TR"},"conversationId":{"type":"string","description":"İstek korelasyon ID’si. Boş bırakılırsa otomatik UUID atanır."},"deviceUniqueId":{"type":"string","description":"Cihazın benzersiz kimliği. Maksimum 64 karakter"},"transactionReferenceId":{"type":"string","description":"Çağıran tarafın bu işleme atadığı benzersiz referans ID. İptal ve sorgulama işlemlerinde kullanılabilir."},"price":{"type":"decimal","description":"Brüt tutar. Pozitif olmalıdır"},"paidPrice":{"type":"decimal","description":"Ödenecek nihai tutar. Pozitif olmalıdır"},"paymentType":{"type":"string","description":"Ödeme türü. (Kart, Nakit vb.)","enum":["CARD","CASH"]},"currency":{"type":"string","description":"Para birimi. Varsayılan TRY","enum":["TRY","USD","EUR"]},"installment":{"type":"integer","description":"Taksit sayısı. Varsayılan 1"},"saleAppName":{"type":"string","description":"Satış uygulamasının adı"},"saleAppVersion":{"type":"string","description":"Satış uygulamasının versiyonu"},"saleDocumentType":{"type":"string","description":"Belge tipi. E-Fatura için 1, Gider Pusulası için 9","enum":["1","9"]},"notificationPhone":{"type":"string","description":"SMS bildirimi istenilen telefon numarası"},"notificationEmail":{"type":"string","description":"Bildirim istenilen E-posta adresi"},"saleItems":{"type":"array","description":"Satış kalemleri. En az 1 adet olmalıdır.","minItems":1,"items":{"$ref":"#/components/schemas/SaleItem"}},"buyerInfo":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/BuyerInfo"}],"description":"Nihai tüketici değilse doldurulması zorunludur."}}},"SaleItem":{"type":"object","required":["name","unitCode","taxGroupCode","itemQuantity","unitPriceAmount","grossPriceAmount","totalPriceAmount"],"properties":{"name":{"type":"string","description":"Ürün veya hizmet adı"},"generic":{"type":"boolean","description":"Genel ürün bilgisi"},"unitCode":{"type":"string","description":"Birim kodu. Örnek C62 adet anlamına gelir"},"taxGroupCode":{"type":"string","description":"KDV grubu kodu"},"itemQuantity":{"type":"integer","description":"Ürün adedi"},"unitPriceAmount":{"type":"decimal","description":"Birim fiyat. Pozitif olmalıdır"},"grossPriceAmount":{"type":"decimal","description":"Brüt fiyat. Pozitif olmalıdır"},"totalPriceAmount":{"type":"decimal","description":"Toplam fiyat. Pozitif olmalıdır"}}},"BuyerInfo":{"type":"object","properties":{"customerType":{"type":"integer","description":"Müşteri tipi. 1 bireysel, 2 kurumsal","enum":[1,2]},"firstName":{"type":"string","description":"Ad"},"middleName":{"type":"string","description":"İkinci ad"},"familyName":{"type":"string","description":"Soyad"},"companyName":{"type":"string","description":"Şirket adı. Kurumsal müşteriler için kullanılır"},"taxOfficeCode":{"type":"string","description":"Vergi dairesi kodu"},"taxNumber":{"type":"string","description":"Vergi numarası veya TC kimlik numarası"},"country":{"type":"string","description":"Ülke"},"city":{"type":"string","description":"Şehir"},"district":{"type":"string","description":"İlçe"}}},"GmuPartialPaymentStartResponse":{"type":"object","properties":{"status":{"type":"string","description":"success veya failure"},"errorCode":{"type":"string","description":"Hata kodu"},"errorMessage":{"type":"string","description":"Hata mesajı"},"conversationId":{"type":"string","description":"Korelasyon ID"},"systemTime":{"type":"integer","description":"Zaman damgası epoch ms"},"saleNumber":{"type":"string","description":"Kısmi ödeme akışını temsil eden ana ödeme ID'si. Add Partial Payment ve Complete Partial Payment adımlarında kullanılır."},"remainingPaymentAmount":{"type":"decimal","description":"Henüz ödenmemiş kalan tutar"}}}}},"paths":{"/v2/terminal-host/gmu/partial-payment/start":{"post":{"tags":["GMU Payment"],"description":"Aynı satışın farklı ödeme araçlarıyla karşılanabileceği kısmi ödeme akışını başlatır. Dönen saleNumber sonraki adımlarda kullanılır.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPaymentRequest"}}}},"responses":{"200":{"description":"Başarılı kısmi ödeme başlatma sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentStartResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentStartResponse"}}}}}}}}}
```
### Ödeme İşlemi Ekleme
## POST /v2/terminal-host/gmu/partial-payment/add-payment
> Başlatılmış kısmi ödeme akışına yeni bir ödeme ekler. Kalan tutar sıfırlanana kadar birden fazla kez çağrılabilir.
```json
{"openapi":"3.0.3","info":{"title":"Terminal API - GMU Ödeme ve İşlem Servisleri","version":"1.0.0"},"tags":[{"name":"GMU Payment","description":"GMU satış ve işlem servisleri"}],"servers":[{"url":"https://sandbox-api.iyzipay.com","description":"Sandbox Ortam"},{"url":"https://api.iyzipay.com","description":"Canlı Ortam"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token kullanılarak Bearer Token doğrulaması yapılır."}},"parameters":{"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İçerik tipi"}},"schemas":{"GmuPartialPaymentAddRequest":{"type":"object","required":["saleNumber","price"],"properties":{"locale":{"type":"string","description":"Dil kodu"},"conversationId":{"type":"string","description":"Korelasyon ID"},"deviceUniqueId":{"type":"string","description":"Cihaz benzersiz ID"},"transactionReferenceId":{"type":"string","description":"Bu ekleme işleminin referans ID'si"},"saleNumber":{"type":"string","description":"Start adımından dönen saleNumber"},"price":{"type":"decimal","description":"Bu adımda ödenecek tutar. Kalan tutarı aşmamalıdır"},"installment":{"type":"integer","description":"Taksit sayısı. Varsayılan 1"},"currency":{"type":"string","description":"Para birimi"}}},"GmuPaymentResponse":{"type":"object","properties":{"status":{"type":"string","description":"success veya failure"},"errorCode":{"type":"string","description":"Hata kodu. Başarılı işlemlerde 0 döner"},"errorMessage":{"type":"string","description":"Hata mesajı"},"conversationId":{"type":"string","description":"İstek ile eşleşen korelasyon ID"},"systemTime":{"type":"integer","description":"işlem zamanı (epoch ms)"},"deviceUniqueId":{"type":"string","description":"İşlem yapılan cihazın ID'si"},"transactionReferenceId":{"type":"string","description":"Çağıran tarafın referans ID'si"},"transactionDateTime":{"type":"string","description":"İşlemin gerçekleştiği tarih ve saat"},"paymentId":{"type":"string","description":"Oluşturulan ödeme ID. İade ve iptal işlemlerinde kullanılır."},"paymentDate":{"type":"integer","description":"Ödeme tarihi. YYYYMMDD formatındadır"},"price":{"type":"decimal","description":"İşlem tutarı"},"installment":{"type":"integer","description":"Taksit sayısı"},"acquirerId":{"type":"string","description":"Acquirer banka ID"},"bankMerchantId":{"type":"string","description":"Banka üye işyeri numarası"},"bankTerminalId":{"type":"string","description":"Banka terminal ID"},"issuerId":{"type":"string","description":"Kartı çıkaran kuruluş ID"},"currency":{"type":"string","description":"Para birimi","enum":["TRY","USD","EUR"]},"authCode":{"type":"string","description":"Onay kodu"},"binNumber":{"type":"string","description":"Kartın BIN numarası. İlk 6 hanedir"},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi"},"hostReference":{"type":"string","description":"Host referans numarası"},"cardType":{"type":"string","description":"Kart tipi. Örnek CREDIT veya DEBIT"},"batchNo":{"type":"string","description":"Batch parti numarası"},"stanNo":{"type":"string","description":"STAN numarası"},"posEntryModeCode":{"type":"string","description":"POS giriş modu kodu"},"saleItems":{"type":"array","description":"İşleme eklenen satış kalemleri detayı","items":{"$ref":"#/components/schemas/AddedSaleItem"}},"saleNumber":{"type":"string","description":"Satış numarası. Parçalı ödeme ekleme 7. madde ve tamamlama 8. madde servislerinde kullanılır"}}},"AddedSaleItem":{"type":"object","properties":{"name":{"type":"string","description":"İşleme eklenen satış kalemi adı"},"generic":{"type":"boolean","description":"Genel ürün bilgisi"},"unitCode":{"type":"string","description":"Birim kodu"},"taxGroupCode":{"type":"string","description":"KDV grubu kodu"},"itemQuantity":{"type":"integer","description":"Ürün adedi"},"unitPriceAmount":{"type":"decimal","description":"Birim fiyat"},"grossPriceAmount":{"type":"decimal","description":"Brüt fiyat"},"totalPriceAmount":{"type":"decimal","description":"Toplam fiyat"}}}}},"paths":{"/v2/terminal-host/gmu/partial-payment/add-payment":{"post":{"tags":["GMU Payment"],"description":"Başlatılmış kısmi ödeme akışına yeni bir ödeme ekler. Kalan tutar sıfırlanana kadar birden fazla kez çağrılabilir.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentAddRequest"}}}},"responses":{"200":{"description":"Başarılı kısmi ödeme ekleme sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPaymentResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPaymentResponse"}}}}}}}}}
```
### Kısmi Ödemeyi Tamamla
## POST /v2/terminal-host/gmu/partial-payment/complete
> Tüm kısmi ödemeler eklendikten sonra akışı kapatır ve satışı sonuçlandırır. Tam satış yanıtı döner.
```json
{"openapi":"3.0.3","info":{"title":"Terminal API - GMU Ödeme ve İşlem Servisleri","version":"1.0.0"},"tags":[{"name":"GMU Payment","description":"GMU satış ve işlem servisleri"}],"servers":[{"url":"https://sandbox-api.iyzipay.com","description":"Sandbox Ortam"},{"url":"https://api.iyzipay.com","description":"Canlı Ortam"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token kullanılarak Bearer Token doğrulaması yapılır."}},"parameters":{"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İçerik tipi"}},"schemas":{"GmuPartialPaymentCompleteRequest":{"type":"object","required":["deviceUniqueId","transactionReferenceId","saleNumber"],"properties":{"locale":{"type":"string","description":"Dil kodu"},"conversationId":{"type":"string","description":"Korelasyon ID"},"deviceUniqueId":{"type":"string","description":"Cihaz benzersiz ID. Maksimum 64 karakter"},"transactionReferenceId":{"type":"string","description":"Bu tamamlama işleminin referans ID'si"},"saleNumber":{"type":"string","description":"Start partial payment adımından dönen saleNumber"}}},"GmuPartialPaymentCompleteResponse":{"allOf":[{"$ref":"#/components/schemas/GmuPaymentResponse"},{"type":"object","properties":{"remainingPaymentAmount":{"type":"decimal","description":"Kalan ödeme tutarı. Başarılı tamamlamada 0 olmalıdır"}}}]},"GmuPaymentResponse":{"type":"object","properties":{"status":{"type":"string","description":"success veya failure"},"errorCode":{"type":"string","description":"Hata kodu. Başarılı işlemlerde 0 döner"},"errorMessage":{"type":"string","description":"Hata mesajı"},"conversationId":{"type":"string","description":"İstek ile eşleşen korelasyon ID"},"systemTime":{"type":"integer","description":"işlem zamanı (epoch ms)"},"deviceUniqueId":{"type":"string","description":"İşlem yapılan cihazın ID'si"},"transactionReferenceId":{"type":"string","description":"Çağıran tarafın referans ID'si"},"transactionDateTime":{"type":"string","description":"İşlemin gerçekleştiği tarih ve saat"},"paymentId":{"type":"string","description":"Oluşturulan ödeme ID. İade ve iptal işlemlerinde kullanılır."},"paymentDate":{"type":"integer","description":"Ödeme tarihi. YYYYMMDD formatındadır"},"price":{"type":"decimal","description":"İşlem tutarı"},"installment":{"type":"integer","description":"Taksit sayısı"},"acquirerId":{"type":"string","description":"Acquirer banka ID"},"bankMerchantId":{"type":"string","description":"Banka üye işyeri numarası"},"bankTerminalId":{"type":"string","description":"Banka terminal ID"},"issuerId":{"type":"string","description":"Kartı çıkaran kuruluş ID"},"currency":{"type":"string","description":"Para birimi","enum":["TRY","USD","EUR"]},"authCode":{"type":"string","description":"Onay kodu"},"binNumber":{"type":"string","description":"Kartın BIN numarası. İlk 6 hanedir"},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi"},"hostReference":{"type":"string","description":"Host referans numarası"},"cardType":{"type":"string","description":"Kart tipi. Örnek CREDIT veya DEBIT"},"batchNo":{"type":"string","description":"Batch parti numarası"},"stanNo":{"type":"string","description":"STAN numarası"},"posEntryModeCode":{"type":"string","description":"POS giriş modu kodu"},"saleItems":{"type":"array","description":"İşleme eklenen satış kalemleri detayı","items":{"$ref":"#/components/schemas/AddedSaleItem"}},"saleNumber":{"type":"string","description":"Satış numarası. Parçalı ödeme ekleme 7. madde ve tamamlama 8. madde servislerinde kullanılır"}}},"AddedSaleItem":{"type":"object","properties":{"name":{"type":"string","description":"İşleme eklenen satış kalemi adı"},"generic":{"type":"boolean","description":"Genel ürün bilgisi"},"unitCode":{"type":"string","description":"Birim kodu"},"taxGroupCode":{"type":"string","description":"KDV grubu kodu"},"itemQuantity":{"type":"integer","description":"Ürün adedi"},"unitPriceAmount":{"type":"decimal","description":"Birim fiyat"},"grossPriceAmount":{"type":"decimal","description":"Brüt fiyat"},"totalPriceAmount":{"type":"decimal","description":"Toplam fiyat"}}}}},"paths":{"/v2/terminal-host/gmu/partial-payment/complete":{"post":{"tags":["GMU Payment"],"description":"Tüm kısmi ödemeler eklendikten sonra akışı kapatır ve satışı sonuçlandırır. Tam satış yanıtı döner.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentCompleteRequest"}}}},"responses":{"200":{"description":"Başarılı kısmi ödeme tamamlama sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentCompleteResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuPartialPaymentCompleteResponse"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.iyzico.com/urunler/fiziksel-pos/terminal-api-entegrasyonu/vuk-507-servisleri/kismi-odeme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.