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

# Ödeme Sorgulama

Ödeme Sorgulama servisi, bir ödeme işleminin sonucunun:

* teknik problemler nedeniyle response bilgisinden alınamadığı,
* işlem sonucunun tekrar doğrulanmak istendiği

durumlarda kullanılır.

Bu servis ile, daha önce başlatılmış bir ödemenin **nihai durumu** (`Başarılı`, `Başarısız`, `Beklemede` vb.) sistem üzerinden tekrar sorgulanabilir.

> ℹ️ Ödeme sorgulama işlemi **yalnızca bilgi amaçlıdır**, ödeme durumunu değiştirmez.

***

### Endpoint

```http
POST /v1/Payment/CheckPayment
```

***

### 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 için benzersiz kimlik               | 100000000000004         |
| conversationId | ✅       | String  | İşlem takibi için oluşturulan benzersiz kimlik | MSD2024030500000000115  |
| sign           | ✅       | String  | İsteğin doğrulanması için dijital imza         | AAVWY3RZKJVVCEAD8LDQB4K |

***

### Response Body

Ödeme sorgulama servisi, sorgulanan ödemenin **mevcut durumunu** ve detaylarını döner.

#### Örnek Request

```http
POST /v1/Payment/CheckPayment
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
```

```
{
  "merchantId": 100000000000004,
  "conversationId": "MSD2024030500000000115",
  "sign": "AAVWY3RZKJVVCEAD8LDQB4K..."
}
```

#### Örnek Response

```json
{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "02/06/2025 15:45:31",
  "mdStatus": "",
  "conversationId": "YBS57148868202773272",
  "orderId": "5000000045202502030049",
  "paymentId": "5000000045202502030049",
  "bankUniqueReferenceNumber": "503715446698",
  "paymentInstrumentType": "CARD",
  "transactionDate": "02/06/2025 15:45:17",
  "transactionStatus": "Normal",
  "transactionType": "Satış",
  "paymentInfo": {
    "installmentCommission": 0.25,
    "installmentCount": 1,
    "amount": 25.00,
    "currency": "949",
    "authCode": "683819"
  },
  "sign": "AVPGVFPHPS+HXCKT4IWQ6EYL/UMYQANXXHQ6YTNNMA8="
}

```