> 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/fiziki-pos/terminal-api-entegrasyonu/vuk-507-servisleri/kismi-odeme.md).
# 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."}},"title":"GmuPaymentRequest"},"SaleItem":{"type":"object","required":["name","unitCode","taxGroupCode","itemQuantity","unitPriceAmount","grossPriceAmount","totalPriceAmount","relatedSaleItemId","returnAmount"],"properties":{"relatedSaleItemId":{"type":"string","description":"İade edilecek satış kırılımının ID bilgisi."},"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"},"returnAmount":{"type":"decimal","description":"İade tutarı"}},"title":"SaleItem"},"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"}},"title":"BuyerInfo"},"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"}},"title":"GmuPartialPaymentStartResponse"}}},"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"}},"title":"GmuPartialPaymentAddRequest"},"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"}},"title":"GmuPaymentResponse"},"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"}},"title":"AddedSaleItem"}}},"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"}},"title":"GmuPartialPaymentCompleteRequest"},"GmuPartialPaymentCompleteResponse":{"allOf":[{"$ref":"#/components/schemas/GmuPaymentResponse"},{"type":"object","properties":{"remainingPaymentAmount":{"type":"decimal","description":"Kalan ödeme tutarı. Başarılı tamamlamada 0 olmalıdır"}}}],"title":"GmuPartialPaymentCompleteResponse"},"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"}},"title":"GmuPaymentResponse"},"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"}},"title":"AddedSaleItem"}}},"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"}}}}}}}}}
```