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

# Create 3DS Payment

`POST /payment/3dsecure/auth`

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.

## Headers

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

## Request body

- ThreeDSAuthRequest
  - `locale` 'tr' | 'en' — Dil kodu. Varsayılan; tr
  - `paymentId` string, required — Initialize çağrısından dönen ödeme ID’si.
  - `conversationId` string — İstek/yanıt eşleştirme ID’si.
  - `conversationData` string — 3DS sonucunda post edilen data. Dolu dönerse gönderilmesi zorunludur.

## Response `200`

Başarılı yanıt (ödeme tamamlandı)

- PaymentResponse
  - `status` 'success' | 'failure' — Yapılan işleminin sonucunu bildirir. success dönmesi taktirinde ödeme işlemi başarılı anlamına gelir.
  - `locale` string — Yanıt dili (tr/en).
  - `systemTime` integer — İşlem zamanı (epoch ms).
  - `conversationId` string — İstek ile eşleşen ID.
  - `price` unknown
  - `paidPrice` unknown
  - `installment` integer — Taksit sayısı.
  - `paymentId` string — Ödeme ID’si.
  - `fraudStatus` 0 | -1 | 1 — 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. - 1: Onaylandı - 0: İncelemede - -1: Reddedildi
  - `merchantCommissionRate` unknown
  - `merchantCommissionRateAmount` unknown
  - `iyziCommissionRateAmount` unknown
  - `iyziCommissionFee` unknown
  - `cardType` string — Kart tipi.
  - `cardAssociation` 'VISA' | 'MASTER_CARD' | 'AMERICAN_EXPRESS' | 'TROY' — Kart markası.
  - `cardFamily` string — Kart ailesi/ürünü.
  - `binNumber` string — BIN (ilk 8 hane).
  - `lastFourDigits` string — Kartın son 4 hanesi.
  - `basketId` string — Sepet ID.
  - `currency` string — Para birimi.
  - `itemTransactions` object[] — Sepet öğelerine ait işlem kalemleri.
    - `paymentTransactionId` string — Ö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` string — Üye işyeri tarafından iletilen, sepetteki ürüne ait id.
    - `price` unknown
    - `paidPrice` unknown
    - `transactionStatus` 0 | -1 | 1 | 2 — Ödeme kırılımının durumu. - 0: Fraud kontrolünde - -1: Fraud kontrolünden sonra reddedildi - 1: Onaylandı. (Pazaryerinde 1 değeri Üye İşyeri Onayı Bekliyor Anlamına Gelir) - 2: Onaylandı (Pazaryeri Onay Verilmiş)
    - `blockageRate` unknown
    - `blockageRateAmountMerchant` unknown
    - `blockageResolvedDate` string — İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örn. 2015-10-19 14:36:52.
    - `iyziCommissionFee` unknown
    - `iyziCommissionRateAmount` unknown
    - `merchantCommissionRate` unknown
    - `merchantCommissionRateAmount` unknown
    - `merchantPayoutAmount` unknown
    - `convertedPayout` object — Kırılım bazında, kur çevrimi sonrası hesaplamalar.
      - `paidPrice` unknown
      - `iyziCommissionFee` unknown
      - `iyziCommissionRateAmount` unknown
      - `blockageRateAmountMerchant` unknown
      - `merchantPayoutAmount` unknown
      - `iyziConversationRate` unknown
      - `iyziConversationRateAmount` unknown
  - `authCode` string — Bankadan dönen authCode değeri.
  - `phase` string — Ödeme Fazı.
  - `mdStatus` -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 — 3DS doğrulama sonucu (1 ise başarılı).
  - `hostReference` string — Ödemeye ilişkin banka tarafından verilen hostReference değeri.
  - `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)