---
title: "Kullanıcı ve Kart Oluşturma"
method: POST
path: "/cardstorage/card"
tags: ["Kart Saklama"]
---

# Kullanıcı ve Kart Oluşturma

`POST /cardstorage/card`

Ödeme oluşturmadan, iyzico'da bir **kullanıcı** ve bu kullanıcıya bağlı bir **kart** kaydı oluşturabilirsiniz. Veya aynı endpoint üzerinden mevcut kullanıcıya **yeni bir kart** ekleyebilirsiniz. Bu noktada, istek parametreleri değişir. Her iki isteğin, request body ve json verilerine ulaşabilirsiniz;

## Headers

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

## Request body

- union
  - CardCreateRequest — Kullanıcı ve kart oluşturma isteği (yeni kullanıcı + ilk kart).
    - `locale` string — iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri `tr`’dir.
    - `conversationId` string — İstek esnasında gönderip, sonuçta alabileceğiniz bir değer; request/response eşleşmesi yapmak için kullanılabilir.
    - `externalId` string — Saklanmak istenen karta üye iş yeri tarafından verilen id.
    - `email` string, required — Saklı kart sahibinin email adresi.
    - `card` Card, required — Kart bilgileri.
      - `cardAlias` string — Saklı karta verilen isim.
      - `expireYear` string, required — Kartın üzerindeki yıl.
      - `expireMonth` string, required — Kartın üzerindeki ay.
      - `cardNumber` string, required — Kartın numarası.
      - `cardHolderName` string, required — Kartın üzerindeki isim.
  - CardCreateWithUserKeyRequest — Mevcut kullanıcıya ikinci/ek kart ekleme isteği.
    - `locale` string — iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri `tr`’dir.
    - `conversationId` string — İstek/yanıt eşleştirmesi için uniq ID (opsiyonel).
    - `cardUserKey` string, required — Kartın ekleneceği mevcut kullanıcı anahtarı.
    - `card` Card, required — Kart bilgileri.
      - `cardAlias` string — Saklı karta verilen isim.
      - `expireYear` string, required — Kartın üzerindeki yıl.
      - `expireMonth` string, required — Kartın üzerindeki ay.
      - `cardNumber` string, required — Kartın numarası.
      - `cardHolderName` string, required — Kartın üzerindeki isim.

## Response `200`

Başarılı yanıt

- CardCreateSuccessResponse
  - `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 (varsa).
  - `externalId` string — İstekle iletilen `externalId` değeri.
  - `email` string — Saklanan kart üzerindeki email (yalnızca ilk varyantta dönebilir).
  - `cardUserKey` string — Saklanan karta ait kullanıcı anahtarı. Tekrar ödeme tahsil etmek için kullanılır.
  - `cardToken` string — Saklı karta ait token. Tekrar ödeme tahsil etmek için kullanılır.
  - `binNumber` string — Kartın ilk 8 hanesidir.
  - `lastFourDigits` string — Kartın son 4 hanesi.
  - `cardType` 'CREDIT_CARD' | 'DEBIT_CARD' | 'PREPAID_CARD' — Kart tipi.
  - `cardAssociation` 'VISA' | 'MASTER_CARD' | 'AMERICAN_EXPRESS' — Kart kuruluşu.
  - `cardFamily` 'Bonus' | 'Axess' | 'World' | 'Maximum' | 'Paraf' | 'CardFinans' — Kart ailesi (yerel kartlarda döner).
  - `cardAlias` string — Karta verilen isim.
  - `cardBankCode` integer — Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka kodu.
  - `cardBankName` string — Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka adı.

## Other responses

- `400` — Geçersiz 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)