---
title: "Initialize 3DS Payment"
method: POST
path: "/payment/3dsecure/initialize"
tags: ["3DS Payment"]
---

# Initialize 3DS Payment

`POST /payment/3dsecure/initialize`

3D Secure oturumu başlatır ve 3DS doğrulama için htmlContent değeri döner.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- ThreeDSInitializeRequest
  - `locale` 'tr' | 'en' — Dil kodu. Varsayılan; tr
  - `conversationId` string — İstek/yanıt eşleştirme ID’si.
  - `price` unknown, required
  - `paidPrice` unknown, required
  - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'NOK' | 'CHF' — Para birimi. Varsayılan; TRY.
  - `installment` 1 | 2 | 3 | 4 | 6 | 9 | 12 — Taksit sayısı (gönderilmezse tek çekim olarak işlem gerçekleşir).
  - `paymentChannel` 'WEB' | 'MOBILE' | 'MOBILE_WEB' | 'MOBILE_IOS' | 'MOBILE_ANDROID' | 'MOBILE_WINDOWS' | 'MOBILE_TABLET' | 'MOBILE_PHONE' — Ödeme kanalı.
  - `basketId` string — Sepet ID.
  - `paymentGroup` 'PRODUCT' | 'LISTING' | 'SUBSCRIPTION' — Ödeme grubu. Varsayılan; PRODUCT.
  - `callbackUrl` string, required — 3DS işlem sonrası yönlenecek dönüş URL’si.
  - `paymentCard` PaymentCard3DS, required
    - `cardHolderName` string, required — Kart sahibi adı soyadı.
    - `cardNumber` string, required — Kart numarası (PAN).
    - `expireYear` string, required — Son kullanma yılı (YY ya da YYYY).
    - `expireMonth` string, required — Son kullanma ayı (MM).
    - `cvc` string, required — Kart güvenlik kodu.
    - `registerCard` integer — Kart kaydedilsin mi? (0 = hayır, 1 = evet)
  - `buyer` Buyer3DS, required
    - `id` string, required — Müşteri ID’si.
    - `name` string, required — Ad.
    - `surname` string, required — Soyad.
    - `identityNumber` string, required — Kimlik numarası.
    - `email` string, required — E-posta.
    - `gsmNumber` string, required — Cep telefonu.
    - `registrationDate` string — Kayıt tarihi (YYYY-MM-DD hh:mm:ss).
    - `lastLoginDate` string — Son giriş tarihi (YYYY-MM-DD hh:mm:ss).
    - `registrationAddress` string, required — Kayıtlı adres.
    - `city` string, required — Şehir kodu/adı.
    - `country` string, required — Ülke.
    - `zipCode` string — Posta kodu.
    - `ip` string — IP adresi.
  - `shippingAddress` Address, required
    - `address` string, required — Tam adres.
    - `zipCode` string — Posta kodu.
    - `contactName` string, required — İletişim adı.
    - `city` string, required — Şehir.
    - `country` string, required — Ülke.
  - `billingAddress` Address, required
    - `address` string, required — Tam adres.
    - `zipCode` string — Posta kodu.
    - `contactName` string, required — İletişim adı.
    - `city` string, required — Şehir.
    - `country` string, required — Ülke.
  - `basketItems` BasketItem[], required — Sepetteki ürünler.
    - `id` string, required — Ürün ID.
    - `price` unknown, required
    - `name` string, required — Ürün adı.
    - `category1` string, required — Ana kategori.
    - `category2` string — Alt kategori (opsiyonel).
    - `itemType` 'PHYSICAL' | 'VIRTUAL', required — Ürün tipi.
    - `subMerchantKey` string — Hizmeti veren alt üye işyerine ait, alt üye işyeri anahtarı bilgisi. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir.
    - `subMerchantPrice` string — Alt üye işyerine aktarılacak tutar. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir.
  - `paymentSource` string — Bu alan, partner firmalar tarafından iletilen ödeme kaynağı bilgisidir. Eğer bir altyapı sağlayıcısıysanız ve iyzico ile entegrasyon/iş birliğiniz bulunuyorsa bu parametreyi gönderebilirsiniz.

## Response `200`

Başarılı yanıt (3DS başlatıldı)

- ThreeDSInitializeResponse
  - `status` 'success' | 'failure' — Yapılan isteğin sonucunu bildirir.
  - `locale` string — Yanıt dili (tr/en).
  - `systemTime` integer — İşlem zamanı (epoch ms).
  - `conversationId` string — İstek ile eşleşen ID.
  - `threeDSHtmlContent` string — 3DS doğrulama ekranının Base64 kodlu HTML içeriği.
  - `paymentId` string — iyzico tarafından dönen uniq paymentId bilgisi.
  - `signature` string — İmza doğrulaması için kullanılabilecek signature değeri.

## Other responses

- `400` — Hatalı istek / doğrulama hatası

---

[API](https://skmtc.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)