> 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"}}}}}}}}}
```