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

# Postman

## 🧾 MorPOS Postman Collection

Bu sayfa, MorPOS için hazırlanmış **Postman Collection**'ın referansını sunar.

* Tüm API servisleri (Non-3DS, 3D Secure, Ödeme Sorgulama, BIN Kontrol, İptal, İade) tek bir koleksiyonda birleştirilmiştir.
* Servislerin kullanımı, gerekli header ve request parametreleri, örnek JSON request & response’lar koleksiyon içinde yer almaktadır.
* Postman üzerinden doğrudan çağrı yapabilir, örnek verilerle test edebilirsiniz.

***

### Postman Collection İndir

* Koleksiyonu **Postman’a import** ederek tüm API servislerini kolayca kullanabilirsiniz:

📥 [**Postman Collection İndir**](https://www.morpara.com/)

> ⚡ Koleksiyon, güncel endpoint ve örnek verilerle sürekli olarak güncellenmektedir.\
> 🔒 API çağrıları için `x-ClientID` ve `x-ClientSecret` bilgilerinizi kullanmanız gerekmektedir.

***

### Request Header (Tüm Servisler)

| Alan           | Zorunlu | 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 | Doğrulama için isteğin zaman damgası     | 2024-12-17T12:34:56Z       |
| Content-Type   | ✅       | String | Gönderilen veri formatı                  | application/json           |

***

### Önerilen Environment Değişkenleri

| Değişken     | Açıklama            | Örnek                   |
| ------------ | ------------------- | ----------------------- |
| clientId     | API istemci kimliği | sizin-istemci-id        |
| clientSecret | API gizli anahtarı  | sizin-gizli-anahtar     |
| baseUrl      | API taban URL       | <https://api.ornek.com> |

***

### Kullanım Notları

1. Koleksiyon içindeki tüm servisler için gerekli **header** bilgilerini yukarıdaki gibi ekleyin.
2. Environment değişkenlerini tanımlayarak **kolay test ve import** yapabilirsiniz.
3. Servisler için zorunlu ve opsiyonel alanlar, koleksiyon açıklamalarında belirtilmiştir.
4. Postman ile doğrudan test yapabilir ve örnek request/response’ları inceleyebilirsiniz.