Login İşlemleri

Terminal API servislerine erişim sağlamak için iyzico OAuth2 kimlik doğrulama yapısı kullanılmaktadır.

Entegrasyon sürecinde öncelikle login işlemi gerçekleştirilir ve ardından access token alınır. Alınan access token, tüm servis çağrılarında Authorization header içerisinde kullanılır.

Not: Login ve access token alma adımları, hem VUK 507 hem de VUK 509 entegrasyonları için ortaktır.

Login Akışı

1. Login → kullanıcı doğrulanır
2. Token alma → access_token üretilir
3. Servis çağrıları → Bearer token ile yapılır

Kullanıcı Doğrulama ve Yetkilendirme (Authorize) Başlatma

post

https://api.iyzipay.comhttps://sandbox-api.iyzipay.com

/in-store/oauth2/authorize

Bu servis authorization aşamasını başlatır ve "auth code" üretir.

Akış:

1. Bu servise form-urlencoded body ile istek atılır.

2. Yanıttaki "code" değeri alınır.

3. Alınan "code" değeri, token üretmek için "Get Token with Auth Code" servisinde kullanılır.

Body

application/x-www-form-urlencoded

scopestring · enumRequired

Default değer: iyzipayApiGateway

Possible values:

client_idstringRequired

iyzico tarafından sağlanan merchant özelinde clientid değeri.

client_secretstringRequired

iyzico tarafından üretilen merchant özelinde client secret değeri.

response_typestring · enumRequired

Default değer; code

Possible values:

usernamestringRequired

Kullanıcı Adı

passwordstringRequired

Kullanıcı şifre

request_timestampstringRequired

İlgili requestin gönderildiği unix timestamp değeri.

Responses

200Success

application/json

codestringOptional

Auth Code

issuedAtstringOptional

İşlem tarihi

expiredAtstringOptional

İşlem geçerlilik tarihi

401Error

application/json

post/in-store/oauth2/authorize

HTTPcURLJavaScriptPython

POST /in-store/oauth2/authorize HTTP/1.1
Host: api.iyzipay.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 189

"scope='iyzipayApiGateway'&client_id='cclient_id'&client_secret='client_secret'&response_type='code'&username='username'&password='password'&request_timestamp='1755677361682'"

{
  "code": "O6C8tPb0iHee-V_2Kr1stc3AGNzCMziBHjeEmQSgkz7nGuEMeu01ZfvkJSRIEpW0RbtooPNX1YRw_4cGaxVD6ENXPjc01IrnO-REiuzkvjdeYOXDclwZMx-KlJU8rC3n",
  "issuedAt": "2025-12-25T14:05:49.379055098+03:00",
  "expiredAt": "2025-12-25T14:15:49.379055098+03:00"
}

Örnek Collection

Postman

Get Token with Auth Code / Refresh Token

post

https://api.iyzipay.comhttps://sandbox-api.iyzipay.com

/in-store/oauth2/token

Bu servis, auth code kullanarak access_token ve refresh_token üretir.

Authorization (Basic Auth):

• Username: client_id

• Password: client_secret Header formatı: Authorization: Basic base64(client_id:client_secret)

Akış (Auth Code):

1. /authorize çağrısından dönen "code" alınır.

2. Bu servise form-urlencoded body ile gönderilir:

   • grant_type=authorization_code

   • code={authCode}

3. Response içinden:

   • access_token: Terminal Host servislerinde Bearer Token olarak kullanılır.

   • refresh_token: Token yenileme için saklanır.

   • expires_in: access_token geçerlilik süresi (sn).

Authorizations

BasicAuth

AuthorizationstringRequired

Basic Auth ile yetkilendirme. Postman Basic Auth alanları:

• Username: client_id
• Password: client_secret

HTTP header karşılığı: Authorization: Basic base64(client_id:client_secret)

Body

application/x-www-form-urlencoded

or

Responses

200Success

application/json

access_tokenstringOptional

Access Token Değeri

refresh_tokenstringOptional

Refresh Token Değeri

scopestring · enumOptional

Default Scope Değeri

Possible values:

token_typestringOptional

Authoraztion da kullanılan token tipi

expires_ininteger · int32Optional

Saniye bazında geçerlilik süresi.

400Error

application/json

401Error

application/json

post/in-store/oauth2/token

HTTPcURLJavaScriptPython

POST /in-store/oauth2/token HTTP/1.1
Host: api.iyzipay.com
Authorization: Basic username:password
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 57

"grant_type='authorization_code'&code='{{authCode}}'"

Get Token with Auth CodeGet Token with Refresh Token

{
  "access_token": "eyJraWQiOiI4M2Q0NDExYy05M2EzLTRiOWQtOGUwYi0xM2JjZGYxMGZmNTYiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJ1c2VyMSIsImRldmljZU1lbWJlcklkIjoyLCJpc3MiOiJodHRwOi8vMTcyLjIzLjMwLjIyOTo4MDgwIiwiYXV0aG9yaXRpZXMiOlsicG9zX29wZXJhdGlvbnMiXSwiYXVkIjoibWVyY2hhbnQtMS1lY3IxLWludGVncmF0aW9uIiwibmJmIjoxNzY4MjI5NzQ0LCJzY29wZSI6WyJpeXppcGF5QXBpR2F0ZXdheSJdLCJhdXRoRGV2aWNlSWQiOjE0LCJkZXZpY2VNZW1iZXJUeXBlIjoiRUNSX0hPU1QiLCJzaWduaW5nS2V5IjoiUmVKSFpEdTFjMDBxWWFzRjVIZnNYYTJoMENTQ28wNUQiLCJleHAiOjE3NjgyMzY5NDQsImlhdCI6MTc2ODIyOTc0NCwianRpIjoiYzdhMTcwNjctMjEwNC00OGZkLTk5NDMtNzRhNGYwNWYyNGQwIn0.T_fY-zWb3Rw5xdarMHKwX9OKMXEkFoI70o7N1y14cllCB3tOFTp__TDY1rzKU23eaw6dPDHpUSP09eWGJI2XVyhus0hDLwBVyNkObDXPn3DIu55Of0GcfnHi4ic13cpsGG3-M3dg7ri_JSIGle4MkPrRqYXcKVcp4A9mawFnWcWqecdgYJlcQPbwuINXCAUOpQBROg0EEqvuNJwVlQk4aUwm4hgveboGXPAymvc3AbJNzqlljvKrawXRULKcZPFGe8mKFgkUtsvLpYrVhLaQHttAmFKsKmOwDQbugWtZ7jFrGJQPIC6d1Wgkb2xz9gPKB0ic5NIf-tS2hM4lPKQOhw",
  "refresh_token": "HKi_OISDcC451HdL90Nb2FzGrrjFEKzOQCSr3dgYRbe76OCi5zRr7dXaVmCTqTPDnqFdSP-MyDrCXMSAtbrUTRRgy11ZqLToARRyJqpCPpujFqabsRzLqoshKTBaKib",
  "scope": "iyzipayApiGateway",
  "token_type": "Bearer",
  "expires_in": 7199
}

Örnek Collection

Auth Code

Refresh Token

Access token belirli bir süre için geçerlidir. Süresi dolan token ile yapılan isteklerde yetkilendirme hatası alınır. Bu durumda yeniden login yapılarak yeni token alınmalıdır.