# 3DS Tamamlama xiyzico'da kayıtlı bir işlemin detayına ulaşmak için ödeme sorgulama hizmetini kullanabilirsiniz. Servise gönderilmesi gereken parametreler aşağıdaki gibidir: ## Create 3DS Payment > 3DS doğrulaması sonrasında, ödeme işleminin sonlandırılması için bu endpoint’e istek yapılmalıdır. Bu servis, doğrulama adımından sonra alınan bilgilerle çalıştırılır ve işlemi başarılı ya da başarısız olarak sonuçlandırır. ```json {"openapi":"3.0.3","info":{"title":"3DS Payments","version":"1.0.3"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/3dsecure/auth":{"post":{"summary":"Create 3DS Payment","description":"3DS doğrulaması sonrasında, ödeme işleminin sonlandırılması için bu endpoint’e istek yapılmalıdır. Bu servis, doğrulama adımından sonra alınan bilgilerle çalıştırılır ve işlemi başarılı ya da başarısız olarak sonuçlandırır.","tags":["3DS Payment"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSAuthRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt (ödeme tamamlandı)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentResponse"}}}},"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":{"ThreeDSAuthRequest":{"type":"object","required":["paymentId"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan; tr","enum":["tr","en"]},"paymentId":{"type":"string","description":"Initialize çağrısından dönen ödeme ID’si."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si."},"conversationData":{"type":"string","description":"3DS sonucunda post edilen data. Dolu dönerse gönderilmesi zorunludur."}}},"PaymentResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan işleminin sonucunu bildirir. success dönmesi taktirinde ödeme işlemi başarılı anlamına gelir.","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."},"price":{"type":"decimal","description":"Sepet toplam tutarı."},"paidPrice":{"type":"decimal","description":"Tahsil edilen toplam tutar."},"installment":{"type":"integer","description":"Taksit sayısı."},"paymentId":{"type":"string","description":"Ödeme ID’si."},"fraudStatus":{"type":"integer","description":"Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.\n - 1: Onaylandı\n - 0: İncelemede\n - -1: Reddedildi\n","enum":[0,-1,1]},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır."},"iyziCommissionRateAmount":{"type":"decimal","description":"Ödemeye ait iyzico işlem komisyon tutarı."},"iyziCommissionFee":{"type":"decimal","description":"Ödemeye ait iyzico işlem ücreti."},"cardType":{"type":"string","description":"Kart tipi."},"cardAssociation":{"type":"string","description":"Kart markası.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS","TROY"]},"cardFamily":{"type":"string","description":"Kart ailesi/ürünü."},"binNumber":{"type":"string","description":"BIN (ilk 8 hane)."},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi."},"basketId":{"type":"string","description":"Sepet ID."},"currency":{"type":"string","description":"Para birimi."},"itemTransactions":{"type":"array","description":"Sepet öğelerine ait işlem kalemleri.","items":{"type":"object","properties":{"paymentTransactionId":{"type":"string","description":"Ödeme kırılımına ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödeme kırılımının iadesi, onayı, onay geri çekmesi ve iyzico ile iletişimde kullanılır. Tercihen itemId ile ilişkili bir şekilde tutulmalıdır."},"itemId":{"type":"string","description":"Üye işyeri tarafından iletilen, sepetteki ürüne ait id."},"price":{"type":"decimal","description":"Üye işyeri tarafındaki sepetteki ürüne ait tutar."},"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"transactionStatus":{"type":"integer","description":"Ödeme kırılımının durumu.\n- 0: Fraud kontrolünde\n- -1: Fraud kontrolünden sonra reddedildi\n- 1: Onaylandı. (Pazaryerinde 1 değeri Üye İşyeri Onayı Bekliyor Anlamına Gelir)\n- 2: Onaylandı (Pazaryeri Onay Verilmiş)\n","enum":[0,-1,1,2]},"blockageRate":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj oranı. iyzico – üye işyeri anlaşmasına göre, üye işyerine işlem bazında blokaj uygulayabilir. Bu blokaj üye işyeri fraud riskini önlemek içindir, blokaj süresi boyunca para iyzico’da tutulur, bu süre sonrasında üye işyerine gönderilir."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"blockageResolvedDate":{"type":"string","description":"İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örn. 2015-10-19 14:36:52."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranının kırılım bazında dağılmış oranı."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarıın, kırılım bazında dağılmış tutarı."},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"convertedPayout":{"type":"object","description":"Kırılım bazında, kur çevrimi sonrası hesaplamalar.","properties":{"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"iyziConversationRate":{"type":"decimal","description":"Kur oranı."},"iyziConversationRateAmount":{"type":"decimal","description":"Kur oranı sonucu tutar."}}}}},"currency":{"type":"string","description":"Ödemenin alındığı para birimi."}},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"phase":{"type":"string","description":"Ödeme Fazı."},"mdStatus":{"type":"integer","description":"3DS doğrulama sonucu (1 ise başarılı).","enum":[-1,0,1,2,3,4,5,6,7,8]},"hostReference":{"type":"string","description":"Ödemeye ilişkin banka tarafından verilen hostReference değeri."},"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
Postman
## 3DS Tamamlama v2 - Geliştirilmiş Ödeme Güvenliği iyzico'da, yakın zamanda gerçekleştirilen HMACSHA256 güncellemesinin ardından, mevcut `payment/v2/3dsecure/auth` endpoint’ine ek olarak `payment/3dsecure/auth` endpoint'ini devreye aldık. Bu endpoint, kayıtlı 3D ödemelerini tamamlamak ve müşterinin kartından çekilen nihai tutar, ilgili ödemenin conversationId ve paymentId bilgilerini içeren detayları elde etmek için kullanılır. Bununla birlikte, ilgili ödemenin tamamlanması için daha güvenilir doğrulama teknikleri kullanılabilir. [İmza Yanıtının Doğrulanması](/ek-servisler/imza-yanitinin-dogrulanmasi.md)'nda belirtildiği gibi, ödeme isteği sonucunda döndürülen ve istek tablosunda listelenen değişkenler bu süreçte önemli bir rol oynar. [İmza Yanıtının Doğrulanması](/ek-servisler/imza-yanitinin-dogrulanmasi.md)'nda gösterildiği gibi, şifrelenmiş payload için her iki tarafta imza üretildiğinde ve bu imzalar eşit olduğunda, ilgili ödeme başarıyla tamamlanır. ## Create 3DS v2 Payment > Doğrulama sonrası ödeme sonucunun alınması için hem v1 hem de yeni nesil v2 endpoint’i kullanılabilir. Daha güncel teknolojilere uyum sağlamak adına v2 endpoint’inin kullanılmasını öneririz. ```json {"openapi":"3.0.3","info":{"title":"3DS v2 Payments","version":"1.0.1"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/v2/3dsecure/auth":{"post":{"summary":"Create 3DS v2 Payment","description":"Doğrulama sonrası ödeme sonucunun alınması için hem v1 hem de yeni nesil v2 endpoint’i kullanılabilir. Daha güncel teknolojilere uyum sağlamak adına v2 endpoint’inin kullanılmasını öneririz.","tags":["3DS Payment"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSV2AuthRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt (ödeme tamamlandı)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDSV2PaymentResponse"}}}},"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":{"ThreeDSV2AuthRequest":{"type":"object","required":["paymentId","paidPrice","basketId","currency"],"properties":{"locale":{"type":"string","enum":["tr","en"],"description":"Dil kodu. Varsayılan; tr"},"paymentId":{"type":"string","description":"3DS başlatma sonrasında dönen ödeme ID’si."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si."},"paidPrice":{"type":"decimal","description":"3DS v2 tamamlamada kullanılacak tahsilat tutarı. INIT 3DS aşamasında gönderilen paidPrice değeri ile uyumlu olmalı."},"basketId":{"type":"string","description":"Sepet ID’si (INIT 3DS basketId ile eşleşmelidir)."},"currency":{"type":"string","enum":["TRY","USD","EUR","GBP","NOK","CHF"],"description":"Para birimi. Varsayılan; TRY (INIT 3DS'de gönderilen değer ile eşleşmelidir.)"}}},"ThreeDSV2PaymentResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir. success dönmesi taktirinde, ödeme işlemi başarılı olduğu anlamına gelir.","enum":["success","failure"]},"locale":{"type":"string","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Zaman damgası (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."},"price":{"type":"decimal","description":"Sepet toplam tutarı."},"paidPrice":{"type":"decimal","description":"Tahsil edilen toplam tutar."},"installment":{"type":"integer","description":"Taksit sayısı."},"paymentId":{"type":"string","description":"Ödeme ID’si."},"fraudStatus":{"type":"integer","description":"Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.\n- 1: Onaylandı\n- 0: İncelemede\n- -1: Reddedildi\n","enum":[0,-1,1]},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır."},"iyziCommissionRateAmount":{"type":"decimal","description":"Ödemeye ait iyzico işlem komisyon tutarı."},"iyziCommissionFee":{"type":"decimal","description":"Ödemeye ait iyzico işlem ücreti."},"cardType":{"type":"string","description":"Kart tipi."},"cardAssociation":{"type":"string","description":"Kart kuruluşu.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS","TROY"]},"cardFamily":{"type":"string","description":"Kart ailesi/ürünü."},"binNumber":{"type":"string","description":"BIN (ilk 8 hane)."},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi."},"basketId":{"type":"string","description":"Sepet ID."},"currency":{"type":"string","description":"Para birimi."},"itemTransactions":{"type":"array","description":"Sepet öğelerine ait işlem kalemleri.","items":{"type":"object","properties":{"paymentTransactionId":{"type":"string","description":"Ödeme kırılımına ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödeme kırılımının iadesi, onayı, onay geri çekmesi ve iyzico ile iletişimde kullanılır. Tercihen itemId ile ilişkili bir şekilde tutulmalıdır."},"itemId":{"type":"string","description":"Üye işyeri tarafından iletilen, sepetteki ürüne ait id."},"price":{"type":"decimal","description":"Üye işyeri tarafındaki sepetteki ürüne ait tutar."},"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"transactionStatus":{"type":"integer","description":"Ödeme kırılımının durumu.\n- 0: Fraud kontrolünde\n- -1: Fraud kontrolünden sonra reddedildi\n- 1: Onaylandı. (Pazaryerinde 1 değeri Üye İşyeri Onayı Bekliyor Anlamına Gelir)\n- 2: Onaylandı (Pazaryeri Onay Verilmiş)\n","enum":[0,-1,1,2]},"blockageRate":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj oranı. iyzico – üye işyeri anlaşmasına göre, üye işyerine işlem bazında blokaj uygulayabilir. Bu blokaj üye işyeri fraud riskini önlemek içindir, blokaj süresi boyunca para iyzico’da tutulur, bu süre sonrasında üye işyerine gönderilir."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"blockageResolvedDate":{"type":"string","description":"İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örn. 2015-10-19 14:36:52."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranının kırılım bazında dağılmış oranı."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarıın, kırılım bazında dağılmış tutarı."},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"convertedPayout":{"type":"object","description":"Kırılım bazında, kur çevrimi sonrası hesaplamalar.","properties":{"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"iyziConversationRate":{"type":"decimal","description":"Kur oranı."},"iyziConversationRateAmount":{"type":"decimal","description":"Kur oranı sonucu tutar."}}}}},"currency":{"type":"string","description":"Ödemenin alındığı para birimi."}},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"phase":{"type":"string","description":"Ödeme Fazı."},"mdStatus":{"type":"integer","description":"3DS doğrulama sonucu.\n- 1: Başarılı\n- 0,2-8: Başarısız\n","enum":[-1,0,1,2,3,4,5,6,7,8]},"hostReference":{"type":"string","description":"Ödemeye ilişkin banka tarafından verilen hostReference değeri."},"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","enum":["tr","en"],"description":"Yanıt dili."},"systemTime":{"type":"integer","description":"Zaman damgası (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}}}}} ``` #### Örnek Kodlar
Java
Json
## Auth 3DS vs Auth v2 3DS Daha önce geliştirilmiş olan `payment/3dsecure/auth` endpoint’i, standart 3D Secure 1.0 protokolünü kullanır ve daha basit bir yapı sunarak eski sistemlerin entegrasyonunu kolaylaştırır. Buna karşılık, `payment/v2/3dsecure/auth` endpointendpoint’i, daha gelişmiş 3D Secure 2.0 protokolü üzerine inşa edilmiştir. Bu yeni protokol, risk analizi için daha zengin veri noktaları sunarak güvenliği artırır ve modern sistemlerle daha akıcı bir entegrasyon sağlar. `payment/3dsecure/auth` istemel işlemler için güvenilir bir seçenek olsa da, `payment/v2/3dsecure/auth` daha üstün güvenlik, geliştirilmiş kullanıcı deneyimi ve gelişen ödeme düzenlemeleriyle daha iyi uyumluluk sunar. Bu avantajlar için `payment/v2/3dsecure/auth` geçiş yapmanızı öneririz. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.iyzico.com/odeme-metotlari/api/3ds/3ds-entegrasyonu/3ds-tamamlama.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.