iyzico API Dokümantasyonu
Transkript
iyzico API Dokümantasyonu
iyzicoAPIDokümantasyonu Yazarlar: HakanERDOĞAN SabriOnurTÜ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şiklikTarihçesi Tarih Yazar Versiyon Gerekçe 28/09/15 HakanERDOGAN, SabriOnurTüzün 1.0 İlktaslakdöküman 02/05/16 SabriOnurTüzün 1.1 Önotorizasyon&Sonotorizasyondesteği 31/05/16 EmreFındık 1.2 Sandbox/Testvenode.jsileilgilibilgilerineklenmesi . 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 İçindekiler iyzicoAPIDokümantasyonu.......................................................................................................................................1 1 Başlarken................................................................................................................................................................4 2 APIServisleri..........................................................................................................................................................5 2.1 APIServisleri,Ortakİstek(Request)veSonuç(Response)Alanları......................................................................6 3 PazaryeriÇözümü.................................................................................................................................................8 3.1 AlıcıveSatıcıSözleşmeleri...........................................................................................................................................9 3.1.1 Alternatif-1:ÜyelikSırasındaSözleşmeOnaylatma...............................................................................................10 3.1.2 Alternatif-2:ÜrünListelemeyadaÜrünÖdemeSayfasındaKayıt...................................................................10 3.2 AltÜyeİşyeriKaydı....................................................................................................................................................11 3.2.1 YeniAltÜyeİşyeriEkleme..................................................................................................................................................11 3.2.2 AltÜyeİşyeriGüncelleme...................................................................................................................................................19 3.3 Tahsilat.........................................................................................................................................................................22 3.3.1 Ödeme........................................................................................................................................................................................22 3.3.2 İptal..............................................................................................................................................................................................69 3.3.3 İade..............................................................................................................................................................................................71 3.3.4 ÖnOtorizasyon........................................................................................................................................................................74 3.3.5 SonOtorizasyon......................................................................................................................................................................83 3.4 ParaTransferiİçinÜrüneOnayVerme...................................................................................................................89 3.4.1 ÜrüneOnayVerme................................................................................................................................................................90 3.4.2 VerilenOnayıGeriÇekme...................................................................................................................................................91 . 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 Lisanslıbirödemekuruluşuolaniyzico,6493sayılıÖdemeveMenkulKıymetMutabakatSistemleri,Ödeme HizmetleriveElektronikParaKuruluşlarıHakkındaKanunu’nauyumluvehemstandarte-ticarethemde pazaryerlerininihtiyaçlarınıkarşılayanbirürünsunmaktadır.Kanunkapsamındaparatoplama(collection) vedağıtma(settlement)yetkisiÖdemeKuruluşlarıtarafındanyapılmasıgerekmektedir. iyzicoödemeAPI’si,internetüzerindenödemekabuledentümüyeişyerlerinehitapedecekbirşekilde, oturumbilgisitutmayan(stateless)Restfulservisodaklıbirmimaridegeliştirilmiştir. İletişim,şifreleme(PKI:publickeyinfrastructure),verisarmalama(datamarshalling)veveriçözme(data unmarshalling)içinmutlakabirAPIistemcisi(client)kullanmakgerekir. İyzico; • Java • .Net • PHP • RubyonRails(RoR) • Phyton • Node.js dillerindeyazılmışAPIistemcilerisunar.ÜyeişyerikendiprogramlamadilinegöreuygunAPIistemcisini seçmelidir. İyzicoAPIentegrasyonuiçintemelde3bilgiyeihtiyaçvardır: • APIBaseURL :Ortam(sandbox)bazlıAPIservisanalinkidir.Örnek:https://sandbox- api.iyzipay.com • APIKey :ÜyeişyeriaçıkAPIanahtarıdır.Buanahtariyzicosandboxileiletişimdekullanılır fakatkimseylepaylaşılmaz.Örnek:sandbox-Txl2ctiktW6BrNmFo10pZiPn8W67Ksob • SecretKey:ÜyeişyerigizliAPIgüvenlikanahtarıdır.Buanahtariyzicosandboxileiletişimde kullanılmazvekimseylepaylaşılmaz.Örnek:sandbox-GdzIHrXly6gqDmXGcQl . 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 İyzicoAPIentegrasyonu,ilkolarakSandboxtestortamındayapılmalıdır. İyzicoAPI;hempazaryerihemdepazaryeriolmayanstandarte-ticaretfirmalarınınentegrasyonuiçin kullanılabilir.Pazaryeriolmayanstandarte-ticaretfirmalarıAPIServisleribaşlığındabelirtilenmavirenkli servislerikullanmalıdırlar. 2 APIServisleri İyzicoAPI;aşağıdakiservislerdenoluşmaktadır.ÜyeişyeriilepaylaşılanAPIistemcisibuAPIservislerine istektebulunmaktaveverialışverişini,şifrelemeyivegüvenliğiüyeişyeriadınabasitçehalletmektedir. AşağıdakitablodaiyzicoAPIservislistesibulunmaktadır.Butablodakırmızırenklebelirtilenservisler sadecePazaryeri/MarketplacesÇözümüiçingeçerlidir,pazaryeriolmayane-ticaretfirmalarıkırmızırenkle belirtilenservislerigözönündebulundurmayıp,mavirenklebelirtilendiğerservislerikullanmalıdırlar. . 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 # APIServis(Endpoint)İsmi 1 YeniAltÜyeİşyeriEklemeServisi 2 AltÜyeİşyeriGüncellemeServisi 3 Ödeme(Auth)Servisi 3DSecureÖdeme(initialize3DS)Başlatma 4 Servisi 5 3DSecureÖdeme(Auth3DS)Servisi 6 ÖnOtorizasyon(PreAuth)Servisi 7 SonOtorizasyon(PostAuth=Capture)Servisi 8 İptal(Cancel)Servisi 9 İade(Refund)Servisi İade(Refund)Servisi-İadeyiÜyeİşyerinin 10 Üstlendiği ParaTransferiİçinÜrüneOnayVerme 11 Servisi ParaTransferiİçinÜrüneVerilenOnayıGeri 12 ÇekmeServisi Mahsuplaşma-AltÜyeİşyerinePara 13 GöndermeServisi Mahsuplaşma-AltÜyeİşyerindenPara 14 AlmaServisi 15 ServisAyaktamıTesti(Healthcheck) 16 BINKontrolServisi 17 TaksitMatrisi(Installment)Servisi 18 ÖdemedenBağımsızKartEklemeServisi 19 ÖdemedenBağımsızKartSilmeServisi ÖdemedenBağımsızKartBilgileriniÇekme 20 Servisi 21 ParasıTransferiYapılanİşlemlerServisi ParaTransferiBankadanGeriDönenler 22 Servisi APIServis(Endpoint)URL /onboarding/submerchant /onboarding/submerchant /payment/iyzipos/auth/ecom /payment/iyzipos/initialize3ds/ecom /payment/iyzipos/auth3ds/ecom /payment/iyzipos/preauth/ecom /payment/iyzipos/postauth /payment/iyzipos/cancel /payment/iyzipos/refund /payment/iyzipos/refund/merchant/charge /payment/iyzipos/item/approve /payment/iyzipos/item/disapprove /crossbooking/send /crossbooking/receive /payment/test /payment/bin/check /payment/iyzipos/installment /cardstorage/card /cardstorage/card /cardstorage/cards /reporting/settlement/payoutcompleted /reporting/settlement/bounced Method POST PUT POST POST POST POST POST POST POST POST POST POST POST POST GET POST POST POST DELETE POST POST POST 2.1 APIServisleri,Ortakİstek(Request)veSonuç(Response)Alanları APIservislerinemutlakaiyzicoistemcileri(client)ileerişimsağlanmasıgerekmektedir,ziraiyzico istemcilerisizinadınızayetkilendirmeveverigönderipalmayıkolaylaştırı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 Yapılantümservisisteklerinde; • RequestHeader’ıniçindeAuthorizationvex-iyzi-rndparametreleribulunmalıdır.İyzico istemcileribunusizinadınızahalleder. • Aşağıdakiistekparametreleriopsiyonelolarakgönderilebilir: Veri Tipi Zorunlu locale String Hayır conversationId String Hayır Input İsmi Açıklama 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ğıdakisonuçparametreleridönülür.Sonuç(status)başarılı(success)iseyapılanisteğeözel diğeralanlardolugelecektir: Output İsmi Veri Tipi status errorCode String String errorMessage errorGroup String String locale conversationId systemTime String String 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 3 PazaryeriÇözümü iyzicopazaryeriçözümünüdetaylıanlayabilmekiçinklasikbirpazaryerininakışıaşağıdagösterilmiştir,bu örneğegörepazaryerialtındasatışyapan3adetAltÜyeİşyeri(=satıcı=submerchant)olsun.Bualtüye işyerleribireysel(C2C),şahısşirketi(b2C)veyatüzelkişilik(B2C)olabilirler. Biralıcı100TL’likbirsepetoluşturup3farklısatıcıdan,örneğin • Asatıcısından30TL’lik, • Bsatıcısından50TL’likve • Csatıcısından20TL’lik 3farklıürünalabilir. Bilindiğiüzereescrowürünbazındadır,herürününsatıcısıfarklıolabileceğiiçinsepetteyeralanherbir ürünündurumudafarklılıkgösterebilir.ÖrneğinAsatıcısıürünükargolamış,alıcınınelineulaşmışveürüne onayverilmişolabilir,Bsatıcısınınürünüiadeedilmiş/işlemiptaledilmiş,Csatıcısınınürünüisehenüzkargo yapılmaküzerebekliyorolabilir. . 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 iyzico;satıcıvealıcıarasındakiescrow’amüdahilolmaz,ödemenintahsilatınaaracılıkedervesepettekiilgili ürüniçinüyeişyerindenparatransferineonayverilmesinibekler,busürezarfındaalıcınınparasıbankada korumalıhavuzhesaptabeklemektedir. iyzicoPazaryeriÇözümügenelolarakparatoplama(collection)vedağıtma(settlement)süreçlerinin kapsamaktadırveentegrasyonda3anaadımbulunmaktadır.Adımlarsırasıylaşuşekildedir: • AltÜyeİşyeriKaydı • Ödeme • ParaTransferiİçinÜrüneOnayVerme Paratransferininsatıcılara(altüyeişyerlerine)yapılabilmesiiçinbusatıcılarıniyzico’yatekseferlikkaydının yapılmasıgerekir,budaonboardingAPIilesağlanır.Üyeişyerisatıcıyıiyzico’yakaydettiğianda,istek dönüşündeosatıcıiçinsubMerchanKeyalır.Ödemeesnasındadasepettekiherbirürününsatıcısıiçinilgili subMerchantKeyvebuişlemdesatıcıyakaçparagönderilecek(subMerchantPrice)iletilmelidir.Satıcıve alıcıarasındaescrowtamamlanıncadaparatransferiiçinürüneonayverilmelidir. Entegrasyonageçmedenöncemutlakaalıcıvesatıcılarıniyzicosözleşmesinikabuletmesigerekmektedir. 3.1 AlıcıveSatıcıSözleşmeleri Pazaryerinizdeödemeakışıiyzicotarafındankontroledileceğiiçin;birkereyemahsusolmaküzere alıcılarınızınvesatıcılarınızıniyzicosözleşmelerinionaylamalarıgerekmektedir.Bununiçin: • Alıcılarınızın,https://www.iyzico.com/pazaryeri-alici-anlasma/sayfasındaki, • Satıcılarınızındahttps://www.iyzico.com/pazaryeri-satici-anlasma/sayfasındakiiyzico sözleşmesinitekseferlikvedijitalolarakonaylamalarınısağlamalısınız. Üyelerinizewebsitenizüzerindeniyzicohizmetşartlarınıikiayrışekildeonaylatabilirsiniz. • Üyeliksırasında • Ürünlistelemeyadaürünödemesayfasında Herbirüyeniziçinbuişlemtekbirdefayamahsustur.iyzicohizmetşartlarınıbiröncekilistelemesinde yadaürünödemesindekabuletmişolanüyenizin,sonrakilistelemeyadaödemeaşamalarında sözleşmeyitekrardanonaylamasıgerekmeyecektir. . 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 3.1.1 Alternatif-1:ÜyelikSırasındaSözleşmeOnaylatma Websitenizdekiüyelikformununaltına‘’iyzicoPlatformKullanımSözleşmesi’’ni https://www.iyzico.com/pazaryeri-anlasmalinkindeniframeileçekebilirvepazaryerinizeüyeolmak isteyenkişilerinaynızamandaiyzico’yadaotomatikolarakkayıtolmalarınısağlayabilirsiniz. 3.1.2 Alternatif-2:ÜrünListelemeyadaÜrünÖdemeSayfasındaKayıt Bualternatifikullanarakayrıayrıyönlendirmelerlesatıcıvealıcılarınızıniyzicohizmetşartlarını onaylamasını,dolayısıylabireriyzicoüyeliklerininolmasınısağlayabilirsiniz. 3.1.2.1 Satıcılarınıziçiniyzicokaydı: . 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 Websitenizüzerindenürünsatmakisteyensatıcıüyenize,ürünlistelemebölümlerininherhangi biraşamasındahttps://www.iyzico.com/pazaryeri-anlasmalinkindeniyzicohizmetşartlarını iframeileçekebilirvesatıcılarınızaonaylatabilirsiniz. 3.1.2.2 Alıcılarınıziçiniyzicokaydı: Alıcılarınızdaalmakistedikleriürüniçinödemeyapacaklarısayfadatekseferemahsus,aynı şekildeiyzicohizmetşartlarınıkabulederek;ürünüteslimalıponayverenekadarparalarının güvenlibirşekildeiyzicohavuzhesabındabekletileceğinikabuletmelidir. 3.2 AltÜyeİşyeriKaydı Pazaryeriçözümündeişlemonaylandıktansonrasatıcılaraparatransferiyapılabilmesiiçinbusatıcıların iyzico’dakaydınınbulunmasıgerekir.Pazaryeri;zatenbusatıcıbilgilerinesahipolduğuiçin,iyzico OnboardingAPI’sinesatıcıbilgilerinigönderereksatıcıkaydınıoluşturduktansonrabubilgileriçekip güncelleyebilir. 3.2.1 YeniAltÜyeİşyeriEkleme Pazaryerialtındakialtüyeişyerleri3tipteolabilirler:bireysel,şahısşirketiveyalimited/anonim şirket.Hertipiçinaltüyeişyerikaydındagönderilenparametrelerfarklılıkgöstermektedir.Altüye işyerikaydıyapıldığındaresponsealanındadönensubMerchantKey,osatıcıiçintekildeğerdir,bu . 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ğerisisteminizdesaklamalısınız,ödemeesnasındasatıcıyıbelirtmekiçinsubMerchantKey’i göndermenizgerekecektir. Not:iyzico’yailetilentümparametrelergerçekdeğerleriiçerecekşekildeiletilmelidir,rastgele,test veyagerçekolmayanbilgileriletilmemelidir. 3.2.1.1 BireyselAltÜyeİşyeriEkleme Pazaryerisatıcınızeğerbireyselise(C2C)aşağıdakiinputparametrelerinigönderipbireysel satıcılarınızıniyzico’yakaydınısağlayabilirsiniz. • APIServis(Endpoint)İsmi:/onboarding/submerchant • Method:HTTPPOST Veri Tipi Zorunlu Açıklama name gsmNumber contactName contactSurname email address String String String String String String Hayır Hayır Evet Evet Evet Evet iban subMerchantExternalId String String Hayır ** Evet identityNumber subMerchantType String String Hayır ** Evet Alt üye işyeri adı Alt üye işyeri telefon numarası Alt üye işyeri sahibinin adı. IBAN ile uyumlu olmalı Alt üye işyeri sahibinin soyadı. IBAN ile uyumlu olmalı Alt üye işyeri e-posta adresi Alt üye işyeri adresi Alt üye işyeri IBAN bilgisi. contactName ve contactSurname ile belirtilecek ad soyada ait bir IBAN olmalı. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Alt üye işyeri tekil dış ID’si, sizin sisteminizdeki ID olabilir Alt üye işyeri T.C. kimlik numarası. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Bireysel için PERSONAL enum değeri gönderilmeli Input İsmi İsteksonucudönendeğerleraşağıdakigibidir: Output İsmi subMerchantKey Veri Tipi Açıklama String Alt üye işyerini simgeleyen tekil değer. Örnek Java İstek Kodu: ClientConfigurationconfiguration=newClientConfiguration(); configuration.setApiKey("apikey"); configuration.setSecretKey("secretkey"); . 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 configuration.setBaseUrl("https://sandbox-apiiyzipay.com"); OnboardingServiceClientclient=newOnboardingServiceClientImpl(configuration); CreateSubMerchantRequestrequest=newCreateSubMerchantRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setSubMerchantExternalId("B49220"); request.setSubMerchantType(SubMerchantRequestType.PERSONAL.name()); request.setAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız 70/73GöztepeKadıköy34732"); request.setContactName("SabriOnur"); request.setContactSurname("Tüzün"); request.setEmail("[email protected]"); request.setGsmNumber("+905350000000"); request.setName("SabriOnur'unmağazası"); request.setIban("TR180006200119000006672315"); request.setIdentityNumber("31300864726"); CreateSubMerchantResponseresponse=client.createSubMerchant(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("subMerchantKey="+response.getSubMerchantKey()); Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1443687828497 subMerchantKey=l4FCFycIof0paTP6687dOoch9Po= . 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 İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "name":"SabriOnur'unmağazası", "email":"[email protected]", "gsmNumber":"+905350000000", "address":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız70/73 GöztepeKadıköy34732", "iban":"TR180006200119000006672315", "contactName":"SabriOnur", "contactSurname":"Tüzün", "subMerchantExternalId":"B49221", "identityNumber":"31300864726", "subMerchantType":"PERSONAL" } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1443687828497, "conversationId":"123456789", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=" } 3.2.1.2 ŞahısŞirketiAltÜyeİşyeriEkleme PazaryerisatıcınızeğerŞahısŞirketiiseaşağıdakiinputparametrelerinigönderipŞahısŞirketi satıcılarınızıniyzico’yakaydınısağlayabilirsiniz. • APIServis(Endpoint)İsmi:/onboarding/submerchant • Method:HTTPPOST Input İsmi name Veri Tipi Zorunlu Açıklama String Hayır Alt üye işyeri adı . 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 gsmNumber taxOffice legalCompanyTitle email address String String String String String Hayır Evet Evet Evet Evet iban subMerchantExternalId String String Hayır ** Evet identityNumber subMerchantType String String Hayır ** Evet Alt üye işyeri telefon numarası Alt üye işyeri vergi dairesi Alt üye işyeri yasal şirket ünvanı Alt üye işyeri e-posta adresi Alt üye işyeri adresi Alt üye işyeri IBAN bilgisi. legalCompanyTitle ile uyumlu bir IBAN olmalı. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Alt üye işyeri tekil dış ID’si, sizin sisteminizdeki ID olabilir Alt üye işyeri T.C. kimlik numarası. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Şahıs Şirketi için PRIVATE_COMPANY enum değeri gönderilmeli İsteksonucudönendeğerleraşağıdakigibidir: Output İsmi subMerchantKey Veri Tipi Açıklama String Alt üye işyerini simgeleyen tekil değer. Örnek Java İstek Kodu: ClientConfigurationconfiguration=newClientConfiguration(); configuration.setApiKey("apikey"); configuration.setSecretKey("secretkey"); configuration.setBaseUrl("https://sandbox-apiiyzipay.com"); OnboardingServiceClientclient=newOnboardingServiceClientImpl(configuration); CreateSubMerchantRequestrequest=newCreateSubMerchantRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setSubMerchantExternalId("S49221"); request.setSubMerchantType(SubMerchantRequestType.PRIVATE_COMPANY.name()); request.setAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız 70/73GöztepeKadıköy34732"); request.setTaxOffice("KadıköyV.D."); request.setLegalCompanyTitle("SabriOnurTüzünBilişimHizmetleri"); request.setEmail("[email protected]"); request.setGsmNumber("+905350000000"); request.setName("SabriOnur'unmağazası"); request.setIban("TR180006200119000006672315"); request.setIdentityNumber("31300864726"); CreateSubMerchantResponseresponse=client.createSubMerchant(request); . 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("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("subMerchantKey="+response.getSubMerchantKey()); Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1443788792146 subMerchantKey=lcB6bA9DWEF5e8yGJI0uIEcW1kw= Örnek Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "name":"SabriOnur'unmağazası", "email":"[email protected]", "gsmNumber":"+905350000000", "address":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız70/73 GöztepeKadıköy34732", "iban":"TR180006200119000006672315", "taxOffice":"KadıköyV.D.", "legalCompanyTitle":"SabriOnurTüzünBilişimHizmetleri", "subMerchantExternalId":"S49221", "identityNumber":"31300864726", "subMerchantType":"PRIVATE_COMPANY" } . 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ç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1443788792146, "conversationId":"123456789", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=" } 3.2.1.3 LimitedveyaAnonimŞirketAltÜyeİşyeriEkleme PazaryerisatıcınızeğerLimitedveyaAnonimŞirketiseaşağıdakiinputparametrelerinigönderip LimitedveyaAnonimŞirketsatıcılarınızıniyzico’yakaydınısağlayabilirsiniz. • APIServis(Endpoint)İsmi:/onboarding/submerchant • Method:HTTPPOST Veri Tipi Zorunlu Açıklama name gsmNumber taxOffice taxNumber legalCompanyTitle email address String String String String String String String Hayır Hayır Evet Evet Evet Evet Evet iban subMerchantExternalId String String Hayır ** Evet subMerchantType String Evet Alt üye işyeri adı Alt üye işyeri telefon numarası Alt üye işyeri vergi dairesi Alt üye işyeri vergi numarası Alt üye işyeri yasal şirket ünvanı Alt üye işyeri e-posta adresi Alt üye işyeri adresi Alt üye işyeri IBAN bilgisi. legalCompanyTitle ile uyumlu bir IBAN olmalı. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Alt üye işyeri tekil dış ID’si, sizin sisteminizdeki ID olabilir Şahıs Şirketi için LIMITED_OR_JOINT_STOCK_COMPANY enum değeri gönderilmeli Input İsmi İsteksonucudönendeğerleraşağıdakigibidir: Output İsmi subMerchantKey Veri Tipi Açıklama String Alt üye işyerini simgeleyen tekil değer. Örnek Java İstek Kodu: ClientConfigurationconfiguration=newClientConfiguration(); . 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 configuration.setApiKey("apikey"); configuration.setSecretKey("secretkey"); configuration.setBaseUrl("https://sandbox-apiiyzipay.com"); OnboardingServiceClientclient=newOnboardingServiceClientImpl(configuration); CreateSubMerchantRequestrequest=newCreateSubMerchantRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setSubMerchantExternalId("AS49222"); request.setSubMerchantType(SubMerchantRequestType.LIMITED_OR_JOINT_STOCK_COMPANY.na me()); request.setAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız 70/73GöztepeKadıköy34732"); request.setTaxOffice("KadıköyV.D."); request.setTaxNumber("9261877"); request.setLegalCompanyTitle("XYZBilişimHizmetleriA.Ş."); request.setEmail("[email protected]"); request.setGsmNumber("+905350000000"); request.setName("SabriOnur'unmağazası"); request.setIban("TR180006200119000006672315"); CreateSubMerchantResponseresponse=client.createSubMerchant(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("subMerchantKey="+response.getSubMerchantKey()); Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr 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=1443790256853 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= Örnek Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "name":"SabriOnur'unmağazası", "email":"[email protected]", "gsmNumber":"+905350000000", "address":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız70/73 GöztepeKadıköy34732", "iban":"TR180006200119000006672315", "taxOffice":"KadıköyV.D.", "legalCompanyTitle":"XYZBilişimHizmetleriA.Ş.", "subMerchantExternalId":"AS49222", "taxNumber":"9261877", "subMerchantType":"LIMITED_OR_JOINT_STOCK_COMPANY" } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1443790256853, "conversationId":"123456789", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=" } 3.2.2 AltÜyeİşyeriGüncelleme İyzico’yatekseferlikkaydınıgerçekleştirdiğinizaltüyeişyerlerini,altüyeişyerieklemebölümünde bahsedilenparametrelerigöndererekgüncelleyebilirsiniz. Not1:Altüyeişyerigüncellemeiçin,güncellemekistediğinizaltüyeişyerineaitsubMerchantKey gönderilmesigerekmektedir. . 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 Not2:AltüyeişyerigüncellenirkengeçerliformattaIBANbilgisigönderilmesizorunludur Not3:Altüyeişyeritipigüncellenemez,eğerBireyselolanbiraltüyeişyeriniz,ŞahısŞirketiveya Limited/A.Ş.şirketinedönüşüyorsa,herbirtipiçinyenibiraltüyeişyeriekleyip,ilgili subMerchantKey’lerisaklamalısınız. AşağıdasadeceBireyselaltüyeişyerigüncellemeörneğiverilmiştir,ŞahısŞirketiveLimited/A.Ş.alt üyeişyerleriiçingüncellemeisteklerialtüyeişyerieklemedekiparametrelerikullanacakşekilde benzerdir. • APIServis(Endpoint)İsmi:/onboarding/submerchant • Method:HTTPPUT Veri Tipi Zorunlu subMerchantKey String Evet iban name gsmNumber contactName contactSurname email address String String String String String String String Evet Hayır Hayır Evet Evet Evet Evet identityNumber subMerchantType String String Hayır ** Evet Input İsmi Açıklama iyzico tarafından, alt üye işyeri ekleme sonucunda dönen alt üye işyeri tekil anahtarı Alt üye işyeri IBAN bilgisi. contactName ve contactSurname ile belirtilecek ad soyada ait bir IBAN olmalı. Alt üye işyeri adı Alt üye işyeri telefon numarası Alt üye işyeri sahibinin adı. IBAN ile uyumlu olmalı Alt üye işyeri sahibinin soyadı. IBAN ile uyumlu olmalı Alt üye işyeri e-posta adresi Alt üye işyeri adresi Alt üye işyeri T.C. kimlik numarası. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır Bireysel için PERSONAL enum değeri gönderilmeli İsteksonucudönendeğerler;3.1maddesindebahsedilengenelAPIdönüşdeğerleridir. Örnek Java İstek Kodu: ClientConfigurationconfiguration=newClientConfiguration(); configuration.setApiKey("apikey"); configuration.setSecretKey("secretkey"); configuration.setBaseUrl("https://sandbox-apiiyzipay.com"); OnboardingServiceClientclient=newOnboardingServiceClientImpl(configuration); UpdateSubMerchantRequestrequest=newUpdateSubMerchantRequest(); . 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 request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setSubMerchantKey("l4FCFycIof0paTP6687dOoch9Po="); request.setIban("TR630006200027700006678204"); request.setAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız 70/73GöztepeKadıköy34732"); request.setContactName("Hakan"); request.setContactSurname("Erdoğan"); request.setEmail("[email protected]"); request.setGsmNumber("+905350000000"); request.setName("HakanErdoğan'ınmağazası"); request.setIdentityNumber("31300864726"); UpdateSubMerchantResponseresponse=client.updateSubMerchant(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()); Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444129731762 Örnek Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "name":"HakanErdoğan'ınmağazası", "email":"[email protected]", "gsmNumber":"+905350000000", . 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 "address":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19Bağımsız70/73 GöztepeKadıköy34732", "iban":"TR630006200027700006678204", "contactName":"Hakan", "contactSurname":"Erdoğan", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "identityNumber":"31300864726" } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1444129731762, "conversationId":"123456789" } 3.3 Tahsilat Üyeişyeri;isterpazaryeriistersestandarte-ticaretişmodelindeolsunaşağıdakiödeme(3DSecureve 3DSecureolmayan),iptal,iade,önotorizasyonvbişlemleriyapabilir. 3.3.1 Ödeme Üyeişyeri,kendiveyaalıcıtercihinegöre3DSecureveya3DSecureolmayanödemealabilir.3D Secureolmayanödemebasitbiristek/sonuçevresinde(request/responsecycle)sonuçlanır. 3.3.1.1 ÖdemeGrupları,ÜrünTipleriveTemelÖdemeBilgileri Üyeişyeri;ürün,listelemeveaboneliködemetiplerindeödemealabilir,listelemeveabonelik arasındabirfarkyoktur,ürünödemesiisedetaylarıaşağıdaverileceğeüzerefarklıbirakışa sahiptir: • PRODUCT àÜrün • LISTING àListeleme • SUBSCRIPTION àAbonelik ÖdemesepetindeyeralanürünleriseSanalveyaFizikselürünolabilir: • VIRTUAL . àSanalÜrün 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 • PHYSICAL àFizikselÜrün Sanal(VIRTUAL)tiptekiürünleriçinteslimatadresi(ShippingAddress)gönderilmesiopsiyoneldir. SepetteyeralanürünlerinbirtanesibileFiziksel(PHYSICAL)ürünise,teslimatadresi (ShippingAddress)gönderilmesizorunludur. Pazaryeri/MarketplacesİşModelindeOlanÜyeİşyerleriİçin; • Listeleme(LISTING)veAbonelik(SUBSCRIPTION)tipindekiödemeleriçinsepet kırılımındakiürünlerintipiSanal(VIRTUAL)olmalıdır. • Ürün(PRODUCT)tipindekiödemeleriçinsepetkırılımındakiürünlerintipiSanal(VIRTUAL) veyaFiziksel(PHYSICAL)olabilir. • Ürün(PRODUCT)tipindekiödemeiçin;altüyeişyeritutarı(subMerchantPrice)vealtüye işyerianahtarı(subMerchantKey)gönderilmelidir. • Ürün(PRODUCT)tipindekiödemeleriçinescrowişleyişiuygulanırveüyeişyerindenürüne onayverilinceyedekpara,korumalıhavuzhesaptabeklemedetutulur. • ListelemeveyaAboneliködemesigeçtiktensonraüyeişyeriparatransferperiyodayarına göreilgilitutarlarüyeişyerinegönderilir. • Ürünödemesigeçtiktensonra,üyeişyeriürüneonayverdiktensonra,paratransfer periyodayarınagöreilgilitutarlarüyeişyerinegönderilir Pazaryeri/MarketplacesİşModelindeOlMAyanÜyeİşyerleriİçin; • Listeleme(LISTING)veAbonelik(SUBSCRIPTION)tipindekiödemeleriçinsepet kırılımındakiürünlerintipiSanal(VIRTUAL)olmalıdır. • Ürün(PRODUCT)tipindekiödemeleriçinsepetkırılımındakiürünlerintipiSanal(VIRTUAL) veyaFiziksel(PHYSICAL)olabilir. • Ürün(PRODUCT)tipindekiödemeiçin;altüyeişyeritutarı(subMerchantPrice)vealtüye işyerianahtarı(subMerchantKey)gönderilmez. • Ürün(PRODUCT)tipindekiödemeleriçinescrowişleyişiuygulanmaz • Ürün,ListelemeveyaAboneliködemesigeçtiktensonraüyeişyeriparatransferperiyod ayarınagöreilgilitutarlarüyeişyerinegö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 Örnek–PazaryeriİşModeliÜrünÖdemesi: Biralıcı;100TL’likbirsepetoluşturup3farklısatıcıdan,örneğin § Asatıcısından30TL’lik, § Bsatıcısından50TL’likve § Csatıcısından20TL’lik 3farklıürünalabilir. Üyeişyeri,ödemeesnasındakartbilgileri,adresbilgileri,ödemebilgilerineekolaraktemelde; • sepeteaittutarı(price), • indirimvadefarkıvshesaplanmışPOS’dangeçeceknihaitutarı(paidPrice), • sepettekiherbirürüniçin; o ürünfiyatını(price) o buürüniçinaltüyeişyerinegönderilecektutarı(subMerchantPrice) o altüyeişyerianahtarını(subMerchantKey)iletir Yukarıdakiörneğeistinaden; • ... . 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 • price=100 • paidPrice=110 o basketItem1 § price=30 § subMerchantPrice=27 § subMerchantKey=G2FCFycIof0paTP6687dOoch9Tc= o basketItem2 § price=50 § subMerchantPrice=42 o subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= o basketItem3 • § price=20 § subMerchantPrice=18 § subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= ... Birödemegerçekleştiğindedönüşdeğerlerinde; • ödemeyeistinadenpaymentId, • sepettekiherbirkırılımaistinadenpaymentTransactionIdyeralır. Üyeişyeribuikideğerisistemindesaklamalıdırzira; • paymentId:ödemeiptaliveiyzicoileolaniletişimdekullanılmaktadır • transactionId:ödemekırılımiadesi,ürünonayı,ürünonayiptaliveiyzicoileolan iletişimdekullanılmaktadır 3.3.1.2 ÖdemeİstekveDönüşParametreleriVeriSözlüğü Tümödemeleriçinaşağıdakitablodayeralaninputparametrelerigeçerlidir: Input İsmi price paidPrice currency installment basketId Veri Tipi Zorunlu Açıklama Decimal Decimal Evet Evet String Evet Integer String Evet Hayır Ödeme sepet tutarı. Kırılım tutarlar toplamı sepet tutarına eşit olmalı İndirim vade farkı vs hesaplanmış POS’dan geçecek nihai tutar Ödemenin alınacağı para birimi. Default olarak TRY. Diğer değerler ise USD, EUR, GBP ve IRR. Taksit bilgisi, tek çekim için 1 gönderilmelidir. Geçerli değerler: 1, 2, 3, 6, 9 Ü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 paymentGroup String Hayır cardNumber String Evet ** expireYear String Evet ** expireMonth String Evet ** cvc String Evet ** cardHolderName String Evet ** callbackUrl String Hayır ** Integer Hayır cardAlias String Hayır cardUserKey String Hayır ** cardToken id (Buyer) name (Buyer) surname (Buyer) identityNumber (Buyer) city (Buyer) country (Buyer) String String String String String String String Hayır ** Evet Evet Evet Evet Evet Evet email (Buyer) gsmNumber (Buyer) ip (Buyer) registrationAddress (Buyer) zipCode (Buyer) String String String Evet Hayır Evet String String Evet Hayır registrationDate (Buyer) String Hayır lastLoginDate (Buyer) contactName (BillingAddress) city (BillingAddress) country (BillingAddress) address (BillingAddress) zipCode (BillingAddress) contactName (ShippingAddress) String Hayır String String String String String Evet Evet Evet Evet Hayır String Evet ** String Evet ** String Evet ** registerCard city (ShippingAddress) country (ShippingAddress) . Ö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 Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION Ödemenin alınacağı kart numarası. Eğer saklı kart ile ödeme yapılmıyorsa zorunludur Ödemenin alınacağı kart son kullanma tarihi yılı. Eğer saklı kart ile ödeme yapılmıyorsa zorunludur Ödemenin alınacağı kart son kullanma tarihi ayı. Eğer saklı kart ile ödeme yapılmıyorsa zorunludur Ödemenin alınacağı kartın güvenlik kodu. Eğer saklı kart ile ödeme yapılmıyorsa zorunludur, saklı kartla ödeme yapılırken gönderilirse aynen bankaya iletilir Ödemenin alınacağı kart sahibinin adı soyadı. Eğer saklı kart ile ödeme yapılmıyorsa zorunludur 3D Secure ödeme akışında üye işyerine başarılı ve hatalı sonucu bildirmek üzere alınan URL adresi. Sadece 3D Secure ödemenin init3DS metodunda zorunludur. Ödeme esnasında kartın kaydedilip kaydedilmeyeceğini belirleyen parametre. Varsayılan değeri 0 olup, geçerli değerler 0 ve 1’dir. Ödeme esnasında kartın kaydedildiği durumlarda (registerCard=1), karta verilen rumuzu simgeler Saklı kart ile ödemede zorunlu olup, kart saklandığı esnada dönen kartın sahibine özel kullanıcı anahtarı Saklı kart ile ödemede zorunlu olup, kart saklandığı esnada dönen karta ait anahtar Üye işyeri tarafındaki alıcıya ait id Ü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 Ü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 alıcıya ait posta kodu Üye işyeri tarafındaki alıcıya ait kayıt tarihi. Tarih formatı 2015-09-17 23:45:06 şeklinde olmalıdır Üye işyeri tarafındaki alıcıya ait son giriş tarihi. Tarih formatı 2015-0917 23:45:06 şeklinde olmalıdır Ü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 Üye işyeri tarafındaki teslimat adresi ad soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur Ü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 ü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 address (ShippingAddress) zipCode (ShippingAddress) id (BasketItem) itemType (BasketItem) name (BasketItem) category1 (BasketItem) category2 (BasketItem) price (BasketItem) String Evet ** String String Hayır Evet String String String String Evet Evet Evet Hayır Decimal Evet Decimal Evet ** String Evet ** subMerchantPrice (BasketItem) subMerchantKey (BasketItem) Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur Ü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 Üye işyeri tarafındaki sepetteki ürüne istinaden alt üye işyerine gönderilecek olan tutar. 0’dan küçük ve sepet ürün tutarından [price (BasketItem)] büyük olamaz Pazaryeri iş modeli için geçerli ve zorunludur Üye işyeri tarafındaki sepetteki ürüne istinaden alt üye işyerine ait anahtar. Pazaryeri iş modeli için geçerli ve zorunludur Tümödemeleriçinaşağıdakitablodayeralanoutputparametrelerigeçerlidir: Output İsmi Veri Tipi paymentId price paidPrice String Decimal Decimal installment Integer paymentStatus basketId binNumber cardAssociation String String String String cardFamily String cardType String cardUserKey cardToken fraudStatus iyziCommissionFee iyziCommissionRateAmount merchantCommissionRate String String Integer Decimal Decimal Decimal . Açıklama Ödemeye ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödemenin iptali ve iyzico ile iletişimde kullanılır Ödeme sepet tutarı. Kırılım tutarlar toplamı sepet tutarına eşit olmalı İndirim vade farkı vs hesaplanmış POS’dan geçen, tahsil edilen, nihai tutar Ödemenin taksit bilgisi, tek çekim için 1 döner. Geçerli değerler: 1, 2, 3, 6, 9 İşlemin sonucunu gösterir. SUCCESS, FAILURE, INIT_THREEDS, CALLBACK_THREEDS, BKM_POS_SELECTED, CALLBACK_PECCO Üye işyeri taradından gönderilen sepet id’si Ö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, ... Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu tipi. Geçerli değerler: CREDIT_CARD, DEBIT_CARD, PREPAID_CARD Eğer ödeme esnasında kartı kaydetme parametresi (registerCard=1) gönderilmişse veya saklı bir kart ile ödeme yapılıyorsa, o kartın sahibine özel kullanıcı anahtarı Kart saklandığı esnada dönen karta ait anahtar Ö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 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 merchantCommissionRateAmount String Ü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 String Üye işyeri tarafından iletilen, sepetteki ürüne ait id Decimal String Ü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. 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. Kırılım bazında üye işyeri blokaj tutarının, alt üye işyerine yansıyan rakamı. İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örneğin 2015-10-19 14:36:52 Decimal iyico işlem ücretinin kırılım bazında dağılmış tutarı Decimal 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ı Üye işyeri tarafındaki sepetteki ürüne istinaden alt üye işyerine ait anahtar. Pazaryeri iş modeli için geçerlidir Üye işyeri tarafındaki sepetteki ürüne istinaden alt üye işyerine gönderilecek olan tutar. Pazaryeri iş modeli için geçerlidir 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. Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra alt üye işyerine gönderilecek tutar. Pazaryeri iş modeli için geçerlidir Bu kırılım için, alt üye işyeri gönderim oranı. Örneğin 50 TL’lik bir ürünün 45 TL’si subMerchantPrice olarak gönderilmişse, bu durumda subMerchantPayoutRate 90 döner, yani %90. Pazaryeri iş modeli için geçerlidir Decimal paymentTransactionId (ItemTransactions) itemId (ItemTransactions) price (ItemTransactions) paidPrice (ItemTransactions) transactionStatus (ItemTransactions) Decimal Integer blockageRate (ItemTransactions) Decimal blockageRateAmountMerchant (ItemTransactions) Decimal blockageRateAmountSubMerchant (ItemTransactions) blockageResolvedDate (ItemTransactions) iyziCommissionFee (ItemTransactions) iyziCommissionRateAmount (ItemTransactions) merchantCommissionRate (ItemTransactions) merchantCommissionRateAmount (ItemTransactions) subMerchantKey (ItemTransactions) subMerchantPrice (ItemTransactions) merchantPayoutAmount (ItemTransactions) subMerchantPayoutAmount (ItemTransactions) Decimal Decimal Decimal String Decimal Decimal Decimal subMerchantPayoutRate (ItemTransactions) Decimal 3.3.1.3 3DSecureOlmayanÖdeme . 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 3.3.1.3.1 Pazaryeri/MarketplacesİşModelindeOlanÜyeİşyerleriİçinÜrünÖdemesi; Aşağıdakiörnekte,3üründenoluşan100TLtutarındabirsepet3taksitli,110TLolaraködeniyor. Sepettekiürünlerdenenaz1tanesifizikselürünolduğuiçinteslimatadresibilgisigönderiliyor. Sepetteyeralanherbirürünfarklıaltüyeişyerineaitvesırasıyla30TL’likürünonaylandığında 27TL’si(üyeişyerisatışkomisyonubuürüniçin%10),50TL’likürünonaylandığında42TL’si(üye işyerisatışkomisyonubuürüniçin%16)ve20TL’likürünonaylandığında18TL’si(üyeişyerisatış komisyonubuürüniçin%10)altüyeişyerinegönderilecektir. • APIServis(Endpoint)İsmi:/payment/iyzipos/auth/ecom • Method:HTTPPOST Örnek Java İstek Kodu: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentAuthRequestrequest=newEcomPaymentAuthRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPrice(newBigDecimal("100")); request.setPaidPrice(newBigDecimal("110")); request.setCurrency("TRY"); request.setInstallment(3); request.setBasketId("B67832"); request.setPaymentChannel(PaymentChannelRequestType.WEB.name()); request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name()); EcomPaymentCardDtopaymentCard=newEcomPaymentCardDto(); paymentCard.setCardHolderName("SabriOnurTüzün"); paymentCard.setCardNumber("554960**********"); paymentCard.setExpireMonth("**"); paymentCard.setExpireYear("20**"); paymentCard.setCvc("***"); paymentCard.setRegisterCard(0); request.setPaymentCard(paymentCard); . 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 EcomPaymentBuyerDtobuyer=newEcomPaymentBuyerDto(); buyer.setId("BY789"); buyer.setName("SabriOnur"); buyer.setSurname("Tüzün"); buyer.setGsmNumber("+905350000000"); buyer.setEmail("[email protected]"); buyer.setIdentityNumber("74300864791"); buyer.setLastLoginDate("2015-10-0512:43:35"); buyer.setRegistrationDate("2013-04-2115:12:09"); buyer.setRegistrationAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy"); buyer.setIp("85.34.78.112"); buyer.setCity("İstanbul"); buyer.setCountry("Türkiye"); buyer.setZipCode("34732"); request.setBuyer(buyer); EcomPaymentShippingAddressDtoshippingAddress=newEcomPaymentShippingAddressDto(); shippingAddress.setContactName("HakanErdoğan"); shippingAddress.setCity("İstanbul"); shippingAddress.setCountry("Türkiye"); shippingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); shippingAddress.setZipCode("34742"); request.setShippingAddress(shippingAddress); EcomPaymentBillingAddressDtobillingAddress=newEcomPaymentBillingAddressDto(); billingAddress.setContactName("HakanErdoğan"); billingAddress.setCity("İstanbul"); billingAddress.setCountry("Türkiye"); billingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); billingAddress.setZipCode("34742"); request.setBillingAddress(billingAddress); List<EcomPaymentBasketItemDto>basketItems=newArrayList<EcomPaymentBasketItemDto>(); EcomPaymentBasketItemDtobasketItem1=newEcomPaymentBasketItemDto(); basketItem1.setId("BI101"); basketItem1.setName("ABCMarkaKolye"); basketItem1.setCategory1("Giyim"); basketItem1.setCategory2("Aksesuar"); basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem1.setPrice(newBigDecimal("30")); basketItem1.setSubMerchantKey("l4FCFycIof0paTP6687dOoch9Po="); basketItem1.setSubMerchantPrice(newBigDecimal("27")); . 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 basketItems.add(basketItem1); EcomPaymentBasketItemDtobasketItem2=newEcomPaymentBasketItemDto(); basketItem2.setId("BI102"); basketItem2.setName("XYZOyunKodu"); basketItem2.setCategory1("Oyun"); basketItem2.setCategory2("OnlineOyunKodları"); basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem2.setPrice(newBigDecimal("50")); basketItem2.setSubMerchantKey("lcB6bA9DWEF5e8yGJI0uIEcW1kw="); basketItem2.setSubMerchantPrice(newBigDecimal("42")); basketItems.add(basketItem2); EcomPaymentBasketItemDtobasketItem3=newEcomPaymentBasketItemDto(); basketItem3.setId("BI103"); basketItem3.setName("EDCMarkaUsb"); basketItem3.setCategory1("Elektronik"); basketItem3.setCategory2("Usb/Cable"); basketItem3.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem3.setPrice(newBigDecimal("20")); basketItem3.setSubMerchantKey("D9V/MqIRitUzA4dutL+nCBvnWfs="); basketItem3.setSubMerchantPrice(newBigDecimal("18")); basketItems.add(basketItem3); request.setBasketItems(basketItems); EcomPaymentAuthResponseresponse=client.auth(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()); 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()); . 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("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(EcomPaymentItemTransactionDtoitemTransaction: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()); } } . 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 Aşağıdakiörnekte,3üründenoluşan100TLtutarındabirsepet3taksitli,110TLolarak ödeniyor. Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444142311338 paymentId=2744 price=100 paidPrice=110 currency=TRY installment=3 basketId=B67832 binNumber=554960 cardAssociation=MASTER_CARD cardFamily=Bonus cardType=CREDIT_CARD cardToken=null cardUserKey=null fraudStatus=1 iyziCommissionFee=0.25000000 iyziCommissionRateAmount=4.51000000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=10 paymentTransactionId=1307 itemId=BI101 paidPrice=33.00000000 price=30 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=2.31000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.07500000 iyziCommissionRateAmount=1.35300000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=3.00000000 merchantPayoutAmount=2.26200000 subMerchantKey=l4FCFycIof0paTP6687dOoch9Po= . 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 subMerchantPayoutAmount=27 subMerchantPayoutRate=90.00000000 subMerchantPrice=27 paymentTransactionId=1308 itemId=BI102 paidPrice=55.00000000 price=50 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=3.85000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.12500000 iyziCommissionRateAmount=2.25500000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=5.00000000 merchantPayoutAmount=6.77000000 subMerchantKey=lcB6bA9DWEF5e8yGJI0uIEcW1kw= subMerchantPayoutAmount=42 subMerchantPayoutRate=84.00000000 subMerchantPrice=42 paymentTransactionId=1309 itemId=BI103 paidPrice=22.00000000 price=20 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=1.54000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.05000000 iyziCommissionRateAmount=0.90200000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=2.00000000 merchantPayoutAmount=1.50800000 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= subMerchantPayoutAmount=18 subMerchantPayoutRate=90.00000000 subMerchantPrice=18 Örnek Java İstek Koduna Ait JSON Çıktısı: . 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 { "locale":"tr", "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentChannel":"WEB", "basketId":"B67832", "paymentGroup":"PRODUCT", "paymentCard":{ "cardHolderName":"SabriOnurTüzün", "cardNumber":“554960**********", "expireYear":“20**", "expireMonth":“**", "cvc":“***", "registerCard":0 }, "buyer":{ "id":"BY789", "name":"SabriOnur", "surname":"Tüzün", "identityNumber":"74300864791", "email":"[email protected]", "gsmNumber":"+905350000000", "registrationDate":"2013-04-2115:12:09", "lastLoginDate":"2015-10-0512:43:35", "registrationAddress":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy", "city":"İstanbul", "country":"Türkiye", "zipCode":"34732", "ip":"85.34.78.112" }, "shippingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "billingAddress":{ . 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 "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "basketItems":[{ "id":"BI101", "price":30, "name":"ABCMarkaKolye", "category1":"Giyim", "category2":"Aksesuar", "itemType":"PHYSICAL", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27 },{ "id":"BI102", "price":50, "name":"XYZOyunKodu", "category1":"Oyun", "category2":"OnlineOyunKodları", "itemType":"VIRTUAL", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42 },{ "id":"BI103", "price":20, "name":"EDCMarkaUsb", "category1":"Elektronik", "category2":"Usb/Cable", "itemType":"PHYSICAL", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18 }] } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1444142311338, . 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 "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentId":"2744", "fraudStatus":1, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":10, "iyziCommissionRateAmount":4.51000000, "iyziCommissionFee":0.25000000, "cardType":"CREDIT_CARD", "cardAssociation":"MASTER_CARD", "cardFamily":"Bonus", "binNumber":"554960", "basketId":"B67832", "itemTransactions":[{ "itemId":"BI101", "paymentTransactionId":"1307", "transactionStatus":1, "price":30, "paidPrice":33.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":3.00000000, "iyziCommissionRateAmount":1.35300000, "iyziCommissionFee":0.07500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":2.31000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":27, "merchantPayoutAmount":2.26200000 },{ "itemId":"BI102", "paymentTransactionId":"1308", "transactionStatus":1, "price":50, "paidPrice":55.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":5.00000000, . 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 "iyziCommissionRateAmount":2.25500000, "iyziCommissionFee":0.12500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":3.85000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42, "subMerchantPayoutRate":84.00000000, "subMerchantPayoutAmount":42, "merchantPayoutAmount":6.77000000 },{ "itemId":"BI103", "paymentTransactionId":"1309", "transactionStatus":1, "price":20, "paidPrice":22.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":2.00000000, "iyziCommissionRateAmount":0.90200000, "iyziCommissionFee":0.05000000, "blockageRate":7.00000000, "blockageRateAmountMerchant":1.54000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":18, "merchantPayoutAmount":1.50800000 }] } 3.3.1.3.2 ListelemeveyaAbonelikÖdemesi(Pazaryeri/MarketplacesvePazaryeriOlmayanİş ModelindekiÜyeİşyerleriİçinAynı); Birüyeişyeriisterpazaryerimodelindeistersestandarte-ticaretmodelindeolsun,dilerse escrow’atabiolmayacaklistelemeveyaaboneliködemeleriyapabilir.Örneğinpazaryerindesatış yapanaltüyeişyerlerininaylıkmağaza/dükkanaboneliködemesigibi.Buradaalıcıveürün olmadığıiçinescrowdöngüsüyoktur. . 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 Aşağıdakiörnektetoplamda100TL’lik3adetaboneliködemesi,3taksitle110TLolacakşekilde ödeniyor.Hattasepetteyeralanilkaboneliködemesiaynızamandafizikselbirkargogerektirdiği için,tipi(BasketItemType)fizikselürün(PHYSICAL)olarakişaretlenmiştir,bunedenledeteslimat adresi(ShippingAddress)gönderilmiştir. • APIServis(Endpoint)İsmi:/payment/iyzipos/auth/ecom • Method:HTTPPOST Örnek Java İstek Kodu: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentAuthRequestrequest=newEcomPaymentAuthRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPrice(newBigDecimal("100")); request.setPaidPrice(newBigDecimal("110")); request.setCurrency("TRY"); request.setInstallment(3); request.setBasketId("B67832"); request.setPaymentChannel(PaymentChannelRequestType.WEB.name()); request.setPaymentGroup(PaymentGroupRequestType.SUBSCRIPTION.name()); EcomPaymentCardDtopaymentCard=newEcomPaymentCardDto(); paymentCard.setCardHolderName("SabriOnurTüzün"); paymentCard.setCardNumber("554960******7015"); paymentCard.setExpireMonth("**"); paymentCard.setExpireYear("20**"); paymentCard.setCvc("***"); paymentCard.setRegisterCard(0); request.setPaymentCard(paymentCard); EcomPaymentBuyerDtobuyer=newEcomPaymentBuyerDto(); buyer.setId("BY789"); buyer.setName("SabriOnur"); buyer.setSurname("Tüzün"); buyer.setGsmNumber("+905350000000"); buyer.setEmail("[email protected]"); buyer.setIdentityNumber("74300864791"); buyer.setLastLoginDate("2015-10-0512:43:35"); . 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 buyer.setRegistrationDate("2013-04-2115:12:09"); buyer.setRegistrationAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy"); buyer.setIp("85.34.78.112"); buyer.setCity("İstanbul"); buyer.setCountry("Türkiye"); buyer.setZipCode("34732"); request.setBuyer(buyer); EcomPaymentShippingAddressDtoshippingAddress=newEcomPaymentShippingAddressDto(); shippingAddress.setContactName("HakanErdoğan"); shippingAddress.setCity("İstanbul"); shippingAddress.setCountry("Türkiye"); shippingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); shippingAddress.setZipCode("34742"); request.setShippingAddress(shippingAddress); EcomPaymentBillingAddressDtobillingAddress=newEcomPaymentBillingAddressDto(); billingAddress.setContactName("HakanErdoğan"); billingAddress.setCity("İstanbul"); billingAddress.setCountry("Türkiye"); billingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); billingAddress.setZipCode("34742"); request.setBillingAddress(billingAddress); List<EcomPaymentBasketItemDto>basketItems=newArrayList<EcomPaymentBasketItemDto>(); EcomPaymentBasketItemDtobasketItem1=newEcomPaymentBasketItemDto(); basketItem1.setId("BI101"); basketItem1.setName("Dükkanaboneliğivekatalog"); basketItem1.setCategory1("Abonelik"); basketItem1.setCategory2("Dükkan"); basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem1.setPrice(newBigDecimal("30")); basketItems.add(basketItem1); EcomPaymentBasketItemDtobasketItem2=newEcomPaymentBasketItemDto(); basketItem2.setId("BI102"); basketItem2.setName("Listelemeaboneliği"); basketItem2.setCategory1("Abonelik"); basketItem2.setCategory2("Listeleme"); basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem2.setPrice(newBigDecimal("50")); basketItems.add(basketItem2); . 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 EcomPaymentBasketItemDtobasketItem3=newEcomPaymentBasketItemDto(); basketItem3.setId("BI103"); basketItem3.setName("Servisaboneliği"); basketItem3.setCategory1("Abonelik"); basketItem3.setCategory2("Servis"); basketItem3.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem3.setPrice(newBigDecimal("20")); basketItems.add(basketItem3); request.setBasketItems(basketItems); EcomPaymentAuthResponseresponse=client.auth(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("currency="+response.getCurrency()); System.out.println("price="+response.getPrice()); System.out.println("paidPrice="+response.getPaidPrice()); 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(EcomPaymentItemTransactionDtoitemTransaction:itemTransactions){ . 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("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()); } } Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444735597648 paymentId=667906 price=100 paidPrice=110 currency=TRY installment=3 basketId=B67832 binNumber=554960 cardAssociation=MASTER_CARD cardFamily=Bonus cardType=CREDIT_CARD . 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 cardToken=null cardUserKey=null fraudStatus=1 iyziCommissionFee=0.25000000 iyziCommissionRateAmount=4.51000000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=10 paymentTransactionId=506591 itemId=BI101 paidPrice=33.00000000 price=30 transactionStatus=2 blockageRate=10.00000000 blockageRateAmountMerchant=3.30000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-2814:26:37 iyziCommissionFee=0.07500000 iyziCommissionRateAmount=1.35300000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=3.00000000 merchantPayoutAmount=28.27200000 paymentTransactionId=506596 itemId=BI102 paidPrice=55.00000000 price=50 transactionStatus=2 blockageRate=10.00000000 blockageRateAmountMerchant=5.50000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-2814:26:37 iyziCommissionFee=0.12500000 iyziCommissionRateAmount=2.25500000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=5.00000000 merchantPayoutAmount=47.12000000 paymentTransactionId=506601 itemId=BI103 paidPrice=22.00000000 price=20 transactionStatus=2 blockageRate=10.00000000 blockageRateAmountMerchant=2.20000000 blockageRateAmountSubMerchant=0 . 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 blockageResolvedDate=2015-10-2814:26:37 iyziCommissionFee=0.05000000 iyziCommissionRateAmount=0.90200000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=2.00000000 merchantPayoutAmount=18.84800000 Örnek Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentChannel":"WEB", "basketId":"B67832", "paymentGroup":"SUBSCRIPTION", "paymentCard":{ "cardHolderName":"SabriOnurTüzün", "cardNumber":"554960******7015", "expireYear":"20**", "expireMonth":"**", "cvc":“***", "registerCard":0 }, "buyer":{ "id":"BY789", "name":"SabriOnur", "surname":"Tüzün", "identityNumber":"74300864791", "email":"[email protected]", "gsmNumber":"+905350000000", "registrationDate":"2013-04-2115:12:09", "lastLoginDate":"2015-10-0512:43:35", "registrationAddress":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy", "city":"İstanbul", "country":"Türkiye", "zipCode":"34732", . 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 "ip":"85.34.78.112" }, "shippingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "billingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "basketItems":[{ "id":"BI101", "price":30, "name":"Dükkanaboneliğivekatalog", "category1":"Abonelik", "category2":"Dükkan", "itemType":"PHYSICAL" },{ "id":"BI102", "price":50, "name":"Listelemeaboneliği", "category1":"Abonelik", "category2":"Listeleme", "itemType":"VIRTUAL" },{ "id":"BI103", "price":20, "name":"Servisaboneliği", "category1":"Abonelik", "category2":"Servis", "itemType":"VIRTUAL" }] } Örnek Java Sonuç Koduna Ait JSON Çıktısı: . 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 { "status":"success", "locale":"tr", "systemTime":1444735597648, "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentId":"667906", "fraudStatus":1, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":10, "iyziCommissionRateAmount":4.51000000, "iyziCommissionFee":0.25000000, "cardType":"CREDIT_CARD", "cardAssociation":"MASTER_CARD", "cardFamily":"Bonus", "binNumber":"554960", "basketId":"B67832", "itemTransactions":[{ "itemId":"BI101", "paymentTransactionId":"506591", "transactionStatus":2, "price":30, "paidPrice":33.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":3.00000000, "iyziCommissionRateAmount":1.35300000, "iyziCommissionFee":0.07500000, "blockageRate":10.00000000, "blockageRateAmountMerchant":3.30000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-2814:26:37", "subMerchantPrice":0, "subMerchantPayoutRate":0E-8, "subMerchantPayoutAmount":0, "merchantPayoutAmount":28.27200000 },{ "itemId":"BI102", "paymentTransactionId":"506596", "transactionStatus":2, "price":50, . 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":55.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":5.00000000, "iyziCommissionRateAmount":2.25500000, "iyziCommissionFee":0.12500000, "blockageRate":10.00000000, "blockageRateAmountMerchant":5.50000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-2814:26:37", "subMerchantPrice":0, "subMerchantPayoutRate":0E-8, "subMerchantPayoutAmount":0, "merchantPayoutAmount":47.12000000 },{ "itemId":"BI103", "paymentTransactionId":"506601", "transactionStatus":2, "price":20, "paidPrice":22.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":2.00000000, "iyziCommissionRateAmount":0.90200000, "iyziCommissionFee":0.05000000, "blockageRate":10.00000000, "blockageRateAmountMerchant":2.20000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-2814:26:37", "subMerchantPrice":0, "subMerchantPayoutRate":0E-8, "subMerchantPayoutAmount":0, "merchantPayoutAmount":18.84800000 }] } 3.3.1.3.3 Pazaryeri/MarketplacesİşModelindeOlMAyanÜyeİşyerleriİçinÜrünÖdemesi; Pazaryeriişmodelindeolmayan,standarte-ticaretişmodelindekiüyeişyerlerininürünödemesi neredeysebirüstteyeralanlisteleme/aboneliködemesiyleaynıdır.Tekfark, • Sepetteyeralanürünlerintipi(BasketItemType)fizikselürün(PHYSICAL)olarak işaretlenmelidir,bunedenledeteslimatadresi(ShippingAddress)gönderilmelidir. . 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 • SepetteyeralanürünleriçinsubMerchantKeyvesubMerchantPricegönderilMEmelidir • Ödemegrubuürüngönderilmelidir: request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name()); 3.3.1.4 3DSecureÖdeme Üyeişyeri;çeşitlidurumlarda(riskfaktörününyüksekoluşu,alıcının3DSecureseçimi,bankakartı ileödemeyapılması,vb)ödemeyi3DSecureolarakalmayıtercihedebilir. 3DSecureödemetemelde3aşamadanoluşur: 1. 3DSecure’uBaşlatma(initialize3DS):3DSödemealınabilmesiiçiniyzico’yaödeme parametreleriylebirliktebirgeridönüş(callback)URL’iPOSTedilir.Dönülensonuçbaşarılı ise(status=success),dönüşiçindeyeralanHTMLiçerik(threeDSHtmlContent),tarayıcının responseBody’sinebasılır,böylecekullanıcıotomatikolarak,bankanın3DSödeme sayfasına(SMSşifresinigireceğibankasayfası)yönlenir. Not:iyzico’dandönenHTMLiçerikBase64encodedolarakiletilirancakiyzico istemcilerindesizinadınızaotomatikolarakBase64decodingişlemiyapılır,dolayısıylasiz kulanıcıdostuHTMLiçeriğigörebilirsiniz. 2. ÜyeİşyerineDönüş(callback):Kullanıcıbankanın3DSödemesayfasındaşifresini girdiktensonra,sonuçiyzico’yagelir.İyzicokendikontrolleriniyaptıktansonra,üyeişyeri tarafındagereklikontrollerin(ürünhalasatıştamı,ürünhalastoktamı,oturumhalaaçık mı,vb)yapılmasıiçinüyeişyerinincallbackURL’ineHTMLposteder.Buadım,üyeişyeri iyzicovebankaüçlüsüarasındaelsıkışma(handshake)içingereklidir.Buaşamdahenüz paraçekilmemiştir.3DSecuremodellerinde3Dmodelitamdoğrulama(Full3DS)ile kullanılmaktadır. 3. 3DSecureileÖdemeyiTamamlama(auth3DS):Eğer,üyeişyerinincallbackURL’ine dönülenHTMLsonuçiçindeişlemdurumubaşarılı(status=success)ise,üyeişyerikendi gereklikontrolleriniyaptıktansonra,ödemealınması=paraçekilmesiiçiniyzico’yaistekte (auth3DS)bulunurveişlemsonucunukendikullanıcısınagösterir. . 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 CallbackURL’inedönülenHTMLsonuçiçindeişlemdurumubaşarısıziseauth3DS isteğindebulunulMAmalıdır. 3.3.1.4.1 Pazaryeri/MarketplacesİşModelindeOlanÜyeİşyerleriİçinÜrünÖdemesi(3DSecure); Aşağıdakiörnekte,3üründenoluşan100TLtutarındabirsepet3taksitli,110TLolarak3DSecure yöntemiyleödeniyor.Sepettekiürünlerdenenaz1tanesifizikselürünolduğuiçinteslimatadresi bilgisigönderiliyor.Sepetteyeralanherbirürünfarklıaltüyeişyerineaitvesırasıyla30TL’lik ürünonaylandığında27TL’si(üyeişyerisatışkomisyonubuürüniçin%10),50TL’likürün onaylandığında42TL’si(üyeişyerisatışkomisyonubuürüniçin%16)ve20TL’likürün onaylandığında18TL’si(üyeişyerisatışkomisyonubuürüniçin%10)altüyeişyerine gönderilecektir. 3DSecure’uBaşlatma(initialize3DS)ÜrünÖdemesi: • APIServis(Endpoint)İsmi:/payment/iyzipos/initialize3ds/ecom • Method:HTTPPOST Örnek initialize3DS Java İstek Çıktısı: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentThreeDSInitializeRequestrequest=newEcomPaymentThreeDSInitializeRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setCallbackUrl("https://www.merchant.com/callbackUrl"); request.setPrice(newBigDecimal("100")); request.setPaidPrice(newBigDecimal("110")); request.setCurrency("TRY"); request.setInstallment(3); request.setBasketId("B67832"); request.setPaymentChannel(PaymentChannelRequestType.WEB.name()); request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name()); EcomPaymentCardDtopaymentCard=newEcomPaymentCardDto(); paymentCard.setCardHolderName("SabriOnurTüzün"); paymentCard.setCardNumber("554960******7015"); paymentCard.setExpireMonth("**"); paymentCard.setExpireYear("20**"); . 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 paymentCard.setCvc("***"); paymentCard.setRegisterCard(0); request.setPaymentCard(paymentCard); EcomPaymentBuyerDtobuyer=newEcomPaymentBuyerDto(); buyer.setId("BY789"); buyer.setName("SabriOnur"); buyer.setSurname("Tüzün"); buyer.setGsmNumber("+905350000000"); buyer.setEmail("[email protected]"); buyer.setIdentityNumber("74300864791"); buyer.setLastLoginDate("2015-10-0512:43:35"); buyer.setRegistrationDate("2013-04-2115:12:09"); buyer.setRegistrationAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy"); buyer.setIp("85.34.78.112"); buyer.setCity("İstanbul"); buyer.setCountry("Türkiye"); buyer.setZipCode("34732"); request.setBuyer(buyer); EcomPaymentShippingAddressDtoshippingAddress=newEcomPaymentShippingAddressDto(); shippingAddress.setContactName("HakanErdoğan"); shippingAddress.setCity("İstanbul"); shippingAddress.setCountry("Türkiye"); shippingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); shippingAddress.setZipCode("34742"); request.setShippingAddress(shippingAddress); EcomPaymentBillingAddressDtobillingAddress=newEcomPaymentBillingAddressDto(); billingAddress.setContactName("HakanErdoğan"); billingAddress.setCity("İstanbul"); billingAddress.setCountry("Türkiye"); billingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); billingAddress.setZipCode("34742"); request.setBillingAddress(billingAddress); List<EcomPaymentBasketItemDto>basketItems=newArrayList<EcomPaymentBasketItemDto>(); EcomPaymentBasketItemDtobasketItem1=newEcomPaymentBasketItemDto(); basketItem1.setId("BI101"); basketItem1.setName("ABCMarkaKolye"); basketItem1.setCategory1("Giyim"); basketItem1.setCategory2("Aksesuar"); . 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 basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem1.setPrice(newBigDecimal("30")); basketItem1.setSubMerchantKey("ha3us4v5mk2652kkjk5728cc4407an"); basketItem1.setSubMerchantPrice(newBigDecimal("27")); basketItems.add(basketItem1); EcomPaymentBasketItemDtobasketItem2=newEcomPaymentBasketItemDto(); basketItem2.setId("BI102"); basketItem2.setName("XYZOyunKodu"); basketItem2.setCategory1("Oyun"); basketItem2.setCategory2("OnlineOyunKodları"); basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem2.setPrice(newBigDecimal("50")); basketItem2.setSubMerchantKey("ha3us4v5mk2652kkjk5728cc4407an"); basketItem2.setSubMerchantPrice(newBigDecimal("42")); basketItems.add(basketItem2); EcomPaymentBasketItemDtobasketItem3=newEcomPaymentBasketItemDto(); basketItem3.setId("BI103"); basketItem3.setName("EDCMarkaUsb"); basketItem3.setCategory1("Elektronik"); basketItem3.setCategory2("Usb/Cable"); basketItem3.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem3.setPrice(newBigDecimal("20")); basketItem3.setSubMerchantKey("ha3us4v5mk2652kkjk5728cc4407an"); basketItem3.setSubMerchantPrice(newBigDecimal("18")); basketItems.add(basketItem3); request.setBasketItems(basketItems); EcomPaymentThreeDSInitializeResponseresponse=client.initializeThreeDS(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("threeDSHtmlContent="+response.getThreeDSHtmlContent()); Örnek initialize3DS Java Sonuç Çıktısı: . 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 conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444739797682 threeDSHtmlContent=<!DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <title>MDpaydefaultresponsetemplateforweb</title> </head> <bodybgcolor="#02014E"OnLoad="OnLoadEvent();"> <formname="downloadForm" action="https://3dsecure.garanti.com.tr/acs/0036537396382857515710002306/merchant/contro l/master" method="POST"> <inputtype="hidden" name="PaReq" value="eJxVUdtuwjAM/ZWKD2iSlvSCTCQuD0MaE4Jp0vZWUg860RTSdIV9/ZKWy/YUn2PHxz6G17 1GnG9QNhoFLLGusx16RT4e8GESM87ZQMBqssaTgG/UdVEpwXzqB0Bu0P7Scp8pIyCTp+niRfCARjwEco VQol7MRcSjiCYRS4H0BKisRFFcfgpZAekAyKpRRl9EnFqFG4BGH8TemOOIkLZt/f6LL6sSiEsBeYywalxU21b nIhdbs522qkZy+pzVanZ+xo/lG8OvzWE3BuIqIM8MioAyzigLPRaMhnQUWvGOh6x0M4jX9bvHGPUptVv 1FByd0qQHNudSfymwlmpU8iLSoV35jgDPx0qhrbAi9xhyrKXwrKx7gTzWmD05X6WxhlEaWl/jMI3CJEh4z BmPnXAQ0si53RW5/oU1jSWMdQIOAHFtyPWQ5HpnG/27/y9Ltqri"> <inputtype="hidden" name="TermUrl"value="https://spos.isbank.com.tr/fim/est3Dgate?msgid=54871551"> <inputtype="hidden" name="MD" value="554960:49B5838C731576E72B2BB10319D348D301545852C82BB0A45A0E9B11ECB86CE7 :3668:##700656608619"> <!--Tosupportjavascriptunaware/disabledbrowsers--> <noscript> <center>Pleaseclickthesubmitbuttonbelow.<br> <inputtype="submit"name="submit"value="Submit"></center> </noscript> </form> <SCRIPTLANGUAGE="Javascript"> <!--about:blank--> <!-- . 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 functionOnLoadEvent(){ document.downloadForm.submit(); } //--> </SCRIPT> </body> </html> Örnek initialize3DS Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentChannel":"WEB", "basketId":"B67832", "paymentGroup":"PRODUCT", "paymentCard":{ "cardHolderName":"SabriOnurTüzün", "cardNumber":"554960******7015", "expireYear":"20**", "expireMonth":"**", "cvc":"***", "registerCard":0 }, "buyer":{ "id":"BY789", "name":"SabriOnur", "surname":"Tüzün", "identityNumber":"74300864791", "email":"[email protected]", "gsmNumber":"+905350000000", "registrationDate":"2013-04-2115:12:09", "lastLoginDate":"2015-10-0512:43:35", "registrationAddress":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy", "city":"İstanbul", "country":"Türkiye", "zipCode":"34732", . 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 "ip":"85.34.78.112" }, "shippingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "billingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "basketItems":[{ "id":"BI101", "price":30, "name":"ABCMarkaKolye", "category1":"Giyim", "category2":"Aksesuar", "itemType":"PHYSICAL", "subMerchantKey":"ha3us4v5mk2652kkjk5728cc4407an", "subMerchantPrice":27 },{ "id":"BI102", "price":50, "name":"XYZOyunKodu", "category1":"Oyun", "category2":"OnlineOyunKodları", "itemType":"VIRTUAL", "subMerchantKey":"ha3us4v5mk2652kkjk5728cc4407an", "subMerchantPrice":42 },{ "id":"BI103", "price":20, "name":"EDCMarkaUsb", "category1":"Elektronik", "category2":"Usb/Cable", "itemType":"PHYSICAL", "subMerchantKey":"ha3us4v5mk2652kkjk5728cc4407an", "subMerchantPrice":18 . 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 }], "callbackUrl":"https://www.merchant.com/callbackUrl" } Örnek initialize3DS Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1444740039787, "conversationId":"123456789", "threeDSHtmlContent":"<!DOCTYPEHTMLPUBLIC\"-//W3C//DTDHTML4.01//EN\" \"http://www.w3.org/TR/html4/strict.dtd\">\n\n<html>\n<head>\n<title>MDpaydefaultresponse templateforweb</title>\n</head>\n<bodybgcolor=\"#02014E\"OnLoad=\"OnLoadEvent();\" >\n<form name=\"downloadForm\"\naction=\"https://3dsecure.garanti.com.tr/acs/0036537398804063853 260059907/merchant/control/master\"\nmethod=\"POST\">\n<input type=\"hidden\"\nname=\"PaReq\"\nvalue=\"eJxVUdtuwjAM/ZWKD2iStukFGUsMmECCCW 19YI9Vao1qawtpu8K+fgnlsj3F59jxsY8h3Wui+RupThPChpom+yCnyCcjGcSRJ4UcIWynr3RE+CbdFHWFw uWuB+wGzS+t9lnVImTq+LR6QenxUPrArhBK0qs5hjIMeRyKBNhAQJWVhMX5p1A1sAsAVXdVq88YJUbh BqDTX7hv28OYsb7v3eGLq+oSmE0Be4yw7WzUmFanIseMynT9uTs2i3TXr5+XvVgFCzFT6UZNgNkKyLO W0ONCCi58R3jjIBj7AbALD1lpZ8D09d0Rgrucm60GCg5WaToAk7OpvxQYSzVV6oxJYFa+I6DToa7IVJgN7z Hk1Ch0jKx9gT3WmC2tr6o1hnHuG18jP4ljHvDQj6XvhZzLJOGRdftSZPsXxjQRC3ERsACYbcOuh2TXO5vo3 /1/AU1fqgg=\">\n<inputtype=\"hidden\"\nname=\"TermUrl\" value=\"https://spos.isbank.com.tr/fim/est3Dgate?msgid=54872515\">\n<input type=\"hidden\"\nname=\"MD\"\nvalue=\"554960:4C296BFD8B09CB33B583B7401731DE2 B57E8A0753CE88B889A628E6772B1325B:3867:##700656608619\">\n<!--Tosupportjavascript unaware/disabledbrowsers-->\n<noscript>\n<center>Pleaseclickthesubmitbutton below.<br>\n<inputtype=\"submit\"name=\"submit\" value=\"Submit\"></center>\n</noscript>\n</form>\n\n<SCRIPTLANGUAGE=\"Javascript\">\n<!-- about:blank-->\n<!--\nfunctionOnLoadEvent(){\ndocument.downloadForm.submit();\n}\n//->\n</SCRIPT>\n</body>\n</html>\u0000" } ÜyeİşyerineDönüş(callback): Kullanıcıbankanın3DSecureödemesayfasındaSMSşifresinigirdiktensonrasonuçiyzico’ya iletilir.İyzicodagereklikontrolleriniyaptıktansonrakullanıcıyı,tarayıcıseviyesinde,üyeişyeri dönüş(callback)URL’ineaşağıdakişekildePOSTederveyönlendirir.CallbackURL’ine (https://www.merchant.com/callbackUrl)dönen3temelparametrebulunur. . 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 • Bunlardanilkiişleminsonucunugösterenstatusalanı(successveyafailure), • diğeriparaçekimiyapılacaködemeninid’sipaymentId, • sonolarakdailetişimdekullanılanvericonversationData. Eğerstatus=successisepaymentIdveconversationDatailetilerek3DSecureödeme tamamlama(auth3DS)yapılır.status=failureisepaymentIdveconversationDataboş gelecektir,budurumdaauth3DSisteğiyapılmamalıdır. Örnek Üye İşyeri Dönüş HTML İçeriği: <!doctypehtml> <htmllang="en"> <head> <title>Merchant3dsCallbackForm</title> </head> <bodyonload="submitIyzicoThreeDSCallbackForm();"> <formid="iyzico-3ds-callback-form"name="iyzico-3ds-callback-form" action="https://www.merchant.com/callbackUrl"method="post"> <inputtype="hidden"name="status"value="success"> <inputtype="hidden"name="paymentId"value="457932"> <inputtype="hidden"name="conversationData"value="KPeA/vSq2nspTXa3mIHveg=="> </form> <scriptlanguage="Javascript"> <!-- functionsubmitIyzicoThreeDSCallbackForm(){ document.getElementById("iyzico-3ds-callback-form").submit(); } //--> </script> </body> </html> 3DSecureileÖdemeyiTamamlama(auth3DS): iyzico,üyeişyerinincallbackURL’inebaşarılısonuçPOSTettiktensonra,üyeişyerikenditarafında gereklikontrolleri(ürünhalasatıştamı,ürünhalastoktamı,oturumhalaaçıkmı,vb)yaparve ödemeyialmayakararverirseauth3DSisteğindebulunur. • APIServis(Endpoint)İsmi:/payment/iyzipos/auth3ds/ecom . 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 • Method:HTTPPOST Örnek auth3DS Java İstek Çıktısı: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentThreeDSRequestrequest=newEcomPaymentThreeDSRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentId("457932"); request.setConversationData("KPeA/vSq2nspTXa3mIHveg=="); EcomPaymentThreeDSResponseresponse=client.threeDSAuth(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()); 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(); . 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 if(itemTransactions!=null&&!itemTransactions.isEmpty()){ for(EcomPaymentItemTransactionDtoitemTransaction: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()); } } Örnek auth3DS Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444142311338 paymentId=457932 price=100 paidPrice=110 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 installment=3 basketId=B67832 binNumber=554960 cardAssociation=MASTER_CARD cardFamily=Bonus cardType=CREDIT_CARD cardToken=null cardUserKey=null fraudStatus=1 iyziCommissionFee=0.25000000 iyziCommissionRateAmount=4.51000000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=10 paymentTransactionId=1307 itemId=BI101 paidPrice=33.00000000 price=30 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=2.31000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.07500000 iyziCommissionRateAmount=1.35300000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=3.00000000 merchantPayoutAmount=2.26200000 subMerchantKey=l4FCFycIof0paTP6687dOoch9Po= subMerchantPayoutAmount=27 subMerchantPayoutRate=90.00000000 subMerchantPrice=27 paymentTransactionId=1308 itemId=BI102 paidPrice=55.00000000 price=50 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=3.85000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.12500000 iyziCommissionRateAmount=2.25500000 merchantCommissionRate=10.00000000 . 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 merchantCommissionRateAmount=5.00000000 merchantPayoutAmount=6.77000000 subMerchantKey=lcB6bA9DWEF5e8yGJI0uIEcW1kw= subMerchantPayoutAmount=42 subMerchantPayoutRate=84.00000000 subMerchantPrice=42 paymentTransactionId=1309 itemId=BI103 paidPrice=22.00000000 price=20 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=1.54000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.05000000 iyziCommissionRateAmount=0.90200000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=2.00000000 merchantPayoutAmount=1.50800000 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= subMerchantPayoutAmount=18 subMerchantPayoutRate=90.00000000 subMerchantPrice=18 Örnek auth3DS Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "paymentId":"457932", "conversationData":"KPeA/vSq2nspTXa3mIHveg==" } Örnek auth3DS Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1444142311338, "conversationId":"123456789", . 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 "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentId":"457932", "fraudStatus":1, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":10, "iyziCommissionRateAmount":4.51000000, "iyziCommissionFee":0.25000000, "cardType":"CREDIT_CARD", "cardAssociation":"MASTER_CARD", "cardFamily":"Bonus", "binNumber":"554960", "basketId":"B67832", "itemTransactions":[{ "itemId":"BI101", "paymentTransactionId":"1307", "transactionStatus":1, "price":30, "paidPrice":33.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":3.00000000, "iyziCommissionRateAmount":1.35300000, "iyziCommissionFee":0.07500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":2.31000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":27, "merchantPayoutAmount":2.26200000 },{ "itemId":"BI102", "paymentTransactionId":"1308", "transactionStatus":1, "price":50, "paidPrice":55.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":5.00000000, "iyziCommissionRateAmount":2.25500000, . 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 "iyziCommissionFee":0.12500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":3.85000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42, "subMerchantPayoutRate":84.00000000, "subMerchantPayoutAmount":42, "merchantPayoutAmount":6.77000000 },{ "itemId":"BI103", "paymentTransactionId":"1309", "transactionStatus":1, "price":20, "paidPrice":22.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":2.00000000, "iyziCommissionRateAmount":0.90200000, "iyziCommissionFee":0.05000000, "blockageRate":7.00000000, "blockageRateAmountMerchant":1.54000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":18, "merchantPayoutAmount":1.50800000 }] } 3.3.1.4.2 ListelemeveyaAbonelikÖdemesi(Pazaryeri/MarketplacesvePazaryeriOlmayanİş ModelindekiÜyeİşyerleriİçinAynı)(3DSecure); Üyeişyeri;ListelemeveyaAboneliködemelerini3DSecureileyapmakisterse,aşağıdakiörnekte yeraldığıgibiparametrelerigöndermesiyeterlidir.initialize3DSdışındaki,callbackveauth3DS akışlarıveparametreleri"4.3.1.4.1Pazaryeri/MarketplacesİşModelindeOlanÜyeİşyerleriİçin ÜrünÖdemesi(3DSecure)"maddesindekilerlebirebiraynıolduğuiçinbuörnekleretekrar yapılmamıştı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 3DSecure’uBaşlatma(initialize3DS)-ListelemeveyaAbonelikÖdemesi: • APIServis(Endpoint)İsmi:/payment/iyzipos/initialize3ds/ecom • Method:HTTPPOST Örnek initialize3DS Java İstek Çıktısı: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentThreeDSInitializeRequestrequest=newEcomPaymentThreeDSInitializeRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setCallbackUrl("https://www.merchant.com/callback"); request.setPrice(newBigDecimal("100")); request.setPaidPrice(newBigDecimal("100")); request.setCurrency("TRY"); request.setInstallment(1); request.setBasketId("B67832"); request.setPaymentChannel(PaymentChannelRequestType.WEB.name()); request.setPaymentGroup(PaymentGroupRequestType.LISTING.name()); EcomPaymentCardDtopaymentCard=newEcomPaymentCardDto(); paymentCard.setCardHolderName("SabriOnurTüzün"); paymentCard.setCardNumber("554960******7015"); paymentCard.setExpireMonth("**"); paymentCard.setExpireYear("20**"); paymentCard.setCvc("***"); paymentCard.setRegisterCard(0); request.setPaymentCard(paymentCard); EcomPaymentBuyerDtobuyer=newEcomPaymentBuyerDto(); buyer.setId("BY789"); buyer.setName("SabriOnur"); buyer.setSurname("Tüzün"); buyer.setGsmNumber("+905350000000"); buyer.setEmail("[email protected]"); buyer.setIdentityNumber("74300864791"); buyer.setLastLoginDate("2015-10-0512:43:35"); buyer.setRegistrationDate("2013-04-2115:12:09"); buyer.setRegistrationAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy"); . 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 buyer.setIp("85.34.78.112"); buyer.setCity("İstanbul"); buyer.setCountry("Türkiye"); buyer.setZipCode("34732"); request.setBuyer(buyer); EcomPaymentShippingAddressDtoshippingAddress=newEcomPaymentShippingAddressDto(); shippingAddress.setContactName("HakanErdoğan"); shippingAddress.setCity("İstanbul"); shippingAddress.setCountry("Türkiye"); shippingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); shippingAddress.setZipCode("34742"); request.setShippingAddress(shippingAddress); EcomPaymentBillingAddressDtobillingAddress=newEcomPaymentBillingAddressDto(); billingAddress.setContactName("HakanErdoğan"); billingAddress.setCity("İstanbul"); billingAddress.setCountry("Türkiye"); billingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); billingAddress.setZipCode("34742"); request.setBillingAddress(billingAddress); List<EcomPaymentBasketItemDto>basketItems=newArrayList<EcomPaymentBasketItemDto>(); EcomPaymentBasketItemDtobasketItem1=newEcomPaymentBasketItemDto(); basketItem1.setId("BI101"); basketItem1.setName("Dükkanlistelemesivekatalog"); basketItem1.setCategory1("Listeleme"); basketItem1.setCategory2("Dükkan"); basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem1.setPrice(newBigDecimal("30")); basketItems.add(basketItem1); EcomPaymentBasketItemDtobasketItem2=newEcomPaymentBasketItemDto(); basketItem2.setId("BI102"); basketItem2.setName("Listelemehizmeti"); basketItem2.setCategory1("Listeleme"); basketItem2.setCategory2("Listeleme"); basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem2.setPrice(newBigDecimal("50")); basketItems.add(basketItem2); EcomPaymentBasketItemDtobasketItem3=newEcomPaymentBasketItemDto(); basketItem3.setId("BI103"); . 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 basketItem3.setName("Servishizmeti"); basketItem3.setCategory1("Listeleme"); basketItem3.setCategory2("Servis"); basketItem3.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem3.setPrice(newBigDecimal("20")); basketItems.add(basketItem3); request.setBasketItems(basketItems); EcomPaymentThreeDSInitializeResponseresponse=client.initializeThreeDS(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("threeDSHtmlContent="+response.getThreeDSHtmlContent()); Örnek initialize3DS Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1445238853435 threeDSHtmlContent=<!DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <title>MDpaydefaultresponsetemplateforweb</title> </head> <bodybgcolor="#02014E"OnLoad="OnLoadEvent();"> <formname="downloadForm" action="https://3dsecure.garanti.com.tr/acs/0036542387077064147970095830/merchant/contro l/master" method="POST"> <inputtype="hidden" name="PaReq" . 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 value="eJxVUdtugzAM/RXU10nEAUKgciO15WGdtKpqq017ZCFqkcalAUbZ1y8pvWxP8Tl2fHxs3B+1 UslOyU4rga+qadKDcvJsNmEsogEAnwjczLfqJPBb6SavSkFdcD0kN2h+aXlMy1ZgKk+L1VowD0LmI7lCLJReJ SJkYQhRSGMkI4FlWiiRDz+5rJBcAMqqK1s9CB4bhRvATn+JY9vWU0L6vnfHL66sCiQ2heQxwqazUWNanf NMvO2G3TZ536/jan1olk/J4ly/9PXn5qWaIbEVmKWtEh5QRoHGDvApjaYeRXLhMS3sDGK//XAogAtgXI0 U1lZpPgKTs6m/FJqValXKQcSBsXxHqM51VSpTYRzeY8xUI4VjZO2L5GFj+Wz3KluzMAA/ZIHnRxw4hzCgAY 85QMwi3841Ftn+uVkajSi9CFiAxLYh10OS651N9O/+v486qk0="> <inputtype="hidden" name="TermUrl"value="https://spos.isbank.com.tr/fim/est3Dgate?msgid=55814007"> <inputtype="hidden" name="MD" value="554960:FF5B0BEDB0E17AC8087EBAB69B4FB5EBE8CB4CA2601451549B96212890F104F4 :4434:##700656608619"> <!--Tosupportjavascriptunaware/disabledbrowsers--> <noscript> <center>Pleaseclickthesubmitbuttonbelow.<br> <inputtype="submit"name="submit"value="Submit"></center> </noscript> </form> <SCRIPTLANGUAGE="Javascript"> <!--about:blank--> <!-- functionOnLoadEvent(){ document.downloadForm.submit(); } //--> </SCRIPT> </body> </html> Örnek initialize3DS Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "price":100, "paidPrice":100, "currency":TRY, "installment":1, "paymentChannel":"WEB", "basketId":"B67832", "paymentGroup":"LISTING", . 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 "paymentCard":{ "cardHolderName":"SabriOnurTüzün", "cardNumber":“554960******7015", "expireYear":“20**", "expireMonth":“**", "cvc":“***", "registerCard":0 }, "buyer":{ "id":"BY789", "name":"SabriOnur", "surname":"Tüzün", "identityNumber":"74300864791", "email":"[email protected]", "gsmNumber":"+905350000000", "registrationDate":"2013-04-2115:12:09", "lastLoginDate":"2015-10-0512:43:35", "registrationAddress":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy", "city":"İstanbul", "country":"Türkiye", "zipCode":"34732", "ip":"85.34.78.112" }, "shippingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "billingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "basketItems":[{ "id":"BI101", "price":30, "name":"Dükkanlistelemesivekatalog", "category1":"Listeleme", . 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 "category2":"Dükkan", "itemType":"PHYSICAL" },{ "id":"BI102", "price":50, "name":"Listelemehizmeti", "category1":"Listeleme", "category2":"Listeleme", "itemType":"VIRTUAL" },{ "id":"BI103", "price":20, "name":"Servishizmeti", "category1":"Listeleme", "category2":"Servis", "itemType":"VIRTUAL" }], "callbackUrl":"https://www.merchant.com/callback" } Örnek initialize3DS Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", "systemTime":1445238853435, "conversationId":"123456789", "threeDSHtmlContent":"<!DOCTYPEHTMLPUBLIC\"-//W3C//DTDHTML4.01//EN\" \"http://www.w3.org/TR/html4/strict.dtd\">\n\n<html>\n<head>\n<title>MDpaydefaultresponse templateforweb</title>\n</head>\n<bodybgcolor=\"#02014E\"OnLoad=\"OnLoadEvent();\" >\n<form name=\"downloadForm\"\naction=\"https://3dsecure.garanti.com.tr/acs/0036542389782599331 550048898/merchant/control/master\"\nmethod=\"POST\">\n<input type=\"hidden\"\nname=\"PaReq\"\nvalue=\"eJxVUctugzAQ/BWUD8APMNjRxlLaHIqqIpTm 0B6RsRKk8oiBBvr1tQlJ2pN3Ztc7u7NwOBmtd+9aDUZLeNNdlx+1VxabFWOchGEsVhKy7V6fJXxr05VNLY mPfQroBu0vo0553UvI1fkpSSWjOGIBoAVCpU2ykxGLIswjIgBdCajzSsty+ilVA2gGoJqh7s0kY2EVbgAG8yV Pfd+uEbpcLv71i6+aCpBLAXqMkA0u6myrsSwkT9hIxyxvy/KjyNMkHdFrMGW7Y9psALkKKPJeS4oJI5gID8 drStcMA5p5yCs3gzzsPz2CsY9tYqGgdUrbK7A5l/pLgbXU6FpNUoR25TsCPbZNrW2F3fAeQ6E7JT0r615Ajz WeX5yvqreGYRxELKQBFzGnTIggIIxhHHIuuHN7LnL9S2sa4YTMAg4Acm3Qcki03NlG/+7/C34mqkE=\">\n <inputtype=\"hidden\"\nname=\"TermUrl\" value=\"https://spos.isbank.com.tr/fim/est3Dgate?msgid=55814479\">\n<input type=\"hidden\"\nname=\"MD\"\nvalue=\"554960:AB3CA68F65E473063C526C352BFAAB0 . 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 EBD46B96FADC3293D13E1493F1E9EC00C:3568:##700656608619\">\n<!--Tosupportjavascript unaware/disabledbrowsers-->\n<noscript>\n<center>Pleaseclickthesubmitbutton below.<br>\n<inputtype=\"submit\"name=\"submit\" value=\"Submit\"></center>\n</noscript>\n</form>\n\n<SCRIPTLANGUAGE=\"Javascript\">\n<!-- about:blank-->\n<!--\nfunctionOnLoadEvent(){\ndocument.downloadForm.submit();\n}\n//->\n</SCRIPT>\n</body>\n</html>\u0000" } 3.3.1.4.3 Pazaryeri/MarketplacesİşModelindeOlMAyanÜyeİşyerleriİçinÜrünÖdemesi(3D Secure); Pazaryeriişmodelindeolmayan,standarte-ticaretişmodelindekiüyeişyerlerininürünödemesi neredeysebirüstteyeralan“4.3.1.4.2maddesindebelirtilen3DSecurelisteleme/abonelik ödemesi”ileaynıdır.Tekfark, • Sepetteyeralanürünlerintipi(BasketItemType)fizikselürün(PHYSICAL)olarak işaretlenmelidir,bunedenledeteslimatadresi(ShippingAddress)gönderilmelidir. • SepetteyeralanürünleriçinsubMerchantKeyvesubMerchantPricegönderilMEmelidir • Ödemegrubuürüngönderilmelidir: request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name()); 3.3.2 İptal İyzicoüzerindentahsiledilenbirödeme,bankakurallarıgereğiaynıgüniçinde(günsonu yapılmadan)iptal(cancel)edilebilir.İptalişlemininiadedenfarkı,ödemeileaynıgünyapılabilmesi vekartekstresindegirdi/çıktıyaratmamasıdır. İptalyapılabilmesiiçinödemeyeaitid(paymentId)gönderilmesigerekir,iptalişlemibaşarılıysaiptal edilentutar(price)servistendöner.İptalişlemitepedençalışır,yaniödemenintamamınıiptaleder. • APIServis(Endpoint)İsmi:/payment/iyzipos/cancel • Method:HTTPPOST Örnek Java İstek Çıktısı EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); . 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 PaymentCancelRequestrequest=newPaymentCancelRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentId("3031"); request.setIp("85.34.78.112"); PaymentCancelResponseresponse=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()); Ö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ı . 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 { "status":"success", "locale":"tr", "systemTime":1445239960166, "conversationId":"123456789", "paymentId":"3031", "price":1.10000000 } 3.3.3 İade İyzicoüzerindentahsiledilenbirödeme,365gün7/24iade(refund)edilebilir.İadeişlemimutlaka ekstreyeyansırveiadeedilenödemetaksitlibirişlemse,iadeninkartayansımasıbankadanbankaya değişmekleberaberbirkaçgünübulabilir.İadeişlemikırılımdançalışır,yaniödemeninbirkırlımının tamamınıveyabirkısmınıiadeeder. 3.3.3.1 Standartİade İadeyapılabilmesiiçinödemekırılımınaaitid(paymentTransactionId)veiadeedilecektutar (price)gönderilmesigerekir,iadeişlemibaşarılıysaiadeedilentutar(price)servistendöner.İade edilecektutar(price),iadeedileceködemeninkırılımınıntutarından(itemTransactionà paidPrice)veiadeedilebilirkalantutardanküçükveyaeşitolmalıdır.Bukuralsağlandığısürece ardardadefalarcaiadeyapılabilir. • APIServis(Endpoint)İsmi:/payment/iyzipos/refund • Method:HTTPPOST Örnek Java İstek Çıktısı EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); PaymentRefundRequestrequest=newPaymentRefundRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentTransactionId("1543"); request.setPrice(newBigDecimal("3.3")); . 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 request.setCurreny("TRY"); request.setIp("85.34.78.112"); PaymentRefundResponseresponse=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()); System.out.println("currency="+response.getCurrency()); Ö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, "ip":"85.34.78.112" } Örnek Java Sonuç Koduna Ait JSON Çıktısı . 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 { "status":"success", "locale":"tr", "systemTime":1445240504793, "conversationId":"123456789", "paymentId":"3032", "paymentTransactionId":"1543", "currency":TRY, "price":3.3 } 3.3.3.2 ParaTransferiSonrasıİade Eğeriadeedilecekkırılımaaitparatransferi;üyeişyerineve/veyaaltüyeişyerineyapılmışsa,bu durumdaiadeninyapılabilmesiiçindahaöncedendağıtılanparanıntoplanmasıgerekir. Örneğin;pazaryeriişmodelinde100TL’likbirödemenin • 90TL’sialtüyeişyerine, • 8TL’siüyeişyerine, • 2TL’sideiyzico’yagönderilmişolsun. Buişlemeait50TL’likbirkısmiiadetalebigelirse,budurumda • altüyeişyerinden45TL, • üyeişyerinden4TL, • iyzico’danda1TLgerialmakgerekir. İyzico,paranıngeritoplamaişini,oüyeişyerineve/veyaaltüyeişyerinegönderilecekbirsonraki paratransferindendüşerek(mahsuplaşarak)otomatikbirşekildeeldeğmedenyapar.Bunoktada • altüyeişyerineaitsistemdeparasıhenüzgönderilmemiş,onaybekleyen,veyaonaylanan amahenüzparatransferiyapılmamışödemeler,yanibakiyevarsa, • üyeişyerineaitsistemdeparasıhenüzgönderilmemiş,onaybekleyen,veyaonaylanan amahenüzparatransferiyapılmamışödemeler,yanibakiyevarsa iadekabuledilirveilgilibakiyelerilgiliüyeişyerivealtüyeişyerineeksiolarakyazılır,birsonraki paratransferindendüşü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 Eğeraltüyeişyerininbakiyesindeyeterliparayoksabuiadeişlemireddedilirveüyeişyerine “5116”hatakodudönülür.Üyeişyeribubakiyeyidekendisiüstlenmekisterseaşağıdakiservisi çağırarakiadeninyapılmasınısağlar. Eğerüyeişyerininbakiyesindeyeterliparayoksabuiadeişlemireddedilirveüyeişyerine“5117” hatakodudönülür.Budurumdaiadeişlemikabuledilmez. İadeparametrelerivedönüşdeğerleristandartiadeileaynıdır. • APIServis(Endpoint)İsmi:/payment/iyzipos/refund/merchant/charge • Method:HTTPPOST 3.3.4 ÖnOtorizasyon Normalödemedenfarklıolarakönotorizasyonuyapılanödemesadeceekstreden,çekilentutarın düşmesinesebepolur.Çekilenödemebankatarafındaönprovizyonişlemlerindeyeralır.Normal ödemedenfarkıisefarklıservisiolmasıdır.Servisegönderilenistekvealınansonuçlartamamiyle normalödemeninaynısıdır. • APIServis(Endpoint)İsmi:/payment/iyzipos/preauth • Method:HTTPPOST Örnek Java İstek Kodu: EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); EcomPaymentPreAuthRequestrequest=newEcomPaymentPreAuthRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPrice(newBigDecimal("100")); request.setPaidPrice(newBigDecimal("110")); request.setCurrency("TRY"); request.setInstallment(3); request.setBasketId("B67832"); request.setPaymentChannel(PaymentChannelRequestType.WEB.name()); request.setPaymentGroup(PaymentGroupRequestType.PRODUCT.name()); EcomPaymentCardDtopaymentCard=newEcomPaymentCardDto(); . 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 paymentCard.setCardHolderName("SabriOnurTüzün"); paymentCard.setCardNumber("554960**********"); paymentCard.setExpireMonth("**"); paymentCard.setExpireYear("20**"); paymentCard.setCvc("***"); paymentCard.setRegisterCard(0); request.setPaymentCard(paymentCard); EcomPaymentBuyerDtobuyer=newEcomPaymentBuyerDto(); buyer.setId("BY789"); buyer.setName("SabriOnur"); buyer.setSurname("Tüzün"); buyer.setGsmNumber("+905350000000"); buyer.setEmail("[email protected]"); buyer.setIdentityNumber("74300864791"); buyer.setLastLoginDate("2015-10-0512:43:35"); buyer.setRegistrationDate("2013-04-2115:12:09"); buyer.setRegistrationAddress("NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy"); buyer.setIp("85.34.78.112"); buyer.setCity("İstanbul"); buyer.setCountry("Türkiye"); buyer.setZipCode("34732"); request.setBuyer(buyer); EcomPaymentShippingAddressDtoshippingAddress=newEcomPaymentShippingAddressDto(); shippingAddress.setContactName("HakanErdoğan"); shippingAddress.setCity("İstanbul"); shippingAddress.setCountry("Türkiye"); shippingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); shippingAddress.setZipCode("34742"); request.setShippingAddress(shippingAddress); EcomPaymentBillingAddressDtobillingAddress=newEcomPaymentBillingAddressDto(); billingAddress.setContactName("HakanErdoğan"); billingAddress.setCity("İstanbul"); billingAddress.setCountry("Türkiye"); billingAddress.setAddress("19MayısMah.İnönüCad.No:45Kozyatağı"); billingAddress.setZipCode("34742"); request.setBillingAddress(billingAddress); List<EcomPaymentBasketItemDto>basketItems=newArrayList<EcomPaymentBasketItemDto>(); EcomPaymentBasketItemDtobasketItem1=newEcomPaymentBasketItemDto(); . 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 basketItem1.setId("BI101"); basketItem1.setName("ABCMarkaKolye"); basketItem1.setCategory1("Giyim"); basketItem1.setCategory2("Aksesuar"); basketItem1.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem1.setPrice(newBigDecimal("30")); basketItem1.setSubMerchantKey("l4FCFycIof0paTP6687dOoch9Po="); basketItem1.setSubMerchantPrice(newBigDecimal("27")); basketItems.add(basketItem1); EcomPaymentBasketItemDtobasketItem2=newEcomPaymentBasketItemDto(); basketItem2.setId("BI102"); basketItem2.setName("XYZOyunKodu"); basketItem2.setCategory1("Oyun"); basketItem2.setCategory2("OnlineOyunKodları"); basketItem2.setItemType(BasketItemRequestType.VIRTUAL.name()); basketItem2.setPrice(newBigDecimal("50")); basketItem2.setSubMerchantKey("lcB6bA9DWEF5e8yGJI0uIEcW1kw="); basketItem2.setSubMerchantPrice(newBigDecimal("42")); basketItems.add(basketItem2); EcomPaymentBasketItemDtobasketItem3=newEcomPaymentBasketItemDto(); basketItem3.setId("BI103"); basketItem3.setName("EDCMarkaUsb"); basketItem3.setCategory1("Elektronik"); basketItem3.setCategory2("Usb/Cable"); basketItem3.setItemType(BasketItemRequestType.PHYSICAL.name()); basketItem3.setPrice(newBigDecimal("20")); basketItem3.setSubMerchantKey("D9V/MqIRitUzA4dutL+nCBvnWfs="); basketItem3.setSubMerchantPrice(newBigDecimal("18")); basketItems.add(basketItem3); request.setBasketItems(basketItems); EcomPaymentPreAuthResponseresponse=client.preAuth(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()); . 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("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(EcomPaymentItemTransactionDtoitemTransaction: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="+ . 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 itemTransaction.getSubMerchantPayoutAmount()); System.out.println("subMerchantPayoutRate="+itemTransaction.getSubMerchantPayoutRate()); System.out.println("subMerchantPrice="+itemTransaction.getSubMerchantPrice()); } } Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444142311338 paymentId=2744 price=100 paidPrice=110 currency=TRY installment=3 basketId=B67832 binNumber=554960 cardAssociation=MASTER_CARD cardFamily=Bonus cardType=CREDIT_CARD cardToken=null cardUserKey=null fraudStatus=1 iyziCommissionFee=0.25000000 iyziCommissionRateAmount=4.51000000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=10 paymentTransactionId=1307 itemId=BI101 paidPrice=33.00000000 price=30 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=2.31000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.07500000 . 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 iyziCommissionRateAmount=1.35300000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=3.00000000 merchantPayoutAmount=2.26200000 subMerchantKey=l4FCFycIof0paTP6687dOoch9Po= subMerchantPayoutAmount=27 subMerchantPayoutRate=90.00000000 subMerchantPrice=27 paymentTransactionId=1308 itemId=BI102 paidPrice=55.00000000 price=50 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=3.85000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.12500000 iyziCommissionRateAmount=2.25500000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=5.00000000 merchantPayoutAmount=6.77000000 subMerchantKey=lcB6bA9DWEF5e8yGJI0uIEcW1kw= subMerchantPayoutAmount=42 subMerchantPayoutRate=84.00000000 subMerchantPrice=42 paymentTransactionId=1309 itemId=BI103 paidPrice=22.00000000 price=20 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=1.54000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.05000000 iyziCommissionRateAmount=0.90200000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=2.00000000 merchantPayoutAmount=1.50800000 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= subMerchantPayoutAmount=18 subMerchantPayoutRate=90.00000000 . 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 subMerchantPrice=18 Örnek Java İstek Koduna Ait JSON Çıktısı: { "locale":"tr", "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentChannel":"WEB", "basketId":"B67832", "paymentGroup":"PRODUCT", "paymentCard":{ "cardHolderName":"SabriOnurTüzün", "cardNumber":“554960**********", "expireYear":“20**", "expireMonth":“**", "cvc":“***", "registerCard":0 }, "buyer":{ "id":"BY789", "name":"SabriOnur", "surname":"Tüzün", "identityNumber":"74300864791", "email":"[email protected]", "gsmNumber":"+905350000000", "registrationDate":"2013-04-2115:12:09", "lastLoginDate":"2015-10-0512:43:35", "registrationAddress":"NidakuleGöztepeİşMerkeziMerdivenköyMah.BoraSok.No:1Kat:19 Bağımsız70/73GöztepeKadıköy", "city":"İstanbul", "country":"Türkiye", "zipCode":"34732", "ip":"85.34.78.112" }, "shippingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", . 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 "country":"Türkiye" }, "billingAddress":{ "address":"19MayısMah.İnönüCad.No:45Kozyatağı", "zipCode":"34742", "contactName":"HakanErdoğan", "city":"İstanbul", "country":"Türkiye" }, "basketItems":[{ "id":"BI101", "price":30, "name":"ABCMarkaKolye", "category1":"Giyim", "category2":"Aksesuar", "itemType":"PHYSICAL", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27 },{ "id":"BI102", "price":50, "name":"XYZOyunKodu", "category1":"Oyun", "category2":"OnlineOyunKodları", "itemType":"VIRTUAL", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42 },{ "id":"BI103", "price":20, "name":"EDCMarkaUsb", "category1":"Elektronik", "category2":"Usb/Cable", "itemType":"PHYSICAL", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18 }] } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", . 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 "locale":"tr", "systemTime":1444142311338, "conversationId":"123456789", "price":100, "paidPrice":110, "installment":3, "paymentId":"2744", "fraudStatus":1, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":10, "iyziCommissionRateAmount":4.51000000, "iyziCommissionFee":0.25000000, "cardType":"CREDIT_CARD", "cardAssociation":"MASTER_CARD", "cardFamily":"Bonus", "binNumber":"554960", "basketId":"B67832", "itemTransactions":[{ "itemId":"BI101", "paymentTransactionId":"1307", "transactionStatus":1, "price":30, "paidPrice":33.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":3.00000000, "iyziCommissionRateAmount":1.35300000, "iyziCommissionFee":0.07500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":2.31000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":27, "merchantPayoutAmount":2.26200000 },{ "itemId":"BI102", "paymentTransactionId":"1308", "transactionStatus":1, "price":50, "paidPrice":55.00000000, "merchantCommissionRate":10.00000000, . 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 "merchantCommissionRateAmount":5.00000000, "iyziCommissionRateAmount":2.25500000, "iyziCommissionFee":0.12500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":3.85000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42, "subMerchantPayoutRate":84.00000000, "subMerchantPayoutAmount":42, "merchantPayoutAmount":6.77000000 },{ "itemId":"BI103", "paymentTransactionId":"1309", "transactionStatus":1, "price":20, "paidPrice":22.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":2.00000000, "iyziCommissionRateAmount":0.90200000, "iyziCommissionFee":0.05000000, "blockageRate":7.00000000, "blockageRateAmountMerchant":1.54000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":18, "merchantPayoutAmount":1.50800000 }] } 3.3.5 SonOtorizasyon Önprovizyonuyapılanödemeyiekstreyeyansıtmakiçinprovizyonkapamayapılmasıgerekir.Bütün ödemeyikapamakiçinfiyatbilgisiolaraködenentutaryollanmalıdır.Eğeryollanmazisetamamına provizyonkapamauygulanır.Kısmikapamadayapılabilir. • APIServis(Endpoint)İsmi:/payment/iyzipos/postauth • Method:HTTPPOST . 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 İstek Çıktısı EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); PaymentPostAuthRequestrequest=newPaymentPostAuthRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentId("457932"); request.setIp("85.34.78.112"); request.setPaidPrice(newBigDecimal("110")); PaymentPostAuthResponseresponse=client.postAuth(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()); 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()){ . 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 for(EcomPaymentItemTransactionDtoitemTransaction: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()); } } Örnek Java Sonuç Çıktısı: conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1444142311338 paymentId=457932 price=100 paidPrice=110 . 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 currency=TRY installment=3 basketId=B67832 binNumber=554960 cardAssociation=MASTER_CARD cardFamily=Bonus cardType=CREDIT_CARD cardToken=null cardUserKey=null fraudStatus=1 iyziCommissionFee=0.25000000 iyziCommissionRateAmount=4.51000000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=10 paymentTransactionId=1307 itemId=BI101 paidPrice=33.00000000 price=30 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=2.31000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.07500000 iyziCommissionRateAmount=1.35300000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=3.00000000 merchantPayoutAmount=2.26200000 subMerchantKey=l4FCFycIof0paTP6687dOoch9Po= subMerchantPayoutAmount=27 subMerchantPayoutRate=90.00000000 subMerchantPrice=27 paymentTransactionId=1308 itemId=BI102 paidPrice=55.00000000 price=50 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=3.85000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.12500000 iyziCommissionRateAmount=2.25500000 . 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 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=5.00000000 merchantPayoutAmount=6.77000000 subMerchantKey=lcB6bA9DWEF5e8yGJI0uIEcW1kw= subMerchantPayoutAmount=42 subMerchantPayoutRate=84.00000000 subMerchantPrice=42 paymentTransactionId=1309 itemId=BI103 paidPrice=22.00000000 price=20 transactionStatus=1 blockageRate=7.00000000 blockageRateAmountMerchant=1.54000000 blockageRateAmountSubMerchant=0 blockageResolvedDate=2015-10-1617:38:31 iyziCommissionFee=0.05000000 iyziCommissionRateAmount=0.90200000 merchantCommissionRate=10.00000000 merchantCommissionRateAmount=2.00000000 merchantPayoutAmount=1.50800000 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs= subMerchantPayoutAmount=18 subMerchantPayoutRate=90.00000000 subMerchantPrice=18 Örnek Java İstek Koduna Ait JSON Çıktısı { "locale":"tr", "conversationId":"123456789", "paymentId":"457932", "paidPrice":110, "currency":TRY, "ip":"85.34.78.112" } Örnek Java Sonuç Koduna Ait JSON Çıktısı: { "status":"success", "locale":"tr", . 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":1444142311338, "conversationId":"123456789", "price":100, "paidPrice":110, "currency":TRY, "installment":3, "paymentId":"457932", "fraudStatus":1, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":10, "iyziCommissionRateAmount":4.51000000, "iyziCommissionFee":0.25000000, "cardType":"CREDIT_CARD", "cardAssociation":"MASTER_CARD", "cardFamily":"Bonus", "binNumber":"554960", "basketId":"B67832", "itemTransactions":[{ "itemId":"BI101", "paymentTransactionId":"1307", "transactionStatus":1, "price":30, "paidPrice":33.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":3.00000000, "iyziCommissionRateAmount":1.35300000, "iyziCommissionFee":0.07500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":2.31000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"l4FCFycIof0paTP6687dOoch9Po=", "subMerchantPrice":27, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":27, "merchantPayoutAmount":2.26200000 },{ "itemId":"BI102", "paymentTransactionId":"1308", "transactionStatus":1, "price":50, "paidPrice":55.00000000, "merchantCommissionRate":10.00000000, . 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 "merchantCommissionRateAmount":5.00000000, "iyziCommissionRateAmount":2.25500000, "iyziCommissionFee":0.12500000, "blockageRate":7.00000000, "blockageRateAmountMerchant":3.85000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"lcB6bA9DWEF5e8yGJI0uIEcW1kw=", "subMerchantPrice":42, "subMerchantPayoutRate":84.00000000, "subMerchantPayoutAmount":42, "merchantPayoutAmount":6.77000000 },{ "itemId":"BI103", "paymentTransactionId":"1309", "transactionStatus":1, "price":20, "paidPrice":22.00000000, "merchantCommissionRate":10.00000000, "merchantCommissionRateAmount":2.00000000, "iyziCommissionRateAmount":0.90200000, "iyziCommissionFee":0.05000000, "blockageRate":7.00000000, "blockageRateAmountMerchant":1.54000000, "blockageRateAmountSubMerchant":0, "blockageResolvedDate":"2015-10-1617:38:31", "subMerchantKey":"D9V/MqIRitUzA4dutL+nCBvnWfs=", "subMerchantPrice":18, "subMerchantPayoutRate":90.00000000, "subMerchantPayoutAmount":18, "merchantPayoutAmount":1.50800000 }] } 3.4 ParaTransferiİçinÜrüneOnayVerme Pazaryeriçözümünde,ödemeiyzico’dangeçtiktensonra,üyeişyeriödemeiçindeyeralankırılıma/ ürüneonayverenedekparakorumalıhavuzhesaptabekletilir.Üyeişyeribusüredeödemeyiiptal . 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 edebilir,ödemeninkırılımınıiadeedebilir,ürünalıcıyaulaştıveişlemsorunsuztamamlandıysapara transferiiçinürüneonayverebilir,veyaverdiğiürünonayınıgeriçekebilir. 3.4.1 ÜrüneOnayVerme Ürüneonayvermekiçinödemekırılımınaaitid(paymentTransactionId)iletilmesigerekmektedir. Onayverilenödemekırılımıid’si(paymentTransactionId)servistendöner. • APIServis(Endpoint)İsmi:/payment/iyzipos/item/approve • Method:HTTPPOST Örnek Java İstek Çıktısı EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); ApprovalRequestrequest=newApprovalRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); request.setPaymentTransactionId("1546"); ApprovalResponseresponse=client.approve(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("paymentTransactionId="+response.getPaymentTransactionId()); Örnek Java Sonuç Çıktısı conversationId=123456789 locale=tr 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=1445240902151 paymentTransactionId=1546 Örnek Java İstek Koduna Ait JSON Çıktısı { "locale":"tr", "conversationId":"123456789", "paymentTransactionId":"1546" } Örnek Java Sonuç Koduna Ait JSON Çıktısı { "status":"success", "locale":"tr", "systemTime":1445240902151, "conversationId":"123456789", "paymentTransactionId":"1546" } 3.4.2 VerilenOnayıGeriÇekme Ürüneverilenonayıgeriçekmekiçinödemekırılımınaaitid(paymentTransactionId)iletilmesi gerekmektedir.Onayıgeriçekilenödemekırılımıid’si(paymentTransactionId)servistendöner. • APIServis(Endpoint)İsmi:/payment/iyzipos/item/disapprove • Method:HTTPPOST Örnek Java İstek Çıktısı EcomPaymentServiceClientclient=newEcomPaymentServiceClientImpl(configuration); ApprovalRequestrequest=newApprovalRequest(); request.setLocale(RequestLocaleType.TR.getValue()); request.setConversationId("123456789"); . 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 request.setPaymentTransactionId("1546"); ApprovalResponseresponse=client.disapprove(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("paymentTransactionId="+response.getPaymentTransactionId()); Örnek Java Sonuç Çıktısı conversationId=123456789 locale=tr status=success errorCode=null errorMessage=null errorGroup=null systemTime=1445241016138 paymentTransactionId=1546 Örnek Java İstek Koduna Ait JSON Çıktısı { "locale":"tr", "conversationId":"123456789", "paymentTransactionId":"1546" } Örnek Java Sonuç Koduna Ait JSON Çıktısı { "status":"success", "locale":"tr", "systemTime":1445241016138, "conversationId":"123456789", "paymentTransactionId":"1546" . 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 } . 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
Benzer belgeler
iyzico Integration Document
request.setAddress("Nidakule Göztepe İş Merkezi Merdivenköy Mah. Bora Sok. No:1 Kat:19 Bağımsız
70/73 Göztepe Kadıköy 34732");
request.setContactName("Sabri Onur");
request.setContactSurname("Tüzün...
iyzico Checkout Form and Payment Page Integration Document
2.5 Cancel ............................................................................................................................................................................. 22
2.6 Refun...
BKM Express Dökümantasyonu
2.2.2
İptal
.....................................................................................................................................................................................