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.

Identity & Auth servisi, Payven platformunun omurgasıdır. Tüm ürünler için ortak olan üç işlevi sağlar:

Kimlik Doğrulama

OAuth 2.0 / OIDC tabanlı kullanıcı oturumu, refresh ve logout.

API Anahtarı Yönetimi

Kuruluş başına anahtar üretimi, rotasyonu ve revoke.

Referans Veriler

Banka, BIN, MCC, şehir/ilçe gibi ortak lookup tabloları.

​
Base URL

https://identity.payven.com.tr/api/v1

​
Auth modeli

Identity servisi JWT Bearer token kullanır — diğer ürün servislerinde kullanılan API Key + Secret modelinden farklıdır. 
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Token nasıl alınır: Login.

​
Slug tabanlı oturum

Identity, çoklu kuruluş (multi-tenant) yapısı için slug tabanlı oturum URL’leri kullanır: 
POST /api/v1/auth/{slug}/login
POST /api/v1/auth/{slug}/refresh
GET  /api/v1/auth/{slug}/me
slug, kuruluşunuzun benzersiz tanımlayıcısıdır (örn. acme-bank). Onboarding sırasında atanır. Platform yöneticileri için özel platform slug’ı kullanılır.

​
Kullanım senaryoları

Kim?Ne için?Endpoint
Konsol kullanıcısıKonsola giriş yapmakPOST /auth/{slug}/login
Kuruluş yöneticisiAPI anahtarı oluşturmakPOST /tenants/me/api-keys
GeliştiriciOnboarding sırasında merchant kayıtGET /me
Backend servisiBIN’den banka çözümleme (internal)GET /internal/lookups/bankbins/resolve

​
Hangi servisi ne zaman kullanırsınız?

  • Konsol işlemleri (admin, kullanıcı yönetimi, anahtar oluşturma): Identity üzerinden Bearer token ile.
  • Production işlemleri (ödeme, transfer, fraud): Ürün servislerine API Key + Secret ile.

​
Ortam URL’leri

OrtamIdentity Base URL
Sandboxhttps://identity-sandbox.payven.com.tr/api/v1
Productionhttps://identity.payven.com.tr/api/v1