# Ödeme Oluşturma Ödeme Oluşturma API’si müşterinin kart ödemelerinin işlenmesinden sorumludur. Bu hizmet kullanıldığında iyzico işlemin başarısına ilişkin anında yanıt verir. * TROY, MASTERCARD, VISA ve AMEX markalı kartlarla yapılan işlemleri destekler. * BONUS, WORLD, MAXIMUM, AXESS, CARDFINANS, PARAF, ADVANTAGE gibi taksit programlarına katılmış olan kartlara 2, 3, 6, 9 ve 12 taksit seçenekleri sunulmaktadır. * Panelde başarılı işlemler yeşil renkte, başarısız işlemler ise kırmızı renkte görüntülenir. * Üye iş yeri, conversationId ve basketId parametrelerini kendi tarafında sipariş numarası olarak kullanabilir. Bu özellikleri birleştirerek müşterilerinize, işlemlerinin başarısı veya başarısızlığı hakkında gerçek zamanlı geri bildirim sağlayarak kusursuz bir ödeme deneyimi sağlayabilirsiniz. ## Create Non3D Payment > 3D Secure olmadan ödeme başlatır. ```json {"openapi":"3.0.3","info":{"title":"NON3D","version":"1.0.0"},"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/payment/auth":{"post":{"summary":"Create Non3D Payment","description":"3D Secure olmadan ödeme başlatır.","tags":["Non3D Payment"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paidPrice","price","currency","paymentCard","buyer","shippingAddress","billingAddress","basketItems"],"properties":{"conversationId":{"type":"string","description":"İstek/yanıt eşleştirmesi için benzersiz ID."},"locale":{"type":"string","description":"Dil kodu. Alabileceği değerler; tr, en. Default; tr","enum":["tr","en"]},"paidPrice":{"type":"decimal","description":"Kullanıcıdan tahsil edilecek toplam tutar."},"price":{"type":"decimal","description":"Sepet toplam tutarı."},"paymentGroup":{"type":"string","description":"Ödeme grubu. Default; PRODUCT.","enum":["PRODUCT","LISTING","SUBSCRIPTION"]},"currency":{"type":"string","description":"Para birimi. Default; TRY.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"installment":{"type":"integer","description":"Taksit sayısı. Gönderilmezse tek çekim (1) olarak işlem sağlanılabilir.","enum":[1,2,3,6,9,12]},"basketId":{"type":"string","description":"Sepet ID’si."},"paymentChannel":{"type":"string","description":"Ödeme kanalı.","enum":["WEB","MOBILE","MOBILE_WEB","MOBILE_IOS","MOBILE_ANDROID","MOBILE_WINDOWS","MOBILE_TABLET","MOBILE_PHONE"]},"paymentCard":{"description":"Kart Bilgileri.","$ref":"#/components/schemas/PaymentCard"},"buyer":{"description":"Alıcı Bilgileri.","$ref":"#/components/schemas/Buyer"},"shippingAddress":{"description":"Kargo Adresi. Sepetteki ürünlerden en az bir tanesinin, itemType \"PHYSICAL\" olması durumunda gönderilmesi zorunludur. Tüm ürünler \"VIRTUAL\" olduğu taktirde 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."}}}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentResponse"}}}},"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":{"PaymentCard":{"type":"object","required":["cardHolderName","cardNumber","expireYear","expireMonth","cvc"],"properties":{"cardHolderName":{"type":"string","description":"Kart sahibinin adı soyadı."},"cardNumber":{"type":"string","description":"Kart numarası."},"expireYear":{"type":"string","description":"Son kullanma yılı (YYYY formatında)."},"expireMonth":{"type":"string","description":"Son kullanma ayı (MM formatında)."},"cvc":{"type":"string","description":"CVC kodu."},"registerCard":{"type":"integer","description":"Kart kaydedilsin mi? (0 = hayır, 1 = evet)"}}},"Buyer":{"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":"TC Kimlik Numarası."},"email":{"type":"string","description":"E-posta."},"gsmNumber":{"type":"string","description":"Telefon numarası."},"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":"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":"İlgili kişi."},"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."}}},"PaymentResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (tr/en)."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."},"price":{"type":"decimal","description":"Sepet toplam tutarı."},"paidPrice":{"type":"decimal","description":"Tahsil edilen toplam tutar."},"installment":{"type":"integer","description":"Taksit sayısı."},"paymentId":{"type":"string","description":"Ödeme ID’si."},"fraudStatus":{"type":"integer","description":"Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.\n - 1: Onaylandı\n - 0: İncelemede\n - -1: Reddedildi\n","enum":[0,-1,1]},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır."},"iyziCommissionRateAmount":{"type":"decimal","description":"Ödemeye ait iyzico işlem komisyon tutarı."},"iyziCommissionFee":{"type":"decimal","description":"Ödemeye ait iyzico işlem ücreti."},"cardType":{"type":"string","description":"Kart tipi.","enum":["CREDIT_CARD","DEBIT_CARD","PREPAID_CARD"]},"cardAssociation":{"type":"string","description":"Kart kuruluşu.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS","TROY"]},"cardFamily":{"type":"string","description":"Kart ailesi.","enum":["Bonus","Axess","World","Maximum","Paraf","CardFinans"]},"binNumber":{"type":"string","description":"BIN (ilk 8 hane)."},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi."},"basketId":{"type":"string","description":"Sepet ID."},"currency":{"type":"string","description":"Para birimi.","enum":["TRY","USD","EUR","NOK","CHF","GBP"]},"itemTransactions":{"type":"array","description":"Sepet öğelerine ait işlem kalemleri.","items":{"type":"object","properties":{"paymentTransactionId":{"type":"string","description":"Ödeme kırılımına ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödeme kırılımının iadesi, onayı, onay geri çekmesi ve iyzico ile iletişimde kullanılır. Tercihen itemId ile ilişkili bir şekilde tutulmalıdır."},"itemId":{"type":"string","description":"Üye işyeri tarafından iletilen, sepetteki ürüne ait id."},"price":{"type":"decimal","description":"Üye işyeri tarafındaki sepetteki ürüne ait tutar."},"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"transactionStatus":{"type":"integer","description":"Ödeme kırılımının durumu.\n- 0: Fraud kontrolünde\n- -1: Fraud kontrolünden sonra reddedildi\n- 1: Onaylandı. (Pazaryerinde 1 değeri Üye İşyeri Onayı Bekliyor Anlamına Gelir)\n- 2: Onaylandı (Pazaryeri Onay Verilmiş)\n","enum":[0,-1,1,2]},"blockageRate":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj oranı. iyzico – üye işyeri anlaşmasına göre, üye işyerine işlem bazında blokaj uygulayabilir. Bu blokaj üye işyeri fraud riskini önlemek içindir, blokaj süresi boyunca para iyzico’da tutulur, bu süre sonrasında üye işyerine gönderilir."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"blockageRateAmountsubMerchant":{"type":"decimal","description":"Kırılım bazında alt üye işyeri blokaj tutarı."},"blockageResolvedDate":{"type":"string","description":"İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örn. 2015-10-19 14:36:52."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranının kırılım bazında dağılmış oranı."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarıın, kırılım bazında dağılmış tutarı."},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"subMerchantPrice":{"type":"decimal","description":"Alt üye işyeri hakedişi."},"subMerchantPayoutRate":{"type":"string","description":"Alt üye işyeri gönderilecek tutar oranı."},"subMerchantPayoutAmount":{"type":"decimal","description":"Alt üye işyerine aktarılacak tutar."},"convertedPayout":{"type":"object","description":"Kırılım bazında, kur çevrimi sonrası hesaplamalar.","properties":{"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücretinin kırılım bazında dağılmış tutarı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı."},"blockageRateAmountMerchant":{"type":"decimal","description":"Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır."},"blockageRateAmountSubMerchant":{"type":"string"},"subMerchantPayoutAmount":{"type":"string"},"merchantPayoutAmount":{"type":"decimal","description":"Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar."},"iyziConversationRate":{"type":"decimal","description":"Kur oranı."},"iyziConversationRateAmount":{"type":"decimal","description":"Kur oranı sonucu tutar."}}}}}},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"phase":{"type":"string","description":"Ödeme Fazı."},"hostReference":{"type":"string","description":"Ödemeye ilişkin banka tarafından verilen hostReference değeri."},"signature":{"type":"string","description":"İmza doğrulaması için kullanılabilecek signature değeri."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"Hata/başarı bilgisi."},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"errorGroup":{"type":"string","description":"Hata grubu."},"locale":{"type":"string","description":"Dil kodu."},"systemTime":{"type":"integer","description":"Sistem zamanı."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si."}}}}}} ``` #### Örnek Kodlar
PHP
Java
.NET
Node.Js
Python
Son olarak aşağıdaki başlıkları analiz ederek, ödeme sorgusunun sonucunu etkili bir şekilde yönetebilir ve yanıtlayabilirsiniz, böylece müşterileriniz için sorunsuz ve güvenilir bir ödeme süreci sağlayabilirsiniz. * `status` parametresi işlemin durumu hakkında bilgi sağlar. `success`, işlemin başarıyla tamamlandığını ve ödemenin işlendiğini gösterir. `failure`, işlemin başarısız olduğunu belirtir ve başarısızlığın nedenine ilişkin bir hata mesajı verilir. * Bu hizmet için `paymentStatus` parametresi boştur. * `paymentId` ve `paymentTransactionId` değerleri, ileride referans noktası olarak kullanılabileceği için saklanmalıdır. * Başarısız bir işlem durumunda (`failure` durumu), `errorCode`, `errorMessage` ve `errorGroup` parametreleri, hatayla ilgili ayrıntıları sağlayarak ilgili değerlerle birlikte döndürülür.