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
post
Ö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.
Header parameters
AuthorizationstringRequired
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
Example: IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequired
Content-Type değeri.
Example: application/json
Body
localestring · enumOptional
Dil kodu. Varsayılan; tr. Ödeme formunun İngilizce oluşturulması için "en" gönderilmelidir.
Example: trPossible values:
conversationIdstringOptional
İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.
Example: conversationId
pricedecimalRequired
Sepet toplamı.
Example: 6
paidPricedecimalRequired
Tahsil edilecek toplam tutar.
Example: 6
currencystring · enumRequired
Para birimi. Varsayılan; TRY.
Example: TRYPossible values:
basketIdstringOptional
Sepet ID’si.
Example: basketId
paymentGroupstring · enumOptional
Ödeme grubu. Varsayılan; PRODUCT.
Example: PRODUCTPossible values:
callbackUrlstringRequired
Ö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.
Example: https://callback.com/test
enabledInstallmentsinteger[]Optional
Kullanılabilir taksit seçenekleri.
Example: [1,2,3,4,6,9,12]
paymentSourcestringOptional
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.
Example: Shopify
Responses
200
Başarılı yanıt (CF başlatıldı)
application/json
statusstring · enumOptional
Gönderilen isteğin sonucu.
Example: successPossible values:
localestringOptional
Yanıt dili.
Example: tr
systemTimeintegerOptional
İşlem zamanı (epoch ms).
Example: 1755536500000
conversationIdstringOptional
İstek ile eşleşen ID.
Example: conversationId
tokenstringOptional
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.
