> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox Ortamı

> Production ile birebir aynı API yüzeyini sunan, gerçek para hareketi yapmayan test ortamı.

Sandbox ortamı, production ile **birebir aynı API**'yi sunar — gerçek para hareketi yapılmaz. Banka çağrıları organizasyonunuzun sandbox konnektör konfigürasyonuna göre ya simüle edilir ya da bankanın test ortamına yönlendirilir.

## URL

```
https://vpos-sandbox.payven.com.tr
```

## Sandbox kimlik bilgileri

Konsolu sandbox modunda açıp **Ayarlar → API Anahtarları** ekranından `client_id` + `client_secret` çifti üretin. Sandbox client ID'leri `pvk_test_...` prefix'i ile başlar; production'dan ayrıdır.

Identity'den access token alma akışı [Kimlik Doğrulama](/documentation/concepts/authentication) sayfasında. Sandbox token endpoint'i:

```
https://identity-sandbox.payven.com.tr/api/v1/auth/{slug}/token
```

## Production'dan farklılıklar

| Özellik         | Production            | Sandbox                         |
| --------------- | --------------------- | ------------------------------- |
| Para hareketi   |                       |                                 |
| Webhook teslimi |                       | (gerçek HTTP isteği)            |
| Mutabakat       | — gerçek banka raporu | — simüle veya banka test raporu |
| Rate limit      | Plan'a göre           | 50 RPS                          |

## Banka çağrı modu

Sandbox'ta banka çağrısı, organizasyonunuzun konnektör konfigürasyonuna göre iki şekilde yapılabilir:

| Konfigürasyon                    | Davranış                                                                                                                                                                                                         |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mock konnektör**               | Banka tarafına hiç çağrı atılmaz. Yanıt Payven tarafında simüle edilir; entegrasyon testleri ve CI için idealdir.                                                                                                |
| **Banka test ortamı konnektörü** | Bankanın resmi test ortamına gerçek HTTP çağrısı yapılır. Banka tarafı simülasyon kurallarıyla çalışır (tipik test kartları, 3DS test sayfası, vb.). Banka entegrasyonunun uçtan uca doğrulanması için kullanın. |

Hangi modun aktif olduğunu konsol → **Konnektör Konfigürasyonları** ekranından görebilirsiniz. Yeni bir konfigürasyon eklerken modu seçersiniz.

## Test kart numaraları

Test kart numaraları **bankanın test ortamı tarafından** belirlenir. Konsoldaki **Test Kartları** ekranında, organizasyonunuzun aktif sandbox konfigürasyonlarına göre derlenmiş güncel matris yer alır:

→ [Konsol → Test Kartları](https://dashboard.payven.com.tr/test-cards)

Bu ekran her banka için: başarılı işlem kartları, ret senaryoları (yetersiz bakiye, kart bloke), 3DS challenge/frictionless test kartları ve geçerli son kullanma tarihi / CVV bilgilerini içerir.

## Sandbox → production geçişi

<Steps>
  <Step title="Production credentials">
    Konsoldan production ortamı seçip yeni `client_id` + `client_secret` üretin (`pvk_live_...`).
  </Step>

  <Step title="Base URL'leri değiştirin">
    Identity: `identity-sandbox.payven.com.tr` → `identity.payven.com.tr`<br />
    Sanal POS: `vpos-sandbox.payven.com.tr` → `vpos.payven.com.tr`
  </Step>

  <Step title="Webhook abonelikleri">
    Production webhook abonelikleri farklı `secret` ile gelir — secret manager'ınızı güncelleyin.
  </Step>

  <Step title="Test kartları kaldırın">
    Test kart numaralarını koddan kaldırın, ilk production işleminizi gerçek kartla yapın.
  </Step>

  <Step title="Go-Live Checklist">
    [Production geçişi kontrol listesi](/documentation/security/go-live-checklist) — IP whitelist, secret yönetimi, rate limit, izleme.
  </Step>
</Steps>