> 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/iptal-iade.md).
# İptal/İade
### İade
## POST /v2/terminal-host/gmu/payment/refund
> Tamamlanmış bir satış işlemi için kısmi veya tam iade gerçekleştirilir. İade yapılabilecek kalemleri öğrenmek için önce İade Edilebilir Satış Bilgisi servisini çağırmanız önerilir.
```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":{"GmuRefundRequest":{"type":"object","required":["deviceUniqueId","paymentId","paymentDate","transactionReferenceId","saleAppName","saleAppVersion","saleItems"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan TR"},"conversationId":{"type":"string","description":"Korelasyon ID"},"deviceUniqueId":{"type":"string","description":"Cihaz benzersiz ID. Maksimum 64 karakter"},"paymentId":{"type":"string","description":"Satış servisinden dönen paymentId"},"paymentDate":{"type":"integer","description":"Ödeme tarihi. YYYYMMDD formatında olmalıdır"},"transactionReferenceId":{"type":"string","description":"Bu iade işlemine ait referans ID"},"saleAppName":{"type":"string","description":"Satış uygulaması adı"},"saleAppVersion":{"type":"string","description":"Satış uygulaması versiyonu"},"notificationPhone":{"type":"string","description":"SMS bildirimi istenilen telefon numarası"},"notificationEmail":{"type":"string","description":"Bildirim istenilen E-posta adresi"},"saleItems":{"type":"array","description":"İade edilecek kalemler. En az 1 adet olmalıdır","minItems":1,"items":{"$ref":"#/components/schemas/SaleItem"}}},"title":"GmuRefundRequest"},"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"},"GmuRefundResponse":{"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"},"deviceUniqueId":{"type":"string","description":"İşlem yapılan cihaz ID"},"transactionReferenceId":{"type":"string","description":"İade işlemine ait referans ID"},"price":{"type":"decimal","description":"İade tutarı"},"vatAmount":{"type":"decimal","description":"KDV tutarı"},"currency":{"type":"string","description":"Para birimi"},"invoiceNo":{"type":"string","description":"Fatura numarası"},"authCode":{"type":"string","description":"Onay kodu"},"hostReference":{"type":"string","description":"Host referans numarası"},"binNumber":{"type":"string","description":"Kartın BIN numarası"},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi"},"acquirerName":{"type":"string","description":"Acquirer banka adı"},"acquirerId":{"type":"string","description":"Acquirer banka ID"},"batchNo":{"type":"string","description":"Batch numarası"}},"title":"GmuRefundResponse"}}},"paths":{"/v2/terminal-host/gmu/payment/refund":{"post":{"tags":["GMU Payment"],"description":"Tamamlanmış bir satış işlemi için kısmi veya tam iade gerçekleştirilir. İade yapılabilecek kalemleri öğrenmek için önce İade Edilebilir Satış Bilgisi servisini çağırmanız önerilir.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundRequest"}}}},"responses":{"200":{"description":"Başarılı iade sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundResponse"}}}}}}}}}
```
### İptal
## POST /v2/terminal-host/gmu/payment/void
> Aynı gün içinde gerçekleştirilen bir ödeme işlemini iptal eder. Gün sonu yapılmış işlemlerde iptal yerine iade kullanılmalıdı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":{"GmuVoidRequest":{"type":"object","required":["deviceUniqueId","paymentId","paymentDate","transactionReferenceId"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan TR"},"conversationId":{"type":"string","description":"Korelasyon ID"},"deviceUniqueId":{"type":"string","description":"Cihaz benzersiz ID. Maksimum 64 karakter"},"paymentId":{"type":"string","description":"İptal edilecek ödemenin paymentId’si"},"paymentDate":{"type":"integer","description":"Ödeme tarihi. YYYYMMDD formatında olmalıdır"},"transactionReferenceId":{"type":"string","description":"Bu iptal işlemine ait referans ID"},"reason":{"type":"string","description":"İptal nedeni"},"description":{"type":"string","description":"Açıklama"}},"title":"GmuVoidRequest"},"GmuVoidResponse":{"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"},"deviceUniqueId":{"type":"string","description":"Cihaz ID"},"transactionReferenceId":{"type":"string","description":"İptal referans ID"},"paymentId":{"type":"string","description":"İptal edilen ödeme ID"},"price":{"type":"decimal","description":"İptal tutarı"},"currency":{"type":"string","description":"Para birimi"},"authCode":{"type":"string","description":"Onay kodu"},"hostReference":{"type":"string","description":"Orijinal işlemin host referans numarası"},"cancelHostReference":{"type":"string","description":"İptal işlemine ait host referans numarası"},"transactionDate":{"type":"string","description":"İşlem tarihi"},"transactionTime":{"type":"string","description":"İşlem saati"},"paymentDate":{"type":"integer","description":"Ödeme tarihi. YYYYMMDD formatındadır"},"transactionDateTime":{"type":"string","description":"İşlem tarih ve saat bilgisi"},"binNumber":{"type":"string","description":"Kartın BIN numarası"},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi"}},"title":"GmuVoidResponse"}}},"paths":{"/v2/terminal-host/gmu/payment/void":{"post":{"tags":["GMU Payment"],"description":"Aynı gün içinde gerçekleştirilen bir ödeme işlemini iptal eder. Gün sonu yapılmış işlemlerde iptal yerine iade kullanılmalıdır.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuVoidRequest"}}}},"responses":{"200":{"description":"Başarılı iptal sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuVoidResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuVoidResponse"}}}}}}}}}
```
### İade Edilebilir Satış Bilgisi Alma
## POST /v2/terminal-host/gmu/payment/refundable-sale-info
> Belirtilen işlem referansına ait satışın iade edilebilir kalem ve tutar bilgisini döndürür. İade işleminden önce çağrılması önerilir; dönen \`saleUid\` değeri iade isteğinde \`relatedSaleId\` olarak 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":{"GmuRefundableSaleInfoRequest":{"type":"object","required":["transactionReferenceId"],"properties":{"locale":{"type":"string","description":"Dil kodu"},"conversationId":{"type":"string","description":"Korelasyon ID"},"deviceUniqueId":{"type":"string","description":"Cihaz benzersiz ID"},"transactionReferenceId":{"type":"string","description":"Orijinal satış işleminin referans ID'si"}},"title":"GmuRefundableSaleInfoRequest"},"GmuRefundableSaleInfoResponse":{"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":"Satış numarası"},"saleUid":{"type":"string","description":"Satışın benzersiz ID'si. İade isteğinde relatedSaleId olarak kullanılır."},"totalReturnableAmount":{"type":"decimal","description":"Toplam iade edilebilir tutar"},"currency":{"type":"string","description":"Para birimi"},"saleItems":{"type":"array","description":"İade edilebilir kalemler. Her kalem için returnableQuantity ve returnableAmount alanlarını içerir.","items":{"$ref":"#/components/schemas/RefundableAddedSaleItem"}}},"title":"GmuRefundableSaleInfoResponse"},"RefundableAddedSaleItem":{"type":"object","properties":{"id":{"type":"integer","description":"Kalem ID"},"name":{"type":"string","description":"Kalem adı"},"itemQuantity":{"type":"integer","description":"Ürün adedi"},"totalPriceAmount":{"type":"decimal","description":"Toplam fiyat"},"vatAmount":{"type":"decimal","description":"KDV tutarı"},"returnableQuantity":{"type":"integer","description":"İade edilebilir adet"},"returnableAmount":{"type":"decimal","description":"İade edilebilir tutar"}},"title":"RefundableAddedSaleItem"}}},"paths":{"/v2/terminal-host/gmu/payment/refundable-sale-info":{"post":{"tags":["GMU Payment"],"description":"Belirtilen işlem referansına ait satışın iade edilebilir kalem ve tutar bilgisini döndürür. İade işleminden önce çağrılması önerilir; dönen `saleUid` değeri iade isteğinde `relatedSaleId` olarak kullanılır.\n","parameters":[{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundableSaleInfoRequest"}}}},"responses":{"200":{"description":"Başarılı iade edilebilir satış bilgisi sonucu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundableSaleInfoResponse"}}}},"400":{"description":"Hatalı istek","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmuRefundableSaleInfoResponse"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.iyzico.com/urunler/fiziki-pos/terminal-api-entegrasyonu/vuk-507-servisleri/iptal-iade.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.