iyzico

https://docs.iyzico.com
Admin
iyzico is an online payment platform that provides a developer portal to facilitate seamless...
Tokens:523,798
Snippets:1,928
Trust Score:9.9
Update:6 days ago
Show doc for...
Tokens:
Raw
### Başarılı Yanıt Örneği

Source: https://docs.iyzico.com/ek-servisler/taksit-ve-bin-sorgulama

Example 200 success response from the installment endpoint. Returns status, locale, systemTime, conversationId and an array of installment details including bank information and installment prices with totals for each installment number.

```json
{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755547819061,
  "conversationId": "123456789",
  "installmentDetails": [
    {
      "binNumber": "54308100",
      "price": 100,
      "cardType": "CREDIT_CARD",
      "cardAssociation": "MASTER_CARD",
      "cardFamilyName": "Paraf",
      "force3ds": 0,
      "bankCode": 12,
      "bankName": "Halkbank",
      "forceCvc": 0,
      "commercial": 0,
      "dccEnabled": 0,
      "agricultureEnabled": 0,
      "installmentPrices": [
        {
          "installmentPrice": 100,
          "totalPrice": 100,
          "installmentNumber": 1
        },
        {
          "installmentPrice": 51.61,
          "totalPrice": 103.22,
          "installmentNumber": 2
        },
        {
          "installmentPrice": 35.08,
          "totalPrice": 105.25,
          "installmentNumber": 3
        },
        {
          "installmentPrice": 18.7,
          "totalPrice": 112.22,
          "installmentNumber": 6
        },
        {
          "installmentPrice": 13.35,
          "totalPrice": 120.19,
          "installmentNumber": 9
        },
        {
          "installmentPrice": 10.77,
          "totalPrice": 129.2,
          "installmentNumber": 12
        }
      ]
    }
  ]
}
```

--------------------------------

### POST /v2/subscription/checkoutform/initialize

Source: https://docs.iyzico.com/urunler/abonelik/abonelik-entegrasyonu/abonelik-islemleri

iyzico Ödeme Formu ile abonelik başlatmak için kullanılır. Ödeme formuna ait content ve token değeri döner.

```APIDOC
## POST /v2/subscription/checkoutform/initialize

### Description
iyzico Ödeme formu (Checkout Form) ile abonelik başlatmak için kullanılır. Ödeme formuna ait content ve token değeri döner.

### Method
POST

### Endpoint
https://api.iyzipay.com/v2/subscription/checkoutform/initialize

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
- **Content-Type** (string) - Required - İstek içeriğinin formatı. Örnek: `application/json`

#### Request Body
- **locale** (string, enum) - Optional - Dil kodu. Varsayılan; tr. Ödeme formunun İngilizce oluşturulması için "en" gönderilmelidir. Örnek: `tr` - Olası değerler: `tr`, `en`
- **callbackUrl** (string) - Required - Ödeme sonucunun gönderileceği callback adresi. Örnek: `https://callbackUrl.com`
- **pricingPlanReferenceCode** (string) - Required - Aboneliğin başlatılacağı planın referans kodu. Örnek: `7515f763-5da3-4a35-8f7f-d425ae44ac04`
- **subscriptionInitialStatus** (string, enum) - Required - Abonelik başlangıç durumu. PENDING gönderilirse abonelik başlamaz ve tekrar aktif edilmesi gerekir. Örnek: `ACTIVE` - Olası değerler: `ACTIVE`, `PENDING`
- **conversationId** (string) - Optional - İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir. Örnek: `123456789`
- **customer** (object, SubscriptionCustomer) - Required - Alıcı Bilgileri

### Request Example
```
POST https://api.iyzipay.com/v2/subscription/checkoutform/initialize
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "callbackUrl": "https://callbackUrl.com",
  "pricingPlanReferenceCode": "7515f763-5da3-4a35-8f7f-d425ae44ac04",
  "subscriptionInitialStatus": "ACTIVE",
  "conversationId": "conversationId",
  "customer": {
    "name": "John",
    "surname": "Stone",
    "email": "john@gmail.com",
    "gsmNumber": "+905545545512",
    "identityNumber": "1234567890",
    "billingAddress": {
      "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
      "zipCode": "34345",
      "contactName": "contactName",
      "city": "Istanbul",
      "country": "Türkiye"
    },
    "shippingAddress": {
      "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
      "zipCode": "34345",
      "contactName": "contactName",
      "city": "Istanbul",
      "country": "Türkiye"
    }
  }
}
```

### Response
#### Success Response (200)
- **status** (string, enum) - Optional - İşlem sonucu. Olası değerler: `success`, `failure`
- **locale** (string, enum) - Optional - Yanıt dili. Olası değerler: `tr`, `en`
- **systemTime** (integer) - Optional - İşlem zamanı (epoch ms). Örnek: `1755596201712`
- **conversationId** (string) - Optional - İstek sırasında gönderilen değer aynen geri döner. Örnek: `123456789`
- **token** (string) - Optional - Ödeme formuna ait token değeri. Örnek: `a9f91f36-2110-4c55-848e-bdd2c7016171`
- **checkoutFormContent** (string) - Optional - Ödeme formuna ait htmlContent değeri.
- **tokenExpireTime** (integer) - Optional - Token geçerlilik süresi (saniye). Örnek: `1800`

#### Response Example
```
{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755596201712,
  "conversationId": "conversationId",
  "token": "a9f91f36-2110-4c55-848e-bdd2c7016171",
  "checkoutFormContent": "<script type=\"text/javascript\">if (typeof iyziInit == 'undefined') {var iyziInit = {currency:\"TRY\",token:\"a9f91f36-2110-4c55-848e-bdd2c7016171\",price:1.00,...}};</script>",
  "tokenExpireTime": 1800
}
```

#### Error Response (400)
- **status** (string, enum) - Optional - İşlem sonucu. Olası değerler: `success`, `failure`
- **locale** (string, enum) - Optional - Yanıt dili. Olası değerler: `tr`, `en`
- **systemTime** (integer) - Optional - İşlem zamanı (epoch ms).
- **conversationId** (string) - Optional - İstek sırasında gönderilen değer aynen geri döner.

```

--------------------------------

### Abonelik Başlatma İsteği (POST /v2/subscription/initialize/with-customer)

Source: https://docs.iyzico.com/urunler/abonelik/abonelik-entegrasyonu/abonelik-islemleri

Mevcut bir müşteri için yeni bir abonelik başlatır. Müşterinin aktif bir aboneliği olmalıdır; aksi halde başlatma yapılmaz. subscriptionInitialStatus alanı PENDING gönderilirse abonelik başlamaz ve ayrıca aktifleştirilmesi gerekir.

```HTTP
POST https://api.iyzipay.com/v2/subscription/initialize/with-customer
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "subscriptionInitialStatus": "ACTIVE",
  "pricingPlanReferenceCode": "7515f763-5da3-4a35-8f7f-d425ae44ac04",
  "customerReferenceCode": "279bb493-6fda-45e9-9368-2373ea43ff8d"
}
```

--------------------------------

### 200 Success Response for Query Transaction Status

Source: https://docs.iyzico.com/urunler/fiziki-pos/terminal-api-entegrasyonu/vuk-509-servisleri/odeme-ve-islem-servisleri

Example success response with status SUCCESS and detailed transaction fields including paymentId, authCode, price, installment, currency, and bank references.

```json
{
  "conversationId": "conversation2",
  "locale": "tr",
  "deviceUniqueId": "PAV860047264",
  "transactionReferenceId": "TXN-20260101-000001",
  "status": "SUCCESS",
  "errorCode": "",
  "errorMessage": "",
  "errorGroup": "",
  "systemTime": 1768221700000,
  "transactionDateTime": "2026-01-01T10:23:45+03:00",
  "authCode": "552238",
  "paymentId": "28251001",
  "paymentDate": "20260101",
  "price": 100,
  "installment": 1,
  "currency": "TRY",
  "binNumber": "552879",
  "lastFourDigits": "0008",
  "hostReference": "HSTREF0000000001",
  "cardType": "CREDIT_CARD",
  "acquirerId": "0010",
  "issuerId": "0046",
  "bankMerchantId": "800000001",
  "bankTerminalId": "T0000001",
  "batchNo": "001",
  "stanNo": "000001",
  "posEntryModeCode": "051"
}
```

--------------------------------

### POST /v2/subscription/initialize

Source: https://docs.iyzico.com/urunler/abonelik/abonelik-entegrasyonu/abonelik-islemleri

Hazır ödeme formu olmadan, kendi ödeme formunuz ile NON3D servisi üzerinden abonelik başlatır. Gerekli başlık parametreleri Authorization ve Content-Type'dir. İstek gövdesinde plan referans kodu, müşteri bilgileri ve kart bilgileri gönderilir.

```APIDOC
## [POST] /v2/subscription/initialize

### Description
Hazır ödeme formu olmadan, Tarafınıza ait ödeme formu ile NON3D servisi üzerinden abonelik başlatır.

### Method
POST

### Endpoint
https://api.iyzipay.com/v2/subscription/initialize

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
- **Content-Type** (string) - Required - İstek içeriğinin formatı. Örnek: `application/json`

#### Request Body
- **pricingPlanReferenceCode** (string) - Required - Aboneliğin başlatılacağı planın referans kodu. Örnek: `7515f763-5da3-4a35-8f7f-d425ae44ac04`
- **conversationId** (string) - Optional - İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir. Örnek: `123456789`
- **subscriptionInitialStatus** (string enum) - Required - Abonelik başlangıç durumu. PENDING gönderilirse abonelik başlamaz ve tekrar aktif edilmesi gerekir. Örnek: `ACTIVE` Olası değerler: `ACTIVE`, `PENDING`
- **customer** (object SubscriptionCustomer) - Required - Alıcı Bilgileri
- **paymentCard** (object PaymentCard) - Required - Kart bilgileri.

### Request Example
```
POST https://api.iyzipay.com/v2/subscription/initialize
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "locale": "tr",
  "pricingPlanReferenceCode": "7515f763-5da3-4a35-8f7f-d425ae44ac04",
  "conversationId": "conv-1001",
  "subscriptionInitialStatus": "ACTIVE",
  "customer": {
    "name": "John",
    "surname": "Stone",
    "email": "john@gmail.com",
    "gsmNumber": "+905545545512",
    "identityNumber": "1234567890",
    "billingAddress": {
      "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
      "contactName": "contactName",
      "city": "Istanbul",
      "country": "Türkiye"
    },
    "shippingAddress": {
      "address": "address",
      "zipCode": "zipCode",
      "contactName": "contactName",
      "city": "city",
      "country": "country"
    }
  },
  "paymentCard": {
    "cardHolderName": "John Doe",
    "cardNumber": "5528790000000008",
    "expireMonth": "12",
    "expireYear": "2030",
    "cvc": "123"
  }
}
```

### Response
#### Success Response (200)
- **status** (string enum) - Optional - Yapılan isteğin sonucunu belirtir. İşlem başarılı ise success değeri döner. Olası değerler: `success`, `failure`
- **systemTime** (integer) - Optional - Dönen sonucun o anki unix timestamp değeridir.
- **data** (object) - Optional - Abonelik verileri.

#### Response Example
```
{
  "status": "success",
  "systemTime": 1755598000000,
  "data": {
    "referenceCode": "8d06cc19-98fb-47a6-ae1f-47f20c4797b4",
    "parentReferenceCode": "535094d2-9257-401b-8e38-f08308e37098",
    "pricingPlanReferenceCode": "515f763-5da3-4a35-8f7f-d425ae44ac04",
    "customerReferenceCode": "775ba402-41f0-4674-968b-43cc787d9366",
    "subscriptionStatus": "ACTIVE",
    "trialDays": 5,
    "trialStartDate": 1755599766595,
    "trialEndDate": 1756031766595,
    "createdDate": 1755599766595,
    "startDate": 1755599766595,
    "endDate": 1787567766595
  }
}
```

#### Error Response (400)
Başarısız yanıt döner.

```

--------------------------------

### Complete Payment HTTP Request

Source: https://docs.iyzico.com/urunler/fiziki-pos/terminal-api-entegrasyonu/vuk-509-servisleri/odeme-ve-islem-servisleri

Example HTTP request to the /v2/terminal-host/payment endpoint. Requires a Bearer token for authorization. The body includes required fields such as conversationId, locale, deviceUniqueId, transactionReferenceId, price, currency, installment, and saleType.

```http
POST /v2/terminal-host/payment HTTP/1.1
Host: api.iyzipay.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 200

{
  "conversationId": "conversation1",
  "locale": "TR",
  "deviceUniqueId": "PAV860047264",
  "transactionReferenceId": "string16",
  "price": 100,
  "currency": "TRY",
  "installment": "0,",
  "saleType": "SALE,",
  "paymentId": null
}
```

--------------------------------

### Get Token with Auth Code - 200 Success Response

Source: https://docs.iyzico.com/urunler/fiziki-pos/terminal-api-entegrasyonu/login-islemleri

Example success response containing access_token, refresh_token, scope, token_type, and expires_in. The access_token is used as a Bearer Token for Terminal Host services, and refresh_token is stored for token renewal.

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

--------------------------------

### POST /v3/in-store/payment/init

Source: https://docs.iyzico.com/urunler/ceppos-app2app/in-store-api-v3

Starts the payment process. Returns a deepLinkUrl to redirect the customer to the iyzico app and a paymentSessionToken for later decryption.

```APIDOC
## POST /v3/in-store/payment/init

### Description
Starts the payment process for a customer. On success, the response contains a `deepLinkUrl` to redirect the customer to the iyzico app and a `paymentSessionToken` for later decryption.

### Method
POST

### Endpoint
https://sandbox-api.iyzipay.com/v3/in-store/payment/init

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Header Parameters
- **x-callback-url** (string, uri) - Required - Callback URL for payment result notification. Example: `https://yoursite.com/callback`

#### Request Body
- **userId** (string) - Required - The ID of the user making the payment. Example: `usr_12345`
- **orderId** (string) - Required - Order reference number. Example: `ord_98765`
- **amount** (BigDecimal) - Required - Payment amount. Example: `150.00`

### Request Example
```json
{
  "userId": "usr_12345",
  "orderId": "ord_98765",
  "amount": "150.00"
}
```

### Response
#### Success Response (200)
Payment successfully initiated.

Response body fields:
- **status** (string) - Optional - Indicates the result. Returns "success" on success. Example: `success`
- **errorCode** (string, nullable) - Optional - Error code if an error occurred, otherwise null.
- **errorMessage** (string, nullable) - Optional - Error message if an error occurred, otherwise null.
- **deepLinkUrl** (string) - Optional - Deep link URL to redirect the customer to the iyzico app. Example: `iyzico://payment?token=abc123`
- **paymentSessionToken** (string) - Optional - Token specific to the payment session. Used for decryption in the /crypt/decrypt step. Example: `abc123xyz`
- **paymentId** (integer, int64) - Optional - Unique payment ID assigned by iyzico. Used as reference for refunds and queries. Example: `1000001`

Example:
```json
{
  "status": "success",
  "errorCode": null,
  "errorMessage": null,
  "deepLinkUrl": "iyzico://payment?token=abc123",
  "paymentSessionToken": "abc123xyz",
  "paymentId": 1000001
}
```

### Error Responses
#### 422 Unprocessable Entity
Validation error - missing or invalid field.

#### 500 Internal Server Error
Server error.

### Authentication
Requires the following headers:
- **x-api-key** (string) - Required
- **x-merchant-id** (string) - Required
- **x-secret-key** (string) - Required

### Request Example (HTTP)
```http
POST /v3/in-store/payment/init HTTP/1.1
Host: sandbox-api.iyzipay.com
x-api-key: YOUR_API_KEY
x-merchant-id: YOUR_API_KEY
x-secret-key: YOUR_API_KEY
x-callback-url: https://yoursite.com/callback
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "userId": "usr_12345",
  "orderId": "ord_98765",
  "amount": "150.00"
}
```
```

--------------------------------

### Taksit Sorgulama API İsteği

Source: https://docs.iyzico.com/ek-servisler/taksit-ve-bin-sorgulama

Sends a POST request to the installment query endpoint. The Authorization header uses a base64-encoded signed hash starting with IYZWSv2. The body includes locale, price, BIN number (8 digits) and an optional conversation ID.

```http
POST https://sandbox-api.iyzipay.com/payment/iyzipos/installment
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtcU43VzljOXI3aWhZZUs5Z2ZqbFhRWFlPUUZteEQyNkEmcmFuZG9tS2V5OjE3NTY0NjkyMjgyMzQxMjM0NTY3ODkmc2lnbmF0dXJlOmRmMzEwNjI2MTI0OGNhZTcxMDJlZDQxMjhjODA4MmIwOTlhMzU4OWNmZDc3MTNkODNlODk5YWEzMDg0NDBkZDg=
Content-Type: application/json

{
  "locale": "tr",
  "price": 100.0,
  "binNumber": "54308100",
  "conversationId": "123456789"
}
```

--------------------------------

### Pazaryeri Onboarding Hata Kodları

Source: https://docs.iyzico.com/ek-bilgiler/hata-kodlari

Pazaryeri onboarding sürecinde alt üye işyeri oluşturma ve güncelleme sırasında karşılaşılabilecek hata kodları ve açıklamaları.

```APIDOC
## Pazaryeri Onboarding Hata Kodları

### Description
Pazaryeri onboarding sürecinde alt üye işyeri oluşturma ve güncelleme sırasında karşılaşılabilecek hata kodları ve açıklamaları.

### Hata Kodları

| Kod | Hata Mesajı | Retry | Açıklama |
|-----|-------------|-------|----------|
| 2000 | Bu servis sadece pazaryeri müşterilerine açıktır | true | Pazaryeri olmayan bir hesapta pazaryeri servislerine istek atıldığında bu hata alınmaktadır |
| 2001 | Alt üye işyeri bulunamadı | true | İstekte set edilen submerchantExternalId değerini kontrol edilmelidir. submerchantExternalId değeri, hesaptaki altüyelerden birine ait değilse bu hata mesajı dönmektedir. |
| 2002 | Alt üye işyeri bulunmaktadır | true | Daha önce aynı externalId değeri ile farklı bir altüye oluşturulduysa, hata alınabilir. externalId değeri değiştirilip tekrar denenebilir. |
| 2003 | subMerchantKey gönderilmesi zorunludur | true | İstekte set edilen subMerchantKey değeri kontrol edilmelidir. subMerchantKey değeri gönderilmediğinde bu hata alınmaktadır. |
| 2004 | subMerchantType gönderilmesi zorunludur | true | İstekte set edilen subMerchantType değeri kontrol edilmelidir. subMerchantType değeri gönderilmediğinde bu hata alınmaktadır. |
| 2005 | Iban gönderilmesi zorunludur | true | Update submerchant servisinde IBAN parametresi requeste eklenmediğinde bu hata dönmektedir. |
| 2007 | subMerchantExternalId gönderilmesi zorunludur | true | Pazaryerinde altüye oluştururken subMerchantExternalId gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz. |
| 2008 | subMerchantExternalId en fazla 255 karakter olmalıdır | true | subMerchantExternalId parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2009 | address gönderilmesi zorunludur | true | Pazaryerinde altüye oluştururken address gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz. |
| 2010 | address en fazla 255 karakter olmalıdır | true | address parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2011 | address en az 5 karakter olmalıdır | true | address parametresini 5 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2012 | contactName gönderilmesi zorunludur | true | Pazaryerinde altüye oluştururken contactName gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz. |
| 2013 | contactName en fazla 100 karakter olmalıdır | true | contactName parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2014 | contactName en az 2 karakter olmalıdır | true | contactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2015 | contactSurname gönderilmesi zorunludur | true | Pazaryerinde altüye oluştururken contactSurname gönderilmesi zorunlu bir parametredir. Bu değeri göndererek tekrar deneyebilirsiniz. |
| 2016 | contactSurname en fazla 100 karakter olmalıdır | true | contactSurname parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2017 | contactSurname en az 2 karakter olmalıdır | true | contactName parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2018 | taxOffice gönderilmesi zorunludur | true | Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxOffice gönderilmesi zorunlu bir parametredir. |
| 2019 | taxOffice en fazla 255 karakter olmalıdır | true | taxOffice parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2020 | taxOffice en az 3 karakter olmalıdır | true | taxOffice parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2021 | legalCompanyTitle gönderilmesi zorunludur | true | Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, legalCompanyTitle gönderilmesi zorunlu bir parametredir. |
| 2022 | legalCompanyTitle en fazla 255 karakter olmalıdır | true | legalCompanyTitle parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2023 | legalCompanyTitle en az 3 karakter olmalıdır | true | legalCompanyTitle parametresini 3 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2024 | taxNumber gönderilmesi zorunludur | true | Şahıs veya Kurumsal Şirket olarak oluşturulan alt üye işyerlerinde, taxNumber gönderilmesi zorunlu bir parametredir. |
| 2025 | taxNumber en fazla 100 karakter olmalıdır | true | taxNumber parametresini 100 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2026 | taxNumber en az 2 karakter olmalıdır | true | taxNumber parametresini 2 karakterden fazla bir değer göndererek tekrar deneyebilirsiniz. |
| 2028 | name en fazla 255 karakter olmalıdır | true | name parametresini 255 karakterden az bir değer göndererek tekrar deneyebilirsiniz. |
| 2029 | gsmNumber en fazla 25 karakter olmalıdır | true | gsmNumber parametresini 25 karakterden daha az bir değer göndererek tekrar deneyebilirsiniz. |
| 2030 | Gönderilen iban hatalı formattadır | true | Gönderilen IBAN değeri, 26 karakterli gerçek bir IBAN formatında olmalıdır. |
```

--------------------------------

### BIN Sorgulama - HTTP Request

Source: https://docs.iyzico.com/ek-servisler/taksit-ve-bin-sorgulama

This is a BIN check API request example. The request must include the Authorization header (starting with IYZWSv2) and Content-Type application/json. The binNumber parameter is required and must be 8 digits. The response includes card details such as cardType, cardAssociation, cardFamily, bankName, and bankCode.

```http
POST https://sandbox-api.iyzipay.com/payment/bin/check
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtNE9hdVQwRXNSUjk3bmlqZVBRTWxGMTNrVHA2Rk9lNjkmcmFuZG9tS2V5OjEyMzQ1Njc4OSZzaWduYXR1cmU6MTZmMmEwZTJiZjU4ZmZkZTcwZWMxZWIzZGU5Y2IwNTRkMjk4Zjc1NThlNmRiMmQwYTQ2NjA4NzJmYzY0NGFjNg==
Content-Type: application/json

{
  "locale": "tr",
  "binNumber": "41579200",
  "conversationId": "1a2b3c4d5e6f"
}
```

--------------------------------

### POST /v3/in-store/payment/init - Initiate Payment Request

Source: https://docs.iyzico.com/urunler/ceppos-app2app/in-store-api-v3

Starts a payment process. Requires x-callback-url header and body with userId, orderId, and amount. Returns deepLinkUrl and paymentSessionToken.

```HTTP
POST /v3/in-store/payment/init HTTP/1.1
Host: sandbox-api.iyzipay.com
x-api-key: YOUR_API_KEY
x-merchant-id: YOUR_API_KEY
x-secret-key: YOUR_API_KEY
x-callback-url: https://yoursite.com/callback
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "userId": "usr_12345",
  "orderId": "ord_98765",
  "amount": "150.00"
}
```

--------------------------------

### Ödeme İşlemini Tamamlama

Source: https://docs.iyzico.com/urunler/mass-payout/mass-payout-toplu-odeme-entegrasyonu

Completes a previously started mass payout by providing the request ID returned from the start operation.

```APIDOC
## Ödeme İşlemini Tamamlama

### Description
Completes a previously started mass payout by providing the request ID returned from the start operation.

### Request Example
```json
{
    "requestId" : "79cdefc1-3ce6-4f51-bdd9-0c050274db64"
}
```

### Response Example
```json
{
    "status": "success",
    "systemTime": 1759231995145
}
```

```

--------------------------------

### POST /v2/subscription/initialize/with-customer

Source: https://docs.iyzico.com/urunler/abonelik/abonelik-entegrasyonu/abonelik-islemleri

Starts a new subscription for an existing customer using their customer reference code. The customer must have an active subscription.

```APIDOC
## POST /v2/subscription/initialize/with-customer

### Description
Starts a new subscription for an existing customer using their customer reference code. The customer must have an active subscription.

### Method
POST

### Endpoint
https://api.iyzipay.com/v2/subscription/initialize/with-customer

### Parameters
#### Header Parameters
- **Authorization** (string) - Required - Authorization header, starts with IYZWSv2 and is a base64-encoded signed hash.
- **Content-Type** (string) - Required - Format of the request content. Example: `application/json`

#### Request Body
- **subscriptionInitialStatus** (string enum) - Required - Initial status of the subscription. If PENDING is sent, the subscription does not start and must be activated later. Possible values: `ACTIVE`, `PENDING`. Example: `ACTIVE`
- **pricingPlanReferenceCode** (string) - Required - Reference code of the plan to start the subscription. Example: `7515f763-5da3-4a35-8f7f-d425ae44ac04`
- **customerReferenceCode** (string) - Required - Reference code of the existing customer. Must have an active subscription. Example: `279bb493-6fda-45e9-9368-2373ea43ff8d`

### Request Example
```
POST https://api.iyzipay.com/v2/subscription/initialize/with-customer
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "subscriptionInitialStatus": "ACTIVE",
  "pricingPlanReferenceCode": "7515f763-5da3-4a35-8f7f-d425ae44ac04",
  "customerReferenceCode": "279bb493-6fda-45e9-9368-2373ea43ff8d"
}
```

### Response
#### Success Response (200)
- **status** (string enum) - Optional - Result of the operation. Possible values: `success`, `failure`
- **systemTime** (integer) - Optional - Operation time (epoch ms).
- **data** (object) - Optional - Contains subscription details.

#### Response Example
```
{
  "status": "success",
  "systemTime": 1755606762264,
  "data": {
    "referenceCode": "009dac1a-00dc-41e8-a92f-2c24b18e27b9",
    "parentReferenceCode": "f4bb665b-a48a-4100-917f-d7a46b16e586",
    "pricingPlanReferenceCode": "7515f763-5da3-4a35-8f7f-d425ae44ac04",
    "customerReferenceCode": "279bb493-6fda-45e9-9368-2373ea43ff8d",
    "subscriptionStatus": "ACTIVE",
    "trialDays": 5,
    "trialStartDate": 1755606762238,
    "trialEndDate": 1756038762238,
    "createdDate": 1755606762238,
    "startDate": 1755606762238,
    "endDate": 1787574762238
  }
}
```

#### Error Response (400)
- **status** (string enum) - Optional - Result of the operation. Possible values: `success`, `failure`
- **systemTime** (integer) - Optional - Operation time (epoch ms).
- **data** (object) - Optional - Error details.
```
Tokens:
Raw