---
title: "İptal"
method: POST
path: "/payment/cancel"
tags: ["Ödeme"]
---

# İptal

`POST /payment/cancel`

Ödeme işlemini iptal etmek için kullanılır.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- CancelPaymentRequest
  - `paymentId` string, required — İptal edilmek istenen ödeme işlemine ait iyzico tarafından verilen **uniq ödeme numarası**.
  - `conversationId` string — İstek/yanıt eşleştirmesi için **uniq ID**. İstekte gönderilen değer yanıtta aynen geri döner.
  - `ip` string — İşlemin gönderildiği IP adresi.
  - `locale` 'tr' | 'en' — iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır.
  - `reason` 'OTHER' | 'FRAUD' | 'BUYER_REQUEST' | 'DOUBLE_PAYMENT' — İptal Nedeni. İptal açıklaması gönderilirse, gönderilmesi zorunlu bir bilgidir.
  - `description` string — İptal açıklaması.

## Response `200`

Başarılı yanıt

- CancelPaymentResponse
  - `status` 'success' | 'failure' — Yapılan isteğin sonucunu belirtir.
  - `locale` 'tr' | 'en' — Yanıt dili.
  - `systemTime` integer — Dönen sonucun o anki **epoch ms** değeridir.
  - `conversationId` string — İstekte gönderilen conversationId değeri aynen geri döner.
  - `paymentId` string — İptal edilen ödeme numarası.
  - `price` unknown
  - `currency` string — Para birimi (ödemenin yapıldığı para birimi).
  - `authCode` string — Banka tarafından dönen yetkilendirme (auth) kodu.
  - `hostReference` string — İşlem referans değeri.
  - `cancelHostReference` string — İptal işlemine ait referans değeri.

## Other responses

- `400` — Başarısız yanıt

---

[API](https://skmtc.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)