# İptal ve İade
## İptal
> Ödeme işlemini iptal etmek için kullanılır.
```json
{"openapi":"3.0.3","info":{"title":"Payment Operations - İptal & İade","version":"1.0.1"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/cancel":{"post":{"summary":"İptal","description":"Ödeme işlemini iptal etmek için kullanılır.","tags":["Ödeme"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelPaymentRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelPaymentResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"CancelPaymentRequest":{"type":"object","required":["paymentId"],"properties":{"paymentId":{"type":"string","description":"İptal edilmek istenen ödeme işlemine ait iyzico tarafından verilen **uniq ödeme numarası**."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirmesi için **uniq ID**. İstekte gönderilen değer yanıtta aynen geri döner."},"ip":{"type":"string","description":"İşlemin gönderildiği IP adresi."},"locale":{"type":"string","enum":["tr","en"],"description":"iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır."},"reason":{"type":"string","description":"İptal Nedeni. İptal açıklaması gönderilirse, gönderilmesi zorunlu bir bilgidir.","enum":["OTHER","FRAUD","BUYER_REQUEST","DOUBLE_PAYMENT"]},"description":{"type":"string","description":"İptal açıklaması."}}},"CancelPaymentResponse":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"],"description":"Yapılan isteğin sonucunu belirtir."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId değeri aynen geri döner."},"paymentId":{"type":"string","description":"İptal edilen ödeme numarası."},"price":{"type":"decimal","description":"İptal edilen ödeme tutarı."},"currency":{"type":"string","description":"Para birimi (ödemenin yapıldığı para birimi)."},"authCode":{"type":"string","description":"Banka tarafından dönen yetkilendirme (auth) kodu."},"hostReference":{"type":"string","description":"İşlem referans değeri."},"cancelHostReference":{"type":"string","description":"İptal işlemine ait referans değeri."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","enum":["failure"],"description":"İstek sonucunu ifade eder (başarısız)."},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId."},"paymentId":{"type":"string","description":"İlgili ödeme numarası (varsa)."},"paymentTransactionId":{"type":"string","description":"İlgili ödeme kırılımı numarası (varsa)."},"price":{"type":"decimal","description":"İlgili tutar (varsa)."},"retryable":{"type":"boolean","description":"İşlemin tekrar denenebilir olup olmadığı."}}}}}}
```
## İade
> Ödeme işleminin iadesi için kullanılır. İade işlemi \*\*paymentTransactionId\*\* üzerinden, ödeme kırılımı baz alınarak yapılır. Ödeme tutarı için \*\*tamamen\*\* ya da \*\*kısmi\*\* iade yapılabilir.
```json
{"openapi":"3.0.3","info":{"title":"Payment Operations - İptal & İade","version":"1.0.1"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/refund":{"post":{"summary":"İade","description":"Ödeme işleminin iadesi için kullanılır. İade işlemi **paymentTransactionId** üzerinden, ödeme kırılımı baz alınarak yapılır. Ödeme tutarı için **tamamen** ya da **kısmi** iade yapılabilir.\n","tags":["Ödeme"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPaymentRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPaymentResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"RefundPaymentRequest":{"type":"object","required":["paymentTransactionId","price"],"properties":{"paymentTransactionId":{"type":"string","description":"İade edilecek **ödeme kırılımı** numarası (**paymentTransactionId**)."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirmesi için uniq ID."},"ip":{"type":"string","description":"İşlemin gönderildiği IP adresi."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"price":{"type":"decimal","description":"İade edilmek istenen tutar. Kırılım tutarından **yüksek olmamalıdır**."},"currency":{"type":"string","description":"Ödemenin yapıldığı para birimi."},"reason":{"type":"string","description":"İade Nedeni. İade açıklaması gönderilirse, gönderilmesi zorunlu bir bilgidir.","enum":["OTHER","FRAUD","BUYER_REQUEST","DOUBLE_PAYMENT"]},"description":{"type":"string","description":"İade açıklaması."}}},"RefundPaymentResponse":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"],"description":"Yapılan isteğin sonucunu belirtir."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId değeri aynen geri döner."},"paymentId":{"type":"string","description":"Ödeme numarası."},"paymentTransactionId":{"type":"string","description":"İadesi yapılan ödeme kırılımı numarası."},"price":{"type":"decimal","description":"İade edilen tutar."},"currency":{"type":"string","description":"Para birimi."},"authCode":{"type":"string","description":"Banka tarafından dönen yetkilendirme (auth) kodu."},"hostReference":{"type":"string","description":"Ödemeye ilişkin banka tarafından verilen referans değeri."},"refundHostReference":{"type":"string","description":null},"retryable":{"type":"boolean","description":"İşlemin tekrar denenebilir olup olmadığını belirtir.","enum":[true,false]},"signature":{"type":"string","description":"İmza doğrulaması yapılabilecek signature değeri."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","enum":["failure"],"description":"İstek sonucunu ifade eder (başarısız)."},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId."},"paymentId":{"type":"string","description":"İlgili ödeme numarası (varsa)."},"paymentTransactionId":{"type":"string","description":"İlgili ödeme kırılımı numarası (varsa)."},"price":{"type":"decimal","description":"İlgili tutar (varsa)."},"retryable":{"type":"boolean","description":"İşlemin tekrar denenebilir olup olmadığı."}}}}}}
```
## İade V2
> \*\*paymentId\*\* üzerinden iade yapılmasını sağlar. Ödeme kırılımı belirtilmez; iade edilecek kırılım sistem tarafından otomatik belirlenir. Ödeme tutarı için \*\*tamamen\*\* ya da \*\*kısmi\*\* iade yapılabilir.
```json
{"openapi":"3.0.3","info":{"title":"Payment Operations - İptal & İade","version":"1.0.1"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/payment/refund":{"post":{"summary":"İade V2","description":"**paymentId** üzerinden iade yapılmasını sağlar. Ödeme kırılımı belirtilmez; iade edilecek kırılım sistem tarafından otomatik belirlenir. Ödeme tutarı için **tamamen** ya da **kısmi** iade yapılabilir.\n","tags":["Ödeme"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPaymentV2Request"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPaymentV2Response"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek içeriğinin formatı."}},"schemas":{"RefundPaymentV2Request":{"type":"object","required":["paymentId","price"],"properties":{"paymentId":{"type":"string","description":"İade edilecek **ödeme** numarası."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirmesi için uniq ID."},"ip":{"type":"string","description":"İşlemin gönderildiği IP adresi."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"price":{"type":"decimal","description":"İade edilmek istenen tutar. Ödeme tutarından **büyük olmamalıdır**."},"currency":{"type":"string","description":"Ödemenin yapıldığı para birimi."}}},"RefundPaymentV2Response":{"type":"object","properties":{"status":{"type":"string","enum":["success","failure"],"description":"Yapılan isteğin sonucunu belirtir."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId değeri aynen geri döner."},"paymentId":{"type":"string","description":"İadesi yapılan ödeme numarası."},"price":{"type":"decimal","description":"İade edilen tutar."},"currency":{"type":"string","description":"Para birimi."},"authCode":{"type":"string","description":"Banka tarafından dönen yetkilendirme (auth) kodu."},"hostReference":{"type":"string","description":"Ödemeye ilişkin banka tarafından verilen referans değeri."},"refundHostReference":{"type":"string","description":null},"retryable":{"type":"boolean","description":"İşlemin tekrar denenebilir olup olmadığını belirtir.","enum":[true,false]},"signature":{"type":"string","description":"İmza doğrulaması yapılabilecek signature değeri."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","enum":["failure"],"description":"İstek sonucunu ifade eder (başarısız)."},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Dönen sonucun o anki **epoch ms** değeridir."},"conversationId":{"type":"string","description":"İstekte gönderilen conversationId."},"paymentId":{"type":"string","description":"İlgili ödeme numarası (varsa)."},"paymentTransactionId":{"type":"string","description":"İlgili ödeme kırılımı numarası (varsa)."},"price":{"type":"decimal","description":"İlgili tutar (varsa)."},"retryable":{"type":"boolean","description":"İşlemin tekrar denenebilir olup olmadığı."}}}}}}
```
---
# 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/on-hazirliklar/api-reference-beta/iptal-ve-iade.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.