esnekpos/TEST-SCENARIOS.md

Node.js entegrasyon paketi - EsnekPOS ödeme sistemi için resmi olmayan istemci

# EsnekPOS Test Senaryoları

Bu belge, EsnekPOS Node.js entegrasyonunuzu test etmek için kapsamlı test senaryoları içerir. 
Her bir senaryo için adım adım talimatlar sağlanmıştır.

## Kurulum

Test araçlarını kullanmak için önce gerekli bağımlılıkları yükleyin:

```bash
cd examples
npm install express body-parser open
```

## Senaryo 1: 3D Ödeme Testi

**Amaç**: Tam bir 3D ödeme akışını test etmek.

1. Demo callback sunucusunu başlatın:
   ```
   node examples/demo-server.js
   ```

2. Yeni bir terminal açın ve link test aracını çalıştırın:
   ```
   node examples/link-tester.js
   ```

3. Link test aracından "1. 3D Ödeme Test Et" seçeneğini seçin.

4. Tarayıcıda açılan sayfada:
   - Test ortamında olduğunuzu doğrulayın
   - 3D Secure sayfasında tüm alanlar otomatik doldurulmuş olmalı
   - "Onayla" butonuna tıklayın

5. İşlem tamamlandığında demo callback sunucusu sayfasında callback verisini görüntüleyin.

6. Callback verisinde şu alanları kontrol edin:
   - STATUS: "SUCCESS" olmalı
   - RETURN_CODE: "0" olmalı
   - ORDER_REF_NUMBER: Gönderdiğiniz değerle aynı olmalı

## Senaryo 2: Ortak Ödeme Sayfası Testi

**Amaç**: Ortak ödeme sayfası akışını test etmek.

1. Demo callback sunucusunu başlatın (halihazırda çalışmıyorsa):
   ```
   node examples/demo-server.js
   ```

2. Link test aracını çalıştırın (halihazırda çalışmıyorsa):
   ```
   node examples/link-tester.js
   ```

3. "2. Ortak Ödeme Sayfası Test Et" seçeneğini seçin.

4. Tarayıcıda açılan ortak ödeme sayfasında:
   - Kart bilgilerini girin:
     - Kart No: 4159562885391991
     - Son Kullanma: 12/2025
     - CVV: 123
     - Kart Sahibi: Test User
   - Taksit seçeneğini "Tek Çekim" olarak seçin
   - "Ödeme Yap" butonuna tıklayın

5. İşlem tamamlandığında demo callback sunucusu sayfasında callback verisini kontrol edin.

## Senaryo 3: BKM Express Testi

**Amaç**: BKM Express ödeme akışını test etmek.

1. Demo callback sunucusunun ve link test aracının çalıştığından emin olun.

2. Link test aracından "3. BKM Express Test Et" seçeneğini seçin.

3. Tarayıcıda açılan BKM Express sayfasında:
   - Test hesap bilgilerini girin:
     - Kullanıcı Adı: isyeri@bkm.com
     - Şifre: 147258
     - Doğrulama Kodu: 123456

4. İşlemi tamamlayın ve callback verisini kontrol edin.

## Senaryo 4: İşlemden Sonra Sorgulama

**Amaç**: Başarılı bir işlemden sonra durumunu sorgulamayı test etmek.

1. Önce yukarıdaki senaryolardan birini uygulayarak başarılı bir ödeme gerçekleştirin.

2. `examples/index.js` örnek kodunu çalıştırın:
   ```
   node examples/index.js
   ```

3. "4. İşlem Sorgula" seçeneğini seçin.

4. Önceki adımda kullanılan sipariş referans numarasını girin.

5. Sorgu sonucunda STATUS değerinin "SUCCESS" ve RETURN_CODE değerinin "0" olduğunu kontrol edin.

## Senaryo 5: İade İşlemi

**Amaç**: Başarılı bir işlem sonrası iade işlemini test etmek.

1. Önce başarılı bir ödeme gerçekleştirin.

2. `examples/index.js` örnek kodunu çalıştırın.

3. "5. İade/İptal İşlemi" seçeneğini seçin.

4. Ödeme işleminde kullanılan sipariş referans numarasını ve iade tutarını girin.

5. İade işleminin sonucunu kontrol edin - STATUS değerinin "ORDER_CANCEL" ve RETURN_CODE değerinin "0" olması gerekir.

## Otomatik Test Koşturma

Entegrasyonun tüm kritik işlevlerini otomatik olarak test etmek için:

```bash
node test/autoTester.js
```

Bu komut, tüm temel API işlevlerini test edecek ve sonuçları `test-reports` dizinine kaydedecektir.

## Test Kartları

Test ortamında şu test kartlarını kullanabilirsiniz:

### Başarılı İşlem Test Kartı
- Kart No: 4159562885391991
- Son Kullanma: 12/2025
- CVV: 123

### Hata Oluşturan Test Kartları
- Kart No: 5100050000006661 - "Kart Limiti Yetersiz" hatası
- Kart No: 5100560000006669 - "İşlem Onaylanmadı" hatası
- Kart No: 5101380000006661 - "Geçersiz işlem" hatası