> 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/iade.md).

# İade

İade servisi, **gün sonu sürecine girmiş** yani finansallaşmış bir işlemin geri alınmasını sağlar.

Bu servis ile:

* Tüm ödeme veya **parçalı iade** yapılabilir.
* Banka ve üye işyeri kayıtları güncellenir.
* İşlem takibi sağlanır.

> ⚠️ Finansallaşmamış işlemler için **İptal (Void)** servisi kullanılmalıdır.

***

### Endpoint

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

***

### Request Body

| Alan                               | Zorunlu | Tür     | Açıklama                               | Örnek                                        |
| ---------------------------------- | ------- | ------- | -------------------------------------- | -------------------------------------------- |
| merchantId                         | ✅       | String  | Satıcının benzersiz kimlik numarası    | 100000000000004                              |
| language                           | ✅       | String  | İşlem dili                             | tr                                           |
| conversationId                     | ✅       | String  | İşlem takibi için benzersiz kimlik     | MSD000011                                    |
| sign                               | ✅       | String  | İsteğin doğrulanması için dijital imza | NN6JMMJANWWQ6DN5M+DUGIZW4DS2WHX0NI2JRJ0XT3O= |
| orderId                            | ✅       | String  | Siparişin benzersiz kimlik numarası    | 100000000000004202402140269                  |
| paymentId                          | ✅       | String  | İade edilecek ödemenin kimlik numarası | 32423424                                     |
| transactionDetails.transactionType | ✅       | String  | İşlem türü                             | REFUND                                       |
| transactionDetails.currencyCode    | ✅       | String  | Para birimi kodu (ISO 4217)            | 949                                          |
| transactionDetails.amount          | ✅       | Decimal | İade edilecek tutar                    | 1.00                                         |

***

### Response Body

İade 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
```

```json
{
  "merchantId": "100000000000004",
  "language": "tr",
  "conversationId": "MSD000011",
  "sign": "NN6JMMJANWWQ6DN5M+DUGIZW4DS2WHX0NI2JRJ0XT3O=",
  "orderId": "100000000000004202402140269",
  "paymentId": "32423424",
  "transactionDetails": {
    "transactionType": "REFUND",
    "currencyCode": "949",
    "amount": 1.00
  }
}

```

#### Örnek Response

```json
{
  "code": "00",
  "message": "Approved",
  "resultCode": "00",
  "resultDescription": "Başarılı",
  "responseDate": "12/03/2024 12:34:40",
  "conversationId": "MSD2024030500000000120",
  "orderId": "100000000000004202402140269",
  "paymentId": "100000000000004202402140269",
  "bankUniqueReferenceNumber": "407100003684"
}

```