Identity & Auth

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 Client Credentials akışıyla access token üretimi, refresh kullanımı ve süre yönetimi.

API Anahtarı Yönetimi

Organizasyon başına client_id / client_secret çiftlerinin ü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, OAuth 2.0 Client Credentials akışına göre çalışır: client_id + client_secret ile bir access token alır, sonraki tüm istekleri (Identity dahil ürün servisleri) Authorization: Bearer <access_token> header’ı ile yaparsınız.

Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

Identity’den alınan tek access token, planınızdaki tüm ürün servislerinde geçerlidir — Sanal POS, Para Transferi ve Identity’nin kendisi. Servis başına ayrı kimlik akışı yoktur. Token nasıl alınır: Kimlik Doğrulama.

Slug tabanlı oturum

Identity, çoklu organizasyon (multi-tenant) yapısı için slug tabanlı URL’ler kullanır:

POST /api/v1/auth/{slug}/token
POST /api/v1/auth/{slug}/refresh
POST /api/v1/auth/{slug}/logout
GET  /api/v1/auth/{slug}/me

slug organizasyonunuzun benzersiz tanımlayıcısıdır (örn. acme-bank); onboarding sırasında atanır.

Akış

API anahtarı yönetimi, lookup ve diğer Identity endpoint’leri de aynı Bearer access token ile çağrılır.

Ortam URL’leri

Ortam	Identity Base URL
Sandbox	`https://identity-sandbox.payven.com.tr/api/v1`
Production	`https://identity.payven.com.tr/api/v1`

Mevcut Kullanıcı (/me)

Genel Bakış

Oturum Bilgisi

API Anahtarı Yönetimi

Lookup Servisleri

Doğrulama

Kimlik Doğrulama

API Anahtarı Yönetimi

Referans Veriler

Base URL

Auth modeli

Slug tabanlı oturum

Akış

Ortam URL’leri

Kimlik Doğrulama

API Anahtarı Yönetimi

Referans Veriler

​Base URL

​Auth modeli

​Slug tabanlı oturum

​Akış

​Ortam URL’leri

Base URL

Auth modeli

Slug tabanlı oturum

Akış

Ortam URL’leri