# 3DS Başlatma 3DS Başlatma API’si müşterinin kart ödemelerinin 3DS ile işlenmesinden sorumludur. NON-3DS entegrasyonunda olduğu gibi; * TROY, MASTERCARD, VISA ve AMEX markalı kartlarla yapılan işlemleri destekler. * BONUS, WORLD, MAXIMUM, AXESS, CARDFINANS, PARAF, ADVANTAGE gibi taksit programlarına katılmış olan kartlara 2, 3, 6, 9 ve 12 taksit seçenekleri sunulmaktadır. * Panelde başarılı işlemler yeşil renkte, başarısız işlemler ise kırmızı renkte görüntülenir. * Üye iş yeri, conversationId ve basketId parametrelerini kendi tarafında sipariş numarası olarak kullanabilir. Bu özellikleri birleştirerek müşterilerinize, işlemlerinin başarısı veya başarısızlığı hakkında gerçek zamanlı geri bildirim sağlayarak kusursuz bir ödeme deneyimi sağlayabilirsiniz. ## Initialize 3DS Payment > 3D Secure oturumu başlatır ve 3DS doğrulama için htmlContent değeri döner. ```json {"openapi":"3.0.3","info":{"title":"3DS Payments","version":"1.0.2"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/3dsecure/initialize":{"post":{"summary":"Initialize 3DS Payment","description":"3D Secure oturumu başlatır ve 3DS doğrulama için htmlContent değeri döner.","tags":["3DS Payment"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSInitializeRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt (3DS başlatıldı)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSInitializeResponse"}}}},"400":{"description":"Hatalı istek / doğrulama hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"Content-Type değeri.","schema":{"type":"string"}}},"schemas":{"ThreeDSInitializeRequest":{"type":"object","required":["price","paidPrice","callbackUrl","paymentCard","buyer","shippingAddress","billingAddress","basketItems"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan; tr","enum":["tr","en"]},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si."},"price":{"type":"decimal","description":"Sepet toplamı."},"paidPrice":{"type":"decimal","description":"Tahsil edilecek nihai tutar."},"currency":{"type":"string","description":"Para birimi. Varsayılan; TRY.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"installment":{"type":"integer","description":"Taksit sayısı (gönderilmezse tek çekim olarak işlem gerçekleşir).","enum":[1,2,3,4,6,9,12]},"paymentChannel":{"type":"string","description":"Ödeme kanalı.","enum":["WEB","MOBILE","MOBILE_WEB","MOBILE_IOS","MOBILE_ANDROID","MOBILE_WINDOWS","MOBILE_TABLET","MOBILE_PHONE"]},"basketId":{"type":"string","description":"Sepet ID."},"paymentGroup":{"type":"string","description":"Ödeme grubu. Varsayılan; PRODUCT.","enum":["PRODUCT","LISTING","SUBSCRIPTION"]},"callbackUrl":{"type":"string","description":"3DS işlem sonrası yönlenecek dönüş URL’si."},"paymentCard":{"description":"Kart Bilgileri.","$ref":"#/components/schemas/PaymentCard3DS"},"buyer":{"description":"Alıcı Bilgileri.","$ref":"#/components/schemas/Buyer3DS"},"shippingAddress":{"description":"Kargo Adresi. Sepetteki ürünlerden en az bir tanesinin, itemType \"PHYSICAL\" olması durumunda gönderilmesi zorunludur. Tüm ürünler \"VIRTUAL\" olduğu taktirde gönderilmesi gerekmez.","$ref":"#/components/schemas/Address"},"billingAddress":{"description":"Fatura Adresi.","$ref":"#/components/schemas/Address"},"basketItems":{"type":"array","description":"Sepetteki ürünler.","items":{"$ref":"#/components/schemas/BasketItem"}},"paymentSource":{"type":"string","description":"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."}}},"PaymentCard3DS":{"type":"object","required":["cardHolderName","cardNumber","expireYear","expireMonth","cvc"],"properties":{"cardHolderName":{"type":"string","description":"Kart sahibi adı soyadı."},"cardNumber":{"type":"string","description":"Kart numarası (PAN)."},"expireYear":{"type":"string","description":"Son kullanma yılı (YY ya da YYYY)."},"expireMonth":{"type":"string","description":"Son kullanma ayı (MM)."},"cvc":{"type":"string","description":"Kart güvenlik kodu."},"registerCard":{"type":"integer","description":"Kart kaydedilsin mi? (0 = hayır, 1 = evet)"}}},"Buyer3DS":{"type":"object","required":["id","name","surname","identityNumber","email","gsmNumber","registrationAddress","city","country"],"properties":{"id":{"type":"string","description":"Müşteri ID’si."},"name":{"type":"string","description":"Ad."},"surname":{"type":"string","description":"Soyad."},"identityNumber":{"type":"string","description":"Kimlik numarası."},"email":{"type":"string","description":"E-posta."},"gsmNumber":{"type":"string","description":"Cep telefonu."},"registrationDate":{"type":"string","description":"Kayıt tarihi (YYYY-MM-DD hh:mm:ss)."},"lastLoginDate":{"type":"string","description":"Son giriş tarihi (YYYY-MM-DD hh:mm:ss)."},"registrationAddress":{"type":"string","description":"Kayıtlı adres."},"city":{"type":"string","description":"Şehir kodu/adı."},"country":{"type":"string","description":"Ülke."},"zipCode":{"type":"string","description":"Posta kodu."},"ip":{"type":"string","description":"IP adresi."}}},"Address":{"type":"object","required":["address","contactName","city","country"],"properties":{"address":{"type":"string","description":"Tam adres."},"zipCode":{"type":"string","description":"Posta kodu."},"contactName":{"type":"string","description":"İletişim adı."},"city":{"type":"string","description":"Şehir."},"country":{"type":"string","description":"Ülke."}}},"BasketItem":{"type":"object","required":["id","price","name","category1","itemType"],"properties":{"id":{"type":"string","description":"Ürün ID."},"price":{"type":"decimal","description":"Ürün fiyatı."},"name":{"type":"string","description":"Ürün adı."},"category1":{"type":"string","description":"Ana kategori."},"category2":{"type":"string","description":"Alt kategori (opsiyonel)."},"itemType":{"type":"string","description":"Ürün tipi.","enum":["PHYSICAL","VIRTUAL"]},"subMerchantKey":{"type":"string","description":"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":{"type":"string","description":"Alt üye işyerine aktarılacak tutar. Standart iş modelinde gönderilmez. Sadece pazaryeri iş modelinde gönderilmesi gerekmektedir."}}},"ThreeDSInitializeResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (tr/en)."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."},"threeDSHtmlContent":{"type":"string","description":"3DS doğrulama ekranının Base64 kodlu HTML içeriği."},"paymentId":{"type":"string","description":"iyzico tarafından dönen uniq paymentId bilgisi."},"signature":{"type":"string","description":"İmza doğrulaması için kullanılabilecek signature değeri."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}}}}} ``` #### Örnek Kodlar
PHP
Java
.NET
Node.Js
Python
Son olarak aşağıdaki başlıkları analiz ederek, ödeme sorgusunun sonucunu etkili bir şekilde yönetebilir ve yanıtlayabilirsiniz, böylece müşterileriniz için sorunsuz ve güvenilir bir ödeme süreci sağlayabilirsiniz. * `status` parametresi işlemin durumu hakkında bilgi sağlar. `success`, işlemin başarıyla tamamlandığını ve ödemenin işlendiğini gösterir. `failure`, işlemin başarısız olduğunu belirtir ve başarısızlığın nedenine ilişkin bir hata mesajı verilir. * Bu hizmet için `paymentStatus` parametresi boştur. * `paymentId` ve `paymentTransactionId` değerleri, ileride referans noktası olarak kullanılabileceği için saklanmalıdır. * Başarısız bir işlem durumunda (`failure` durumu), `errorCode`, `errorMessage` ve `errorGroup` parametreleri, hatayla ilgili ayrıntıları sağlayarak ilgili değerlerle birlikte döndürülür.