Bu entegrasyonda kullanılan iyzico Ödeme Formu (CheckoutForm) ödeme yöntemi, temel olarak standart ödeme formu entegrasyonu ile aynı akışa sahiptir. Bu yöntemle yapılan işlemlerdeki temel fark, kullanılan endpoint'in farklı olmasıdır.
iyzico Ödeme Formu (CheckoutForm) entegrasyonunun detayları ve işlem akışına ilişkin teknik bilgiler için lütfen Ödeme Formu sayfasını ziyaret ediniz.
Ödeme Formu ile Ön Provizyon Başlatma
Ö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.
Başarılı şekilde ödeme oluşturulduğunda, iyzico API’si tarafından başarılı bir yanıt (response) döner. Dönen checkoutFormContent alanı içerisinde <script> etiketi ile oluşturulmuş ödeme formu yer alır. Bu içerik HTML sayfasında doğrudan render edilerek kullanıcıya gösterilmelidir.
Kullanıcı ödeme işlemini tamamladıktan sonra, ilk istek sırasında belirtilen callbackUrl adresine otomatik olarak yönlendirilir ve token değeri post edilir.
