> For the complete documentation index, see [llms.txt](https://docs.morpara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpara.com/api-dokumantasyonu/bincheck/iptal.md).

# İptal

İptal servisi, başarılı bir ödemenin **henüz finansallaşmadan aynı gün içerisinde** iptal edilmesini sağlar.

Bu servis ile:

* Ödeme geri alınır.
* Banka ve üye işyeri kayıtları güncellenir.
* İptal işlemi için işlem takibi sağlanır.

> ⚠️ İptal işlemi **sadece aynı gün** finansallaşmamış ödemeler için geçerlidir.\
> Finansallaşmış ödemelerde **iade (Refund)** servisi kullanılmalıdır.

***

### Endpoint

```http
POST /v1/Payment/DoPayment
```

***

### Headers

| Anahtar        | Tür    | Açıklama                                 | Örnek                      |
| -------------- | ------ | ---------------------------------------- | -------------------------- |
| x-ClientID     | String | API istemcisi için benzersiz tanımlayıcı | sizin-istemci-id'niz       |
| x-ClientSecret | String | API istemcisi için gizli anahtar         | sizin-gizli-anahtarınız    |
| x-GrantType    | String | Kullanılan erişim tokeni türü            | istemci\_kimlik\_bilgileri |
| x-Scope        | String | API kapsamı                              | pf\_write, pf\_read        |
| x-Timestamp    | String | İstek zaman damgası                      | 2024-12-17T12:34:56Z       |

***

### Request Body

| Alan                               | Zorunlu | Tür     | Açıklama                                | Örnek                                        |
| ---------------------------------- | ------- | ------- | --------------------------------------- | -------------------------------------------- |
| merchantId                         | ✅       | Integer | Üye işyeri kimlik numarası              | 100000000000004                              |
| paymentId                          | ✅       | String  | İptal edilecek ödemenin kimlik numarası | 100000000000004202402140248                  |
| conversationId                     | ✅       | String  | İşlem takip numarası                    | MSD29715509646227267                         |
| sign                               | ✅       | String  | İsteğin doğrulanması için dijital imza  | PT6JMMJANWWQ6DN5M+DUGIZW4DSVJHX0NI2JRJ0XT3O= |
| transactionDetails.transactionType | ✅       | String  | İşlem türü (VOID = iptal)               | VOID                                         |
| transactionDetails.currency        | ✅       | String  | Para birimi kodu (ISO 4217)             | 949                                          |
| language                           | ✅       | String  | İşlem dili                              | tr                                           |

***

### Response Body

İptal işlemi başarılı ise, sistem aşağıdaki yanıtı döner:

#### Örnek Request

```http
POST /v1/Payment/DoPayment
Content-Type: application/json
x-ClientID: sizin-istemci-id'niz
x-ClientSecret: sizin-gizli-anahtarınız
x-GrantType: istemci_kimlik_bilgileri
x-Scope: pf_write, pf_read
x-Timestamp: 2024-12-17T12:34:56Z
```

```json
{
  "merchantId": 100000000000004,
  "paymentId": "100000000000004202402140248",
  "conversationId": "MSD29715509646227267",
  "sign": "PT6JMMJANWWQ6DN5M+DUGIZW4DSVJHX0NI2JRJ0XT3O=",
  "transactionDetails": {
    "transactionType": "VOID",
    "currency": "949"
  },
  "language": "tr"
}

```

#### Örnek Response

```json
{
  "code": "00",
  "message": "Approved",
  "resultCode": "00",
  "resultDescription": "Başarılı",
  "responseDate": "11/03/2024 12:34:40",
  "conversationId": "MSD29715509646227267",
  "orderId": "100000000000004202402140248",
  "paymentId": "100000000000004202402140248",
  "bankUniqueReferenceNumber": "407100003684",
  "authCode": "562660",
  "sign": "F7GJMMJANWWQ6DN5M+DUGIZW4DSVJHXJNI2JRJ0XT3O="
}

```