Skip to main content

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.

API anahtarları, ürün servislerine (Sanal POS, Para Transferi, Fraud, Fatura Ödeme) sunucu-sunucu kimlik doğrulaması için kullanılır. Anahtar yönetimi Identity servisi üzerinden yapılır.

​
Anahtar yapısı

Bir anahtar iki bileşenden oluşur:
BileşenAçıklamaÖrnek
apiKeyPublic tanımlayıcıpvk-prod-MaVpaXii
apiSecretGizli imza anahtarı (yalnızca oluşturma anında bir kez gösterilir)ZQVHx6fpBJa4...
apiKey pvk- prefix’i ile başlar, ardından ortam (prod / test) ve rastgele segment gelir.

​
Endpoint’ler

İşlemEndpointAuth
Anahtarları listeleGET /api/v1/tenants/me/api-keysBearer
Yeni anahtar oluşturPOST /api/v1/tenants/me/api-keysBearer + TenantAdmin
Anahtarı güncellePUT /api/v1/tenants/me/api-keys/{id}Bearer + TenantAdmin
Secret rotasyonuPOST /api/v1/tenants/me/api-keys/{id}/rotate-secretBearer + TenantAdmin
Anahtarı revoke etDELETE /api/v1/tenants/me/api-keys/{id}Bearer + TenantAdmin

​
Yaşam döngüsü

​
Anahtar listesi

curl https://identity.payven.com.tr/api/v1/tenants/me/api-keys \
  -H "Authorization: Bearer ..."

{
  "isSuccess": true,
  "data": {
    "items": [
      {
        "id": "key_8e3f5c12",
        "apiKey": "pvk-prod-MaVpaXii",
        "name": "Production - Ödeme Servisi",
        "environment": "Production",
        "status": "Active",
        "ipWhitelist": ["52.18.42.10", "52.18.42.11"],
        "createdAt": "2026-01-15T10:00:00Z",
        "lastUsedAt": "2026-05-03T12:34:56Z",
        "secret": null
      }
    ],
    "totalCount": 4
  }
}
secret alanı listeleme yanıtında her zaman null döner. Secret yalnızca oluşturma ve rotasyon anında bir kez gösterilir.

​
Kuralname

Her ortam (sandbox / production) için ayrı anahtar oluşturun.
Her servis için ayrı anahtar oluşturmayı düşünün — sızıntı durumunda etki alanı sınırlı kalır.
Production anahtarları için IP whitelist zorunlu kabul edin.
6 ayda bir rotasyona alın.
Ekipten ayrılan üye varsa o kişinin erişebildiği anahtarları rotasyona alın.
Detay: API Anahtarı En İyi Uygulamaları.