---
title: "Ödeme Formu (CF) Başlatma"
method: POST
path: "/payment/iyzipos/checkoutform/initialize/auth/ecom"
tags: ["CheckoutForm"]
---

# Ödeme Formu (CF) Başlatma

`POST /payment/iyzipos/checkoutform/initialize/auth/ecom`

Ödeme formu (Checkout Form) oturumu başlatır ve ödeme sayfasını göstermek için `checkoutFormContent` / `paymentPageUrl` ve işleme ait `token` döner.

## Headers

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

## Request body

- CFInitializeRequest
  - `locale` 'tr' | 'en' — Dil kodu. Varsayılan; tr. Ödeme formunun İngilizce oluşturulması için "en" gönderilmelidir.
  - `conversationId` string — İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.
  - `price` unknown, required
  - `paidPrice` unknown, required
  - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'NOK' | 'CHF', required — Para birimi. Varsayılan; TRY.
  - `basketId` string — Sepet ID’si.
  - `paymentGroup` 'PRODUCT' | 'LISTING' | 'SUBSCRIPTION' — Ödeme grubu. Varsayılan; PRODUCT.
  - `callbackUrl` string, required — Ödeme akışında üye işyerine başarılı ve hatalı sonucu bildirmek üzere alınan URL adresi. Geçerli bir ssl sertifikasına sahip olmalıdır.
  - `enabledInstallments` integer[] — Kullanılabilir taksit seçenekleri.
  - `buyer` BuyerCF, 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.
    - `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 (CF başlatıldı)

- CFInitializeResponse
  - `status` 'success' | 'failure' — Gönderilen isteğin sonucu.
  - `locale` string — Yanıt dili.
  - `systemTime` integer — İşlem zamanı (epoch ms).
  - `conversationId` string — İstek ile eşleşen ID.
  - `token` string — Checkout form için oluşturulan tekil değer. Her istek için özel üretilir ve işyerine dönülür. Ödemenin sonucunu öğrenmek için zorunlu bir alandır.
  - `checkoutFormContent` string — Ödeme formunun HTML içeriği (Base64 kodlu).
  - `paymentPageUrl` string — iyzico Ortak Ödeme Sayfası için dönen URL adresi.
  - `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/revisions/46976ce5eed9/schema)