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

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

Detaylı

iyzico Checkout Form and Payment Page Integration Document

iyzico Checkout Form and Payment Page Integration Document 2.5 Cancel ............................................................................................................................................................................. 22 2.6 Refun...

Detaylı

BKM Express Dökümantasyonu

BKM Express Dökümantasyonu 2.2.2   İptal  .....................................................................................................................................................................................

Detaylı