# CF Başlatma Bu, ödemelerinizi tamamlamanın en hızlı ve en kolay yoludur. Kart ön tarafı kontrolleri, BIN sorgulamaları, taksit sorgulamaları, 3D Secure kontrolleri veya kart bilgileri kaydetme entegrasyonları gibi ek sorgulara ihtiyaç duymadan sorunsuz bir ödeme süreci sağlar. Bu süreci takip ederek iyzico ile sorunsuz ve verimli bir entegrasyon sağlayabilir, müşterilerinize kolaylaştırılmış bir ödeme deneyimi sunabilirsiniz. ## Ödeme Formu (CF) Başlatma > Ö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. ```json {"openapi":"3.0.3","info":{"title":"Checkout Form (CF)","version":"1.0.1"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/iyzipos/checkoutform/initialize/auth/ecom":{"post":{"summary":"Ödeme Formu (CF) Başlatma","description":"Ö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.","tags":["CheckoutForm"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CFInitializeRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt (CF başlatıldı)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CFInitializeResponse"}}}},"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":{"CFInitializeRequest":{"type":"object","required":["price","paidPrice","currency","callbackUrl","buyer","shippingAddress","billingAddress","basketItems"],"properties":{"locale":{"type":"string","description":"Dil kodu. Varsayılan; tr. Ödeme formunun İngilizce oluşturulması için \"en\" gönderilmelidir.","enum":["tr","en"]},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner."},"price":{"type":"decimal","description":"Sepet toplamı."},"paidPrice":{"type":"decimal","description":"Tahsil edilecek toplam tutar."},"currency":{"type":"string","description":"Para birimi. Varsayılan; TRY.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"basketId":{"type":"string","description":"Sepet ID’si."},"paymentGroup":{"type":"string","description":"Ödeme grubu. Varsayılan; PRODUCT.","enum":["PRODUCT","LISTING","SUBSCRIPTION"]},"callbackUrl":{"type":"string","description":"Ö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":{"type":"array","description":"Kullanılabilir taksit seçenekleri.","items":{"type":"integer"}},"buyer":{"description":"Alıcı Bilgileri","$ref":"#/components/schemas/BuyerCF"},"shippingAddress":{"description":"Teslimat Adresi. Sepetteki ürünlerden en az bir tanesi PHYSICAL ise zorunludur. Tüm ürünler VIRTUAL ise 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."}}},"BuyerCF":{"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."},"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."}}},"CFInitializeResponse":{"type":"object","properties":{"status":{"type":"string","description":"Gönderilen isteğin sonucu.","enum":["success","failure"]},"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."},"token":{"type":"string","description":"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":{"type":"string","description":"Ödeme formunun HTML içeriği (Base64 kodlu)."},"paymentPageUrl":{"type":"string","description":"iyzico Ortak Ödeme Sayfası için dönen URL adresi."},"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 sonucu.","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