iyzico Checkout Form ve Ortak Ödeme Sayfası ve Iframe Dokümanı

 iyzico Checkout Form ve Ortak Ödeme Sayfası ve Iframe Dokümanı Yazarlar: Hakan ERDOĞAN Sabri Onur TÜZÜN Versiyon: 1.2 iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com Değişiklik Tarihçesi Tarih Yazar Versiyon Gerekçe 28/09/15 Hakan ERDOGAN, Sabri Onur Tüzün 1.0 İlk taslak döküman 21/01/16 Emre Talay Can Pekdemir 1.1 Ortak Ödeme Sayfası ile ilgili bilgilerin eklenmesi. 31/05/16 Emre Fındık 1.2 Sandbox/Test ve node.js ile ilgili bilgilerin eklenmesi iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com İçerik iyzico Checkout Form ve Ortak Ödeme Sayfası ve Iframe Dokümanı ................................................................. 1 1 Başlarken ................................................................................................................................................................ 4 2 API Servisleri .......................................................................................................................................................... 5 2.1 API Service Servisleri, İstek (Request) ve Sonuç (Response) Ortak Alanları ........................................................ 5 2.2 Ödeme Grupları, Ürün Tipleri ...................................................................................................................................... 6 2.3 Ödeme İstek ve Dönüş Parametreleri Sözlüğü ......................................................................................................... 6 2.4 Checkout Form ve Ortak Ödeme Sayfası ................................................................................................................ 10 2.4.1 initializeCheckoutForm ........................................................................................................................................................ 12 2.4.2 Callback (GetAuthRequest) ................................................................................................................................................ 13 2.5 İptal .............................................................................................................................................................................. 22 2.6 İade .............................................................................................................................................................................. 23 iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com 1 Başlarken iyzico Checkout Form servisleri, internet üzerinden ödeme kabul eden tüm üye işyerlerine hitap edecek bir şekilde, oturum bilgisi tutmayan (stateless) Restful servis odaklı bir mimaride geliştirilmiştir. İletişim, şifreleme (PKI: public key infrastructure), veri sarmalama (data marshalling) ve veri çözme (data unmarshalling) için mutlaka bir API istemcisi (client) kullanmak gerekir. İyzico; • Java • .Net • PHP • Ruby on Rails (RoR) • Phyton • Node.js dillerinde yazılmış API istemcileri sunar. Üye işyeri kendi programlama diline göre uygun API istemcisini seçmelidir. İyzico API entegrasyonu için temelde 3 bilgiye ihtiyaç vardır: • API Base URL : Ortam (sandbox) bazlı API servis ana linkidir. Örnek: https://sandbox-­‐
api.iyzipay.com • API Key : Üye işyeri açık API anahtarıdır. Bu anahtar iyzico sandbox ile iletişimde kullanılır fakat kimseyle paylaşılmaz. Örnek: sandbox-­‐Txl2ctiktW6BrNmFo10pZiPn8W67Ksob • Secret Key : Üye işyeri gizli API güvenlik anahtarıdır. Bu anahtar iyzico sandbox ile iletişimde kullanılmaz ve kimseyle paylaşılmaz. Örnek: sandbox-­‐GdzIHrXly6gQkZfEZUEw0LqbXFEmRe iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com 2 API Servisleri iyzico Checkout Form; aşağıdaki servislerden oluşmaktadır # 1 2 3 4 API Servis (Endpoint) initializeCheckoutForm Callback & getAuthResponse * İptal * İade API Servis (Endpoint) URL /payment/iyzipos/checkoutform/initialize/ecom /payment/iyzipos/checkoutform/auth/ecom/detail /payment/iyzipos/cancel /payment/iyzipos/refund Method POST POST POST POST • İptal ve iade işlemleri iyzico işyeri paneli üzerinden kolaylıkla yapılabilmektedir. 2.1 API Service Servisleri, İstek (Request) ve Sonuç (Response) Ortak Alanları API servislerine mutlaka iyzico istemcileri (client) ile erişim sağlanması gerekmektedir, zira iyzico istemcileri sizin adınıza yetkilendirme ve veri gönderip almayı kolaylaştırır. Yapılan tüm servis isteklerinde; • Request Header’ın içinde Authorization ve x-­‐iyzi-­‐rnd parametreleri bulunmalıdır. İyzico istemcileri bunu sizin adınıza halleder. • Aşağıdaki istek parametreleri opsiyonel olarak gönderilebilir: Input İsmi Veri Tipi Zorunlu Açıklama locale String Hayır conversationId String Hayır iyzico istek snucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir. İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşmesi yapmak için kullanılabilir • Aşağıdaki sonuç parametreleri dönülür. Sonuç (status) başarılı (success) ise yapılan isteğe özel diğer alanlar dolu gelecektir: Output İsmi Veri Tipi status String errorCode String errorMessage String errorGroup String locale String conversationId String systemTime Long Açıklama Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner İşlem hatalıysa, bu hataya dair belirtilen koddur İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar İşlem hatalıysa, bu hataya dair belirtilen gruptur İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr’dir İstek esnasında gönderilmişse, sonuçta aynen geri iletilir Dönen sonucun o anki unix timestamp değeridir iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com 2.2 Ödeme Grupları, Ürün Tipleri Üye işyeri; ürün, listeleme ve abonelik ödeme tiplerinde ödeme alabilir. Listeleme ve abonelik arasında bir fark yoktur, ürün ödemesi ise farklı bir akışa sahiptir. • PRODUCT à Ürün • LISTING à Listeleme • SUBSCRIPTION à Abonelik Ödeme sepetinde yer alan ürünler ise Sanal veya Fiziksel ürün olabilir: • VIRTUAL • PHYSICAL à Sanal Ürün à Fiziksel Ürün • Listeleme (LISTING) ve Abonelik (SUBSCRIPTION) tipindeki ödemeler için sepet kırılımındaki ürünlerin tipi Sanal (VIRTUAL) olmalıdır. • Ürün (PRODUCT) tipindeki ödemeler için sepet kırılımındaki ürünlerin tipi Sanal (VIRTUAL) veya Fiziksel (PHYSICAL) olabilir • Sanal (VIRTUAL) tipteki ürünler için teslimat adresi (ShippingAddress) gönderilmesi opsiyoneldir. Sepette yer alan ürünlerin bir tanesi bile Fiziksel (PHYSICAL) ürün ise, teslimat adresi (ShippingAddress) gönderilmesi zorunludur. 2.3 Ödeme İstek ve Dönüş Parametreleri Sözlüğü Input ismi Veri Tipi Zorunlu Alan price Decimal Evet Açıklama Ödeme sepet tutarı. Kırılım tutarlar toplamı sepet tutarına eşit olmalı paidPrce Decimal Evet İndirim, vergi gibi değerlerin dahil edildiği, vade farkı önbcesi tutar değeri. currency String Evet Para birimi. Default değeri TRY’dir. Kullanılabilen diğer değerler ise USD, EUR, GBP ve IRR’dir. installment Integer Evet Taksit bilgisi, tek çekim için 1 gönderilmelidir. Geçerli değerler: 1, 2, 3, 6, 9 basketId String Hayır Üye işyeri sepet id’si iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com paymentChannel String Hayır Ödeme kanalı. Geçerli değerler enum içinde sunulmaktadır: WEB, MOBILE, MOBILE_WEB, MOBILE_IOS, MOBILE_ANDROID, MOBILE_WINDOWS, MOBILE_TABLET, MOBILE_PHONE paymentGroup String Hayır Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION paymentSource String Evet SHOPIFY,MAGENTO,PRESTASHOP,WOOCOMMERCE,OPENC
ART callbackUrl String Evet ödeme akışında üye işyerine başarılı ve hatalı sonucu bildirmek üzere alınan URL adresi. String String String Evet Evet Evet Üye işyeri tarafındaki alıcıya ait id String Evet String String Evet Evet email (Buyer) String Evet id (Buyer) name (Buyer) surname (Buyer) identityNumber (Buyer) city (Buyer) country (Buyer) gsmNumber (Buyer) ip (Buyer) registrationAddress (Buyer) zipCode (Buyer) registrationDate (Buyer) Üye işyeri tarafındaki alıcıya ait ad Üye işyeri tarafındaki alıcıya ait soyad Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası Üye işyeri tarafındaki alıcıya ait şehir bilgisi Üye işyeri tarafındaki alıcıya ait ülke bilgisi Üye işyeri tarafındaki alıcıya ait e-­posta bilgisi. E-­posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır String String Hayır Evet String Evet String Hayır Üye işyeri tarafındaki alıcıya ait posta kodu String Hayır Üye işyeri tarafındaki alıcıya ait kayıt tarihi. Tarih formatı 2015-­09-­
17 23:45:06 şeklinde olmalıdır lastLoginDate (Buyer) String Hayır Üye işyeri tarafındaki alıcıya ait son giriş tarihi. Tarih formatı 2015-­
09-­17 23:45:06 şeklinde olmalıdır contactName (BillingAddress) city (BillingAddress) country (BillingAddress) address (BillingAddress) zipCode (BillingAddress) String Evet String Evet String Evet String Evet String Hayır contactName String (ShippingAddress) Üye işyeri tarafındaki alıcıya ait GSM numarası Üye işyeri tarafındaki alıcıya ait IP adresi Üye işyeri tarafındaki alıcıya ait kayıt adresi Üye işyeri tarafındaki fatura adresi ad soyad bilgisi Üye işyeri tarafındaki fatura adresi şehir bilgisi Üye işyeri tarafındaki fatura adresi ülke bilgisi Üye işyeri tarafındaki fatura adresi Üye işyeri tarafındaki fatura adresi posta kodu Evet ** Üye işyeri tarafındaki teslimat adresi ad soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com city String (ShippingAddress) country String (ShippingAddress) address (ShippingAddress) zipCode (ShippingAddress) id (BasketItem) itemType (BasketItem) name (BasketItem) category1 (BasketItem) category2 (BasketItem) price (BasketItem) Evet ** Üye işyeri tarafındaki teslimat adresi şehir bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur Üye işyeri tarafındaki teslimat adresi ülke bilgisi. Sepetteki Evet ** ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur String Evet ** Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur String Hayır String Evet String Evet String Evet String Evet String Hayır Decimal Evet Üye işyeri tarafındaki teslimat adresi posta kodu Üye işyeri tarafındaki sepetteki ürüne ait id Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL Üye işyeri tarafındaki sepetteki ürüne ait isim Üye işyeri tarafındaki sepetteki ürüne ait kategori 1 Üye işyeri tarafındaki sepetteki ürüne ait kategori 2 Üye işyeri tarafındaki sepetteki ürüne ait tutar. 0 ve 0’dan küçük olamaz, tutarlar toplamı sepet tutarına (price) eşit olmalıdır Output ismi Veri Tipi checkoutFormContent String paymentPageUrl String token String tokenExpireTime Integer paymentId String paymentStatus String price Decimal Currency String Açıklama Checkout formun açılması için gereken HTML kod İyzico ortak ödeme sayfasına erişimi için gereken URL 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. Checkout form için üretilmiş olan token değerinin geçerlilik süresi. Ödemeye ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödemenin iptali ve iyzico ile iletişimde kullanılır Ödeme isteğinin durumunu gösterir. Success ise karttan ilgili tutar çekilmiştir. SUCCESS, FAILURE, INIT_THREEDS, CALLBACK_THREEDS, BKM_POS_SELECTED, CALLBACK_PECCO Ödeme sepet tutarı. Kırılım tutarlar toplamı sepet tutarına eşit olmalı Para birimi. Default değeri TRY’dir. Kullanılabilen diğer değerler ise USD, EUR, GBP ve IRR’dir. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com paidPrice Decimal İndirim vade farkı vs hesaplanmış POS’dan geçen, tahsil edilen, nihai tutar installment Integer Ödemenin taksit bilgisi, tek çekim için 1 döner. Geçerli değerler: 1, 2, 3, 6, 9 basketId String binNumber String Üye işyeri taradından gönderilen sepet id’si cardAssociation String cardFamily String cardType String fraudStatus Integer iyziCommissionFee Decimal iyziCommissionRateAmount Decimal merchantCommissionRate Decimal merchantCommissionRateAmount Decimal paymentTransactionId String (ItemTransactions) itemId String (ItemTransactions) price Decimal (ItemTransactions) paidPrice Decimal (ItemTransactions) transactionStatus Integer (ItemTransactions) blockageRate (ItemTransactions) Decimal Ödeme yapılan kartın ilk 6 hanesi Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler: VISA, MASTER_CARD, AMERICAN_EXPRESS Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu aile. Geçerli değerler: Bonus, Axess, World, Maximum, Paraf, CardFinans, AsyaCard, ... Geçerli değerler: CREDIT_CARD, DEBIT_CARD, PREPAID_CARD Ödeme işleminin fraud filtrelerine göre durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir bu durumda 1 değeri döner. Eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir ve -­1 döner. Eğer ödeme işlemi daha sonradan incelenip karar verilecekse 0 döner. Geçerli değerler: 0, -­1 ve 1. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir. Ödemeye ait iyzico işlem ücreti Ödemeye ait iyzico işlem komisyon tutarı Ü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 Ü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 Ö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 Üye işyeri tarafından iletilen, sepetteki ürüne ait id Üye işyeri tarafındaki sepetteki ürüne ait tutar Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır Ödeme kırılımının durumu. Ödeme fraud kontrolünde ise 0 değeri döner, bu durumda fraudStatus değeri de 0’dır. Ödeme, fraud kontrolünden sonra reddedilirse -­1 döner. Pazaryeri modelinde ürüne onay verilene dek bu değer 1 olarak döner. Pazaryeri modelinde ürüne onay verilmişse bu değer 2 olur. Geçerli değerler: 0, -­1, 1, 2 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ı üye işyerine gönderilir. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com blockageRateAmountMerchant Decimal (ItemTransactions) blockageResolvedDate String (ItemTransactions) iyziCommissionFee Decimal (ItemTransactions) iyziCommissionRateAmount Decimal (ItemTransactions) merchantCommissionRate Decimal (ItemTransactions) merchantCommissionRateAmount Decimal (ItemTransactions) merchantPayoutAmount Decimal (ItemTransactions) 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. İşlem bazında blokaj çözülme tarihi. yyyy-­MM-­dd HH:mm:ss formatındadır, örneğin 2015-­10-­19 14:36:52 iyico işlem ücretinin kırılım bazında dağılmış tutarı iyico işlem komisyon tutarının kırılım bazında dağılmış tutarı Üye işyerinin uyguladığı vade/komisyon oranının kırılım bazında dağılmış oranı Üye işyerinin uyguladığı vade/komisyon tutarıın, kırılım bazında dağılmış tutarı 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. 2.4 Checkout Form ve Ortak Ödeme Sayfası Checkout formun gösterilmek istenildiği bölüm için bir “<div>” tagi açılır. “<div>” tagi şu şekilde olmalıdır: <div id="iyzipay-­‐checkout-­‐form" class="popup"></div> Checkout form iki şekilde kullanılır. Sayfada popup olarak gösterilmek istediğinde div class=’popup’ verilir. Sayfada gömülü olarak responsive bir şekilde gösterilmek istenirse div class=’responsive’ olarak verilir. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com Popup Önyüz Responsive Önyüz Checkout Form ile ödeme süreci initializeCheckoutForm ve Callback olmak üzere iki temel aşamadan oluşur. Eğer Ortak Ödeme Sayfası kullanılmak istenirse, initializeCheckoutForm isteğine karşılık iyzico tarafından gönderilen dönüş değerinde paymentPageUrl parametresindeki sayfaya redirect edilir. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com iframe kullanılmak istendiğinde paymentPageUrl parametresinde dönen linke “&iframe=true” ifadesi eklenir. Örnek URL : https://sandbox-­‐cpp.iyzipay.com/?token=ABCTOKENABC&iframe=true 2.4.1 initializeCheckoutForm İşyeri, sepet ve alıcı parametreleriyle birlikte bir geri dönüş (callback) URL’ini initializeCheckoutForm isteği ile içerisinde iyzico’ya iletir. Bu istek için iyzico tarafından dönülen sonuç başarılı ise (status=success), dönüş içinde javascript içerik (checkoutFormContent) ve token değeri dönülür. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com İşyeri kendisine dönülen javascript içeriği (checkoutFormContent) ödeme sayfasına ekler. Bu işlemin sonrasında daha önceden tanımlanmış <div> tag alanında iyzico Checkout Form alıcıya gösterilir. Alıcı iyzico Checkout Form ile ödeme işlemini onaylamak için aşağıdaki bilgileri ilgili alanlarda belirtir. • Kart Sahibi Adı (zorunlu) • Kart Numarası (zorunlu) • Son Kullanma Tarihi (zorunlu) • CVC – Güvenlik Kodu (zorunlu) • 3D Secure Seçeneği (opsiyonel) • Taksit (opsiyonel) Not: initializeCheckoutForm isteğinin dönüş (response) değerinde, iyzico tarafından gönderilen tokenExpireTime değeri saniye cinsindendir. Token değeri bu süre zarfında kullanılmazsa hata alınır ve tekrardan initializeCheckoutForm isteği gönderilmelidir. 2.4.2 Callback (GetAuthRequest) Alıcı ödeme bilgilerini girerek ödeme işlemini onaylar. Akabinde iyzico ödeme sürecini tamamlar ve üye işyerinin ilk adımda (initializeCheckoutForm) iyzico’ya ilettiği callbackUrl’e ödeme token değerini iletir. Üye işyeri, kendisine iletilen token değerini kullaranarak, ödeme ile ilgili tüm detayları öğrenmek için iyzico’ya istekte (getAuthResponse) bulunur ve işlemin sonucuna göre kendi aksiyonunu alır. iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com initializeCheckoutForm Request Örneği (Java) EcomCheckoutFormServiceClient client = new EcomCheckoutFormServiceClientImpl(configuration);
EcomPaymentCheckoutFormInitializeRequest request = new EcomPaymentCheckoutFormInitializeRequest();
request.setLocale(RequestLocaleType.TR.getValue());
request.setConversationId("123456789");
request.setPrice(new BigDecimal("1"));
request.setCurrency ("TRY");
request.setBasketId("B67832");
request.setPaymentSource(PaymentSourceRequestType.SHOPIFY.name());
request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name());
EcomPaymentBuyerDto buyer = new EcomPaymentBuyerDto();
buyer.setId("BY789");
buyer.setName("Sabri Onur");
buyer.setSurname("Tüzün");
buyer.setGsmNumber("+905350000000");
buyer.setEmail("[email protected]");
buyer.setIdentityNumber("74300864791");
buyer.setLastLoginDate("2015-10-05 12:43:35");
buyer.setRegistrationDate("2013-04-21 15:12:09");
buyer.setRegistrationAddress("Nidakule Göztepe İş Merkezi Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73
Göztepe Kadıköy");
buyer.setIp("85.34.78.112");
buyer.setCity("İstanbul");
buyer.setCountry("Türkiye");
buyer.setZipCode("34732");
request.setBuyer(buyer);
EcomPaymentShippingAddressDto shippingAddress = new EcomPaymentShippingAddressDto();
shippingAddress.setContactName("Hakan Erdoğan");
shippingAddress.setCity("İstanbul");
shippingAddress.setCountry("Türkiye");
shippingAddress.setAddress("19 Mayıs Mah. İnönü Cad. No:45 Kozyatağı");
shippingAddress.setZipCode("34742");
request.setShippingAddress(shippingAddress);
EcomPaymentBillingAddressDto billingAddress = new EcomPaymentBillingAddressDto();
billingAddress.setContactName("Hakan Erdoğan");
billingAddress.setCity("İstanbul");
billingAddress.setCountry("Türkiye");
billingAddress.setAddress("19 Mayıs Mah. İnönü Cad. No:45 Kozyatağı");
billingAddress.setZipCode("34742");
request.setBillingAddress(billingAddress);
List<EcomPaymentBasketItemDto> basketItems = new ArrayList<EcomPaymentBasketItemDto>();
EcomPaymentBasketItemDto basketItem1 = new EcomPaymentBasketItemDto();
basketItem1.setId("BI101");
basketItem1.setName("ABC Marka Kolye");
basketItem1.setCategory1("Giyim");
basketItem1.setCategory2("Aksesuar");
basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name());
basketItem1.setPrice(new BigDecimal("0.3"));
basketItems.add(basketItem1);
EcomPaymentBasketItemDto basketItem2 = new EcomPaymentBasketItemDto();
basketItem2.setId("BI102");
basketItem2.setName("XYZ Oyun Kodu");
basketItem2.setCategory1("Oyun");
basketItem2.setCategory2("Online Oyun Kodları");
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name());
basketItem2.setPrice(new BigDecimal("0.5"));
basketItems.add(basketItem2);
EcomPaymentBasketItemDto basketItem3 = new EcomPaymentBasketItemDto();
basketItem3.setId("BI103");
basketItem3.setName("EDC Marka Usb");
basketItem3.setCategory1("Elektronik");
basketItem3.setCategory2("Usb / Cable");
basketItem3.setItemType(BasketItemRequestType.PHYSICAL.name());
basketItem3.setPrice(new BigDecimal("0.2"));
basketItems.add(basketItem3);
request.setBasketItems(basketItems);
request.setCallbackUrl("https://www.merchant.com/callback");
EcomPaymentCheckoutFormInitializeResponse response = client.initializeCheckoutForm(request);
System.out.println("conversationId=" + response.getConversationId());
System.out.println("locale=" + response.getLocale());
System.out.println("status=" + response.getStatus());
System.out.println("errorCode=" + response.getErrorCode());
System.out.println("errorMessage=" + response.getErrorMessage());
System.out.println("errorGroup=" + response.getErrorGroup());
System.out.println("systemTime=" + response.getSystemTime());
System.out.println("token=" + response.getToken());
System.out.println("checkoutFormContent=" + response.getCheckoutFormContent());
System.out.println("tokenExpireTime=" + response.getTokenExpireTime());
initializeCheckoutForm Response Örneği (Java) conversationId=123456789
locale=tr
status=success
errorCode=null
errorMessage=null
errorGroup=null
systemTime=1446648399308
token=f49dec04-729a-41f3-83aa-df790e90ce34
paymentPageUrl=https://cpp.iyzipay.com/?token= f49dec04-729a-41f3-83aa-df790e90ce34
checkoutFormContent=<script type="text/javascript">
var iyziInit = {token:'f49dec04-729a-41f3-83aa-df790e90ce34',price:1.00,locale:'tr',baseUrl:'http://localhost:8080',
createTag:function(){
var iyziCSSTag = document.createElement('link');
iyziCSSTag.setAttribute('rel','stylesheet');
iyziCSSTag.setAttribute('type','text/css');
iyziCSSTag.setAttribute('href','http://localhost:9095/checkoutform/css/main.css');
document.head.appendChild(iyziCSSTag);
var iyziJSTag = document.createElement('script');
iyziJSTag.setAttribute('src','http://localhost:9095/checkoutform/js/iyziCheckout.js');
document.head.appendChild(iyziJSTag);
}
}
iyziInit.createTag();
</script>
tokenExpireTime=1800
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com initializeCheckoutForm Request Örneği (JSON) {
"locale" : "tr",
"conversationId" : "123456789",
"price" : 1,
"currency" : TRY,
"basketId" : "B67832",
"paymentGroup" : "PRODUCT",
"buyer" : {
"id" : "BY789",
"name" : "Sabri Onur",
"surname" : "Tüzün",
"identityNumber" : "74300864791",
"email" : "[email protected]",
"gsmNumber" : "+905350000000",
"registrationDate" : "2013-04-21 15:12:09",
"lastLoginDate" : "2015-10-05 12:43:35",
"registrationAddress" : "Nidakule Göztepe İş Merkezi Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73
Göztepe Kadıköy",
"city" : "İstanbul",
"country" : "Türkiye",
"zipCode" : "34732",
"ip" : "85.34.78.112"
},
"shippingAddress" : {
"address" : "19 Mayıs Mah. İnönü Cad. No:45 Kozyatağı",
"zipCode" : "34742",
"contactName" : "Hakan Erdoğan",
"city" : "İstanbul",
"country" : "Türkiye"
},
"billingAddress" : {
"address" : "19 Mayıs Mah. İnönü Cad. No:45 Kozyatağı",
"zipCode" : "34742",
"contactName" : "Hakan Erdoğan",
"city" : "İstanbul",
"country" : "Türkiye"
},
"basketItems" : [ {
"id" : "BI101",
"price" : 0.3,
"name" : "ABC Marka Kolye",
"category1" : "Giyim",
"category2" : "Aksesuar",
"itemType" : "PHYSICAL",
"subMerchantKey" : null,
"subMerchantPrice" : null
}, {
"id" : "BI102",
"price" : 0.5,
"name" : "XYZ Oyun Kodu",
"category1" : "Oyun",
"category2" : "Online Oyun Kodları",
"itemType" : "VIRTUAL",
"subMerchantKey" : null,
"subMerchantPrice" : null
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com }, {
"id" : "BI103",
"price" : 0.2,
"name" : "EDC Marka Usb",
"category1" : "Elektronik",
"category2" : "Usb / Cable",
"itemType" : "PHYSICAL",
"subMerchantKey" : null,
"subMerchantPrice" : null
} ],
"callbackUrl" : "https://www.merchant.com/callback"
}
initializeCheckoutForm Response Örneği (JSON) {
"status" : "success",
"errorCode" : null,
"errorMessage" : null,
"errorGroup" : null,
"locale" : "tr",
"systemTime" : 1446648399308,
"conversationId" : "123456789",
"token" : "f49dec04-729a-41f3-83aa-df790e90ce34",
"paymentPageUrl"="https://cpp.iyzipay.com/?token= f49dec04-729a-41f3-83aa-df790e90ce34"
"checkoutFormContent" : "<script type=\"text/javascript\">\nvar iyziInit = {token:'f49dec04-729a-41f3-83aadf790e90ce34',price:1.00,locale:'tr',baseUrl:'http://localhost:8080',\ncreateTag:function(){\nvar iyziCSSTag =
document.createElement('link');\niyziCSSTag.setAttribute('rel','stylesheet');\niyziCSSTag.setAttribute('type','text/css');\niyzi
CSSTag.setAttribute('href','http://localhost:9095/checkoutform/css/main.css');\ndocument.head.appendChild(iyziCSSTag);\
nvar iyziJSTag =
document.createElement('script');\niyziJSTag.setAttribute('src','http://localhost:9095/checkoutform/js/iyziCheckout.js');\ndo
cument.head.appendChild(iyziJSTag);\n}\n}\niyziInit.createTag();\n</script>\n",
"tokenExpireTime" : 1800
}
GetAuth Request Örneği (Java) EcomCheckoutFormServiceClient client = new EcomCheckoutFormServiceClientImpl(configuration);
EcomRetrievePaymentCheckoutFormAuthRequest request = new EcomRetrievePaymentCheckoutFormAuthRequest();
request.setLocale(RequestLocaleType.TR.getValue());
request.setConversationId("123456789");
request.setToken("f49dec04-729a-41f3-83aa-df790e90ce34");
EcomRetrievePaymentCheckoutFormAuthResponse response = client.getAuthResponse(request);
System.out.println("conversationId=" + response.getConversationId());
System.out.println("locale=" + response.getLocale());
System.out.println("status=" + response.getStatus());
System.out.println("errorCode=" + response.getErrorCode());
System.out.println("errorMessage=" + response.getErrorMessage());
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com System.out.println("errorGroup=" + response.getErrorGroup());
System.out.println("systemTime=" + response.getSystemTime());
System.out.println("token=" + response.getToken());
System.out.println("callbackUrl=" + response.getCallbackUrl());
System.out.println("paymentStatus=" + response.getPaymentStatus());
System.out.println("paymentId=" + response.getPaymentId());
System.out.println("price=" + response.getPrice());
System.out.println("paidPrice=" + response.getPaidPrice());
System.out.println("currency=" + response.getCurrency());
System.out.println("installment=" + response.getInstallment());
System.out.println("basketId=" + response.getBasketId());
System.out.println("binNumber=" + response.getBinNumber());
System.out.println("cardAssociation=" + response.getCardAssociation());
System.out.println("cardFamily=" + response.getCardFamily());
System.out.println("cardType=" + response.getCardType());
System.out.println("cardToken=" + response.getCardToken());
System.out.println("cardUserKey=" + response.getCardUserKey());
System.out.println("fraudStatus=" + response.getFraudStatus());
System.out.println("iyziCommissionFee=" + response.getIyziCommissionFee());
System.out.println("iyziCommissionRateAmount=" + response.getIyziCommissionRateAmount());
System.out.println("merchantCommissionRate=" + response.getMerchantCommissionRate());
System.out.println("merchantCommissionRateAmount=" + response.getMerchantCommissionRateAmount());
List<EcomPaymentItemTransactionDto> itemTransactions = response.getItemTransactions();
if (itemTransactions != null && !itemTransactions.isEmpty()) {
for (EcomPaymentItemTransactionDto itemTransaction : itemTransactions) {
System.out.println("paymentTransactionId=" + itemTransaction.getPaymentTransactionId());
System.out.println("itemId=" + itemTransaction.getItemId());
System.out.println("paidPrice=" + itemTransaction.getPaidPrice());
System.out.println("price=" + itemTransaction.getPrice());
System.out.println("transactionStatus=" + itemTransaction.getTransactionStatus());
System.out.println("blockageRate=" + itemTransaction.getBlockageRate());
System.out.println("blockageRateAmountMerchant=" + itemTransaction.getBlockageRateAmountMerchant());
System.out.println("blockageRateAmountSubMerchant=" +
itemTransaction.getBlockageRateAmountSubMerchant());
System.out.println("blockageResolvedDate=" + itemTransaction.getBlockageResolvedDate());
System.out.println("iyziCommissionFee=" + itemTransaction.getIyziCommissionFee());
System.out.println("iyziCommissionRateAmount=" + itemTransaction.getIyziCommissionRateAmount());
System.out.println("merchantCommissionRate=" + itemTransaction.getMerchantCommissionRate());
System.out.println("merchantCommissionRateAmount=" +
itemTransaction.getMerchantCommissionRateAmount());
System.out.println("merchantPayoutAmount=" + itemTransaction.getMerchantPayoutAmount());
System.out.println("subMerchantKey=" + itemTransaction.getSubMerchantKey());
System.out.println("subMerchantPayoutAmount=" + itemTransaction.getSubMerchantPayoutAmount());
System.out.println("subMerchantPayoutRate=" + itemTransaction.getSubMerchantPayoutRate());
System.out.println("subMerchantPrice=" + itemTransaction.getSubMerchantPrice());
}
}
GetAuth Response Örneği (Java) conversationId=null
locale=null
status=success
errorCode=null
errorMessage=null
errorGroup=null
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com systemTime=1446650532883
token=f49dec04-729a-41f3-83aa-df790e90ce34
callbackUrl=https://www.merchant.com/callback
paymentStatus=SUCCESS
paymentId=253
price=1.00000000
paidPrice=1.00000000
currency=TRY
installment=1
basketId=B67832
binNumber=552879
cardAssociation=MASTER_CARD
cardFamily=Paraf
cardType=CREDIT_CARD
cardToken=null
cardUserKey=null
fraudStatus=1
iyziCommissionFee=0.25000000
iyziCommissionRateAmount=0.02500000
merchantCommissionRate=0E-8
merchantCommissionRateAmount=0E-8
paymentTransactionId=53
itemId=BI101
paidPrice=0.30000000
price=0.30000000
transactionStatus=2
blockageRate=10.00000000
blockageRateAmountMerchant=0.03000000
blockageRateAmountSubMerchant=0E-8
blockageResolvedDate=2015-11-19 17:20:43
iyziCommissionFee=0.07500000
iyziCommissionRateAmount=0.00750000
merchantCommissionRate=0E-8
merchantCommissionRateAmount=0E-8
merchantPayoutAmount=0.18750000
subMerchantKey=null
subMerchantPayoutAmount=0E-8
subMerchantPayoutRate=0E-8
subMerchantPrice=0E-8
paymentTransactionId=54
itemId=BI102
paidPrice=0.50000000
price=0.50000000
transactionStatus=2
blockageRate=10.00000000
blockageRateAmountMerchant=0.05000000
blockageRateAmountSubMerchant=0E-8
blockageResolvedDate=2015-11-19 17:20:43
iyziCommissionFee=0.12500000
iyziCommissionRateAmount=0.01250000
merchantCommissionRate=0E-8
merchantCommissionRateAmount=0E-8
merchantPayoutAmount=0.31250000
subMerchantKey=null
subMerchantPayoutAmount=0E-8
subMerchantPayoutRate=0E-8
subMerchantPrice=0E-8
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com paymentTransactionId=55
itemId=BI103
paidPrice=0.20000000
price=0.20000000
transactionStatus=2
blockageRate=10.00000000
blockageRateAmountMerchant=0.02000000
blockageRateAmountSubMerchant=0E-8
blockageResolvedDate=2015-11-19 17:20:43
iyziCommissionFee=0.05000000
iyziCommissionRateAmount=0.00500000
merchantCommissionRate=0E-8
merchantCommissionRateAmount=0E-8
merchantPayoutAmount=0.12500000
subMerchantKey=null
subMerchantPayoutAmount=0E-8
subMerchantPayoutRate=0E-8
subMerchantPrice=0E-8
GetAuth Request Örneği (JSON) {
"locale" : "tr",
"conversationId" : "123456789",
"token" : "f49dec04-729a-41f3-83aa-df790e90ce34"
}
GetAuth Response Örneği (JSON) {
"status" : "success",
"errorCode" : null,
"errorMessage" : null,
"errorGroup" : null,
"locale" : null,
"systemTime" : 1446650532883,
"conversationId" : null,
"price" : 1.00000000,
"paidPrice" : 1.00000000,
"currency" : TRY,
"installment" : 1,
"paymentId" : "253",
"fraudStatus" : 1,
"merchantCommissionRate" : 0E-8,
"merchantCommissionRateAmount" : 0E-8,
"iyziCommissionRateAmount" : 0.02500000,
"iyziCommissionFee" : 0.25000000,
"cardType" : "CREDIT_CARD",
"cardAssociation" : "MASTER_CARD",
"cardFamily" : "Paraf",
"cardToken" : null,
"cardUserKey" : null,
"binNumber" : "552879",
"basketId" : "B67832",
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com "itemTransactions" : [ {
"itemId" : "BI101",
"paymentTransactionId" : "53",
"transactionStatus" : 2,
"price" : 0.30000000,
"paidPrice" : 0.30000000,
"merchantCommissionRate" : 0E-8,
"merchantCommissionRateAmount" : 0E-8,
"iyziCommissionRateAmount" : 0.00750000,
"iyziCommissionFee" : 0.07500000,
"blockageRate" : 10.00000000,
"blockageRateAmountMerchant" : 0.03000000,
"blockageRateAmountSubMerchant" : 0E-8,
"blockageResolvedDate" : "2015-11-19 17:20:43",
"subMerchantKey" : null,
"subMerchantPrice" : 0E-8,
"subMerchantPayoutRate" : 0E-8,
"subMerchantPayoutAmount" : 0E-8,
"merchantPayoutAmount" : 0.18750000
}, {
"itemId" : "BI102",
"paymentTransactionId" : "54",
"transactionStatus" : 2,
"price" : 0.50000000,
"paidPrice" : 0.50000000,
"merchantCommissionRate" : 0E-8,
"merchantCommissionRateAmount" : 0E-8,
"iyziCommissionRateAmount" : 0.01250000,
"iyziCommissionFee" : 0.12500000,
"blockageRate" : 10.00000000,
"blockageRateAmountMerchant" : 0.05000000,
"blockageRateAmountSubMerchant" : 0E-8,
"blockageResolvedDate" : "2015-11-19 17:20:43",
"subMerchantKey" : null,
"subMerchantPrice" : 0E-8,
"subMerchantPayoutRate" : 0E-8,
"subMerchantPayoutAmount" : 0E-8,
"merchantPayoutAmount" : 0.31250000
}, {
"itemId" : "BI103",
"paymentTransactionId" : "55",
"transactionStatus" : 2,
"price" : 0.20000000,
"paidPrice" : 0.20000000,
"merchantCommissionRate" : 0E-8,
"merchantCommissionRateAmount" : 0E-8,
"iyziCommissionRateAmount" : 0.00500000,
"iyziCommissionFee" : 0.05000000,
"blockageRate" : 10.00000000,
"blockageRateAmountMerchant" : 0.02000000,
"blockageRateAmountSubMerchant" : 0E-8,
"blockageResolvedDate" : "2015-11-19 17:20:43",
"subMerchantKey" : null,
"subMerchantPrice" : 0E-8,
"subMerchantPayoutRate" : 0E-8,
"subMerchantPayoutAmount" : 0E-8,
"merchantPayoutAmount" : 0.12500000
iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com } ],
"token" : "f49dec04-729a-41f3-83aa-df790e90ce34",
"callbackUrl" : "https://www.merchant.com/callback",
"paymentStatus" : "SUCCESS"
}
2.5 İptal
İyzico üzerinden tahsil edilen bir ödeme, banka kuralları gereği aynı gün içinde (gün sonu yapılmadan) iptal (cancel) edilebilir. İptal işleminin iadeden farkı, ödeme ile aynı gün yapılabilmesi ve kart ekstresinde girdi/çıktı yaratmamasıdır. İptal yapılabilmesi için ödemeye ait id (paymentId) gönderilmesi gerekir, iptal işlemi başarılıysa iptal edilen tutar (price) servisten döner. İptal işlemi tepeden çalışır, yani ödemenin tamamını iptal eder. • API Servis (Endpoint) İsmi: /payment/iyzipos/cancel • Method: HTTP POST Örnek Java İstek Çıktısı EcomPaymentServiceClient client = new EcomPaymentServiceClientImpl(configuration); PaymentCancelRequest request = new PaymentCancelRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentId("3031"); request.setIp("85.34.78.112"); PaymentCancelResponse response = client.cancel(request); System.out.println("conversationId=" + response.getConversationId()); System.out.println("locale=" + response.getLocale()); System.out.println("status=" + response.getStatus()); System.out.println("errorCode=" + response.getErrorCode()); System.out.println("errorMessage=" + response.getErrorMessage()); System.out.println("errorGroup=" + response.getErrorGroup()); System.out.println("systemTime=" + response.getSystemTime()); System.out.println("paymentId=" + response.getPaymentId()); System.out.println("price=" + response.getPrice()); iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com Örnek Java Sonuç Çıktısı conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1445239960166 paymentId=3031 price=1.10000000 Örnek Java İstek Koduna Ait JSON Çıktısı { "locale" : "tr", "conversationId" : "123456789", "paymentId" : "3031", "ip" : "85.34.78.112" } Örnek Java Sonuç Koduna Ait JSON Çıktısı { "status" : "success", "locale" : "tr", "systemTime" : 1445239960166, "conversationId" : "123456789", "paymentId" : "3031", "price" : 1.10000000 } 2.6 İade
İyzico üzerinden tahsil edilen bir ödeme, 365 gün 7/24 iade (refund) edilebilir. İade işlemi mutlaka ekstreye yansır ve iade edilen ödeme taksitli bir işlemse, iadenin karta yansıması bankadan bankaya iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com değişmekle beraber bir kaç günü bulabilir. İade işlemi kırılımdan çalışır, yani ödemenin bir kırlımının tamamını veya bir kısmını iade eder. İade yapılabilmesi için ödeme kırılımına ait id (paymentTransactionId) ve iade edilecek tutar (price) gönderilmesi gerekir, iade işlemi başarılıysa iade edilen tutar (price) servisten döner. İade edilecek tutar (price), iade edilecek ödemenin kırılımının tutarından (itemTransaction à paidPrice) ve iade edilebilir kalan tutardan küçük veya eşit olmalıdır. Bu kural sağlandığı sürece ardarda defalarca iade yapılabilir. • API Servis (Endpoint) İsmi: /payment/iyzipos/refund • Method: HTTP POST Örnek Java İstek Çıktısı EcomPaymentServiceClient client = new EcomPaymentServiceClientImpl(configuration); PaymentRefundRequest request = new PaymentRefundRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentTransactionId("1543"); request.setPrice(new BigDecimal("3.3")); request.setCurrency("TRY"); request.setIp("85.34.78.112"); PaymentRefundResponse response = client.refund(request); System.out.println("conversationId=" + response.getConversationId()); System.out.println("locale=" + response.getLocale()); System.out.println("status=" + response.getStatus()); System.out.println("errorCode=" + response.getErrorCode()); System.out.println("errorMessage=" + response.getErrorMessage()); System.out.println("errorGroup=" + response.getErrorGroup()); System.out.println("systemTime=" + response.getSystemTime()); System.out.println("paymentId=" + response.getPaymentId()); System.out.println("paymentTransactionId=" + response.getPaymentTransactionId()); System.out.println("price=" + response.getPrice()); iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com Örnek Java Sonuç Çıktısı conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1445240504793 paymentId=3032 paymentTransactionId=1543 price=3.3 currency=TRY Örnek Java İstek Koduna Ait JSON Çıktısı { "locale" : "tr", "conversationId" : "123456789", "paymentTransactionId" : "1543", "price" : 3.3, "currency" : TRY, "ip" : "85.34.78.112" } Örnek Java Sonuç Koduna Ait JSON Çıktısı { "status" : "success", "locale" : "tr", "systemTime" : 1445240504793, "conversationId" : "123456789", "paymentId" : "3032", "paymentTransactionId" : "1543", "price" : 3.3, "currency" : TRY } iyzico Ödeme Hizmetleri A.Ş. Nidakule Göztepe İş Merkezi Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız 70/73 Kadıköy 34732 Telefon:+90 216 599 01 00 E-­mail: [email protected] Web: www.iyzico.com