search
GitHubFeedback FormAPI Reference - Beta

Ö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.

hashtag
Create Non3D Payment

post

3D Secure olmadan ödeme başlatır.

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
conversationIdstringOptional

İstek/yanıt eşleştirmesi için benzersiz ID.

Example: conversationId
localestring · enumOptional

Dil kodu. Alabileceği değerler; tr, en. Default; tr

Example: trPossible values:
paidPricedecimalRequired

Kullanıcıdan tahsil edilecek toplam tutar.

Example: 1
pricedecimalRequired

Sepet toplam tutarı.

Example: 1
paymentGroupstring · enumOptional

Ödeme grubu. Default; PRODUCT.

Example: PRODUCTPossible values:
currencystring · enumRequired

Para birimi. Default; TRY.

Example: TRYPossible values:
installmentinteger · enumOptional

Taksit sayısı. Gönderilmezse tek çekim (1) olarak işlem sağlanılabilir.

Possible values:
basketIdstringOptional

Sepet ID’si.

Example: B67832
paymentChannelstring · enumOptional

Ödeme kanalı.

Example: WEBPossible values:
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
chevron-right
200

Başarılı yanıt

application/json
statusstring · enumOptional

Yapılan isteğin sonucunu bildirir.

Example: successPossible values:
localestringOptional

Yanıt dili (tr/en).

Example: tr
systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1755198001941
conversationIdstringOptional

İstek ile eşleşen ID.

Example: conversationId
pricedecimalOptional

Sepet toplam tutarı.

Example: 1
paidPricedecimalOptional

Tahsil edilen toplam tutar.

Example: 1
installmentintegerOptional

Taksit sayısı.

Example: 1
paymentIdstringOptional

Ödeme ID’si.

Example: 25149157
fraudStatusinteger · enumOptional

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.

  • 1: Onaylandı
  • 0: İncelemede
  • -1: Reddedildi
Example: 1Possible values:
merchantCommissionRatedecimalOptional

Ü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.

Example: 0
merchantCommissionRateAmountdecimalOptional

Ü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.

Example: 0
iyziCommissionRateAmountdecimalOptional

Ödemeye ait iyzico işlem komisyon tutarı.

Example: 0.2094
iyziCommissionFeedecimalOptional

Ödemeye ait iyzico işlem ücreti.

Example: 0.25
cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:
cardAssociationstring · enumOptional

Kart kuruluşu.

Example: MASTER_CARDPossible values:
cardFamilystring · enumOptional

Kart ailesi.

Example: AxessPossible values:
binNumberstringOptional

BIN (ilk 8 hane).

Example: 552608
lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006
basketIdstringOptional

Sepet ID.

Example: basketId
currencystring · enumOptional

Para birimi.

Example: TRYPossible values:
authCodestringOptional

Bankadan dönen authCode değeri.

Example: 214525
phasestringOptional

Ödeme Fazı.

Example: AUTH
hostReferencestringOptional

Ödemeye ilişkin banka tarafından verilen hostReference değeri.

Example: mock00001iyzihostrfn
signaturestringOptional

İmza doğrulaması için kullanılabilecek signature değeri.

Example: 5f510cd92b4b9c50a39b617cda228f4159f290860a4c20a965c55b119c9e9052
post
/payment/auth
HTTP

hashtag
Örnek Kodlar

PHParrow-up-right

Javaarrow-up-right

.NETarrow-up-right

Node.Jsarrow-up-right

Pythonarrow-up-right

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.

Last updated