Skip to main content
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

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