GitHubFeedback FormAPI Reference - Beta

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

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]
Responses
200

Başarılı yanıt (CF başlatıldı)

application/json
post
POST https://api.iyzipay.com/payment/iyzipos/checkoutform/initialize/auth/ecom
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "locale": "tr",
  "conversationId": "conversationId",
  "price": 6.0,
  "paidPrice": 6.0,
  "currency": "TRY",
  "basketId": "basketId",
  "paymentGroup": "PRODUCT",
  "callbackUrl": "https://callback.com/test",
  "enabledInstallments": [1,2,3,4,6,9,12],
  "buyer": {
    "id": "BY789",
    "name": "John",
    "surname": "Doe",
    "identityNumber": "11111111111",
    "email": "[email protected]",
    "gsmNumber": "+905350000000",
    "registrationDate": "2013-04-21 15:12:09",
    "lastLoginDate": "2015-10-05 12:43:35",
    "registrationAddress": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "city": "Istanbul",
    "country": "Turkey",
    "zipCode": "34732",
    "ip": "85.34.78.112"
  },
  "shippingAddress": {
    "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "zipCode": "34742",
    "contactName": "Jane Doe",
    "city": "Istanbul",
    "country": "Turkey"
  },
  "billingAddress": {
    "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "zipCode": "34742",
    "contactName": "Jane Doe",
    "city": "Istanbul",
    "country": "Turkey"
  },
  "basketItems": [
    {"id": "BI101", "price": 1.0, "name": "Binocular", "category1": "Collectibles", "category2": "Accessories", "itemType": "PHYSICAL"},
    {"id": "BI102", "price": 2.0, "name": "Game code", "category1": "Game", "category2": "Online Game Items", "itemType": "VIRTUAL"},
    {"id": "BI103", "price": 3.0, "name": "Usb", "category1": "Electronics", "category2": "Usb / Cable", "itemType": "PHYSICAL"}
  ]
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755536500000,
  "conversationId": "conversationId",
  "token": "077aff05-1e9b-44aa-aa11-c268bb8b3826",
  "checkoutFormContent": "<script type=\"text/javascript\">if (typeof iyziInit == 'undefined') {var iyziInit = {currency:\"TRY\",token:\"c6a48036-327e-4808-89d0-d9049b123538\",price:6.00,pwiPrice:6.00,shippingDiscountAmount:null,locale:\"tr\",baseUrl:\"https://sandbox-api.iyzipay.com\", merchantGatewayBaseUrl:\"https://sandbox-merchantgw.iyzipay.com\", consumerGatewayBaseUrl:\"https://sandbox-consumerapigw.iyzipay.com\", registerCardEnabled:false,bkmEnabled:true,bankTransferEnabled:true,bankTransferTimeLimit:{\"value\":5,\"type\":\"day\"},bankTransferRedirectUrl:\"https://callback.com/test\",bankTransferCustomUIProps:{},campaignEnabled:false,campaignMarketingUiDisplay:{},campaignMarketingUiDisplayV2:{\"mobile\":{\"cardTabContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_M_C_v_1754637545492.png\",\"gsmCheckContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_M_G_v_1754637545949.png\",\"pwiTabContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_M_P_v_1754637545797.png\"},\"desktop\":{\"cardTabContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_D_C_v_1754637546014.png\",\"gsmCheckContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_D_G_v_1754637546164.png\",\"pwiTabContent\":\"https://sandbox-static.iyzipay.com/marketing-display/campaign_D_P_v_1754637546098.png\"}},paymentSourceName:\"\",plusInstallmentResponseList:null,payWithIyzicoSingleTab:false,payWithIyzicoSingleTabV2:false,payWithIyzicoOneTab:false,mixPaymentEnabled:true,creditCardEnabled:true,bankTransferAccounts:[{\"iban\":\"TR020006200035600006294884\",\"legalCompanyTitle\":\"iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.\",\"currency\":\"TRY\",\"bank\":\"Garanti Bankası\",\"bankId\":62,\"bankLogoUrl\":\"https://static.iyzipay.com/checkoutform/img/banks/62.svg\"},{\"iban\":\"TR080006400000111351092786\",\"legalCompanyTitle\":\"iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.\",\"currency\":\"TRY\",\"bank\":\"İş Bankası\",\"bankId\":64,\"bankLogoUrl\":\"https://static.iyzipay.com/checkoutform/img/banks/64.svg\"},{\"iban\":\"TR340004600786888000080896\",\"legalCompanyTitle\":\"iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.\",\"currency\":\"TRY\",\"bank\":\"Akbank\",\"bankId\":46,\"bankLogoUrl\":\"https://static.iyzipay.com/checkoutform/img/banks/46.svg\"},{\"iban\":\"TR910006701000000096073759\",\"legalCompanyTitle\":\"iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.\",\"currency\":\"TRY\",\"bank\":\"Yapı Kredi Bankası\",\"bankId\":67,\"bankLogoUrl\":\"https://static.iyzipay.com/checkoutform/img/banks/67.svg\"},{\"iban\":\"TR760001001187768823545001\",\"legalCompanyTitle\":\"iyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.\",\"currency\":\"TRY\",\"bank\":\"Ziraat Bankası\",\"bankId\":10,\"bankLogoUrl\":\"https://static.iyzipay.com/checkoutform/img/banks/10.svg\"}],userCards:[],fundEnabled:true,memberCheckoutOtpData:{},force3Ds:false,isSandbox:true,storeNewCardEnabled:true,paymentWithNewCardEnabled:true,enabledApmTypes:[\"SOFORT\",\"IDEAL\",\"QIWI\",\"GIROPAY\"],payWithIyzicoUsed:false,payWithIyzicoEnabled:true,payWithIyzicoCustomUI:{},buyerName:\"John\",buyerSurname:\"Doe\",merchantInfo:\"\",merchantName:\"Sandbox Merchant Name - 3404590\",cancelUrl:\"\",buyerProtectionEnabled:true,hide3DS:false,gsmNumber:\"\",email:\"[email protected]\",checkConsumerDetail:{},subscriptionPaymentEnabled:false,disabledCardStorageInfoCheckbox:false,ucsEnabled:true,fingerprintEnabled:false,payWithIyzicoFirstTab:false,creditEnabled:false,payWithIyzicoLead:false,zeroAuth:false,goBackUrl:\"\",customMerchantName:\"\",useCurrencySymbol:false,quickPwiEnabled:false,quickPwiNewCardEnabled:false,onlyQuickPwiView:false,consumerCardList:[],isForeignNumber:false,agreementCheckedByDefault:true,metadata : {},createTag:function(){var iyziJSTag = document.createElement('script');iyziJSTag.setAttribute('src','https://cdnsandbox.iyzipay.com/checkoutform/v2/bundle.js?v=1850323636123');document.head.appendChild(iyziJSTag);}};iyziInit.createTag();}</script><script type=\"text/javascript\">if (typeof iyziUcsInit == 'undefined') {var iyziUcsInit = {\"baseUrl\":\"https://sandbox-api.iyzipay.com\", \"ucsToken\":\"1cf43ef6-30ce-402a-a487-1be3f5c8702b\",\"scriptType\":\"BUYER_PROTECTION_CONSENT\",\"buyerProtectedMerchant\":true,\"maskedGsmNumber\":\"\",\"gsmNumber\":\"\",\"merchantName\":\"Sandbox Merchant Name - 3404590\", createTag: function () {var iyziUcsJSTag = document.createElement('script'); iyziUcsJSTag.setAttribute('src', 'https://sandbox-static.iyzipay.com/checkoutform/v2/bundle.js?v=1755539435707'); document.head.appendChild(iyziUcsJSTag);}};if (typeof iyziInit == 'undefined') { iyziUcsInit.createTag(); }}</script>",
  "paymentPageUrl": "https://sandbox-cpp.iyzipay.com?token=c6a48036-327e-4808-89d0-d9049b123538&lang=tr",
  "signature": "66e57d8376c4a15cbee9c8e82c6eb9f47a64bb47c80958c1198847a0049aa5df"
}

Örnek Kodlar

PHP

Java

.NET

Node.Js

Python

Postman

Last updated