iyzico mobil SDK; iyzico'nun müşterilerine WEB platformlarında sunduğu hizmetleri mobil uygulamalarda da kullanılmasını sağlayan bir uygulamadır. iyzico SDK'de Pay with iyzico hizmeti yer almaktadır.
- Pay with iyzico, müşterilerin alışverişlerini kolayca yapabildiği ücretsiz ve güvenli bir ödeme yöntemidir.
Bu doküman tüm mobil ortamlardaki (Android / Ios / React Native / vb.) uygulamalar için hazırlanmış, dökümanda SDKʼin 'iyzico ile Öde' hizmetinin uygulamalara nasıl entegre edileceği anlatılmaktadır.
-
-
- ### Web Kullanımı (React)
iyzico Mobil SDK' yi kullanabilmek için [email protected] üzerinden bizimle iletişime geçmelisiniz
| Parametre | Açıklaması |
|---|---|
| thirdPartyClientId | iyzico tarafından verilir. |
| thirdPartyClientId | iyzico tarafından verilir. |
| thirdPartyClientSecret | iyzico tarafından verilir. |
| merchantApiKey | iyzico tarafından verilir. |
| merchantSecretKey | iyzico tarafından verilir. |
| sdkType | Kullanılacak sdk bilgisidir. Alabileceği değerler (pwi) |
| conversationId | Yapılan işlemin uniq değeridir. Random olarak oluşturulmalıdır. |
| locale | Sdk ve akışın dilini belirler. Alabileceği değerler (tr, en) |
| brand | Markanızın ismidir. |
| price | Toplam sepet tutarıdır. |
| paidPrice | Müşterinin ödeyeceği toplam tutardır. |
| currency | Para birimidir. Alabileceği değerler (TRY, USD, EUR, GBP, IRR) |
| enabledInstallments | Bu dizi taksit seçeneklerini belirler. |
| basketId | Üye şirketin sepet ID değeridir. |
| paymentGroup | Alabileceği değerler (PRODUCT, LISTING, SUBSCRIPTION) |
| paymentSource | Ödeme kaynağı |
| urlCallback | İşlemin başarılı yada başarısız olma durumunun bildirileceği URL adresidir Bu adresin geçerli bir SSL sertifikasına sahip olması gerekir. |
| buyer.id | Üye işyeri tarafındaki müşterinin ID’sidir. |
| buyer.name | Üye işyeri tarafındaki müşterinin ismidir |
| buyer.surname | Üye işyeri tarafındaki müşterinin soyadıdır. |
| buyer.identityNumber | Üye işyeri tarafındaki müşterinin kimlik numarasıdır. |
| buyer.email | Üye işyeri tarafındaki müşterinin e-posta adresidir. |
| buyer.gsmNumber | Üye işyeri tarafındaki müşterinin telefon numarasıdır. |
| buyer.registrationAddress | Üye işyeri tarafındaki müşteriye ait kayıt adresidir |
| buyer.city | Üye işyeri tarafındaki müşterinin yaşadığı şehirdir. |
| buyer.country | Üye işyeri tarafındaki müşterinin yaşadığı ülkedir. |
| buyer.ip | Üye işyeri tarafındaki müşterinin IP adresidir. |
| buyer.zipCode | Üye işyeri tarafındaki müşteriye ait kayıtlı posta kodudur. |
| buyer.lastLoginDate | Üye işyeri tarafındaki müşterinin son giriş tarihidir. |
| buyer.registrationAddress | Üye işyeri tarafındaki müşterinin kayıt olduğu tarihtir. |
| shippingAddress.address | Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur. |
| shippingAddress.contactName | Üye işyeri tarafındaki teslimat adresi ad soyad bilgisidir. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType = PHYSICAL) ise zorunludur. |
| shippingAddress.city | Üye işyeri tarafındaki teslimat adresi şehir bilgisidir. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType = PHYSICAL) ise zorunludur. |
| shippingAddress.country | Üye işyeri tarafındaki teslimat adresi ülke bilgisidir. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType = PHYSICAL) ise zorunludur. |
| shippingAddress.zipCode | Üye işyeri tarafındaki teslimat adresi posta kodu bilgisidir. |
| billingAddress.address | Üye işyeri tarafındaki fatura adresidir. |
| billingAddress.contactName | Üye işyeri tarafındaki ad, soyad bilgisidir. |
| billingAddress.city | Üye işyeri tarafındaki fatura adresi şehir bilgisidir. |
| billingAddress.country | Üye işyeri tarafındaki fatura adresi ülke bilgisidir. |
| billingAddress.zipCode | Üye işyeri tarafındaki fatura adresi posta kodu bilgisidir. |
| basketItem.id | Üye işyeri tarafındaki sepetteki ürüne ait id bilgisidir. |
| basketItem.price | Üye işyeri tarafındaki sepetteki ürünün fiyatıdır. |
| basketItem.name | Üye işyeri tarafındaki sepetteki ürünün adıdır. |
| basketItem.category1 | Üye işyeri tarafındaki sepetteki ürüne ait kategoridir. |
| basketItem.category2 | Üye işyeri tarafındaki sepetteki ürüne ait kategoridir. |
| basketItem.itemType | Üye işyeri tarafındaki sepetteki ürüne ait tiptir Alabileceği değerler (PHYSICAL, VIRTUAL) |
| mobileDeviceInfoDto.operatingSystemVersion | Kullanılan mobil cihazın işletim sistemi bilgisidir. |
| mobileDeviceInfoDto.model | Kullanılan mobil cihazın model bilgisidir. |
| mobileDeviceInfoDto.brand | Kullanılan mobil cihazın marka bilgisidir. |
Pay with iyzico, müşterilerin alışverişlerini kolayca yapabildiği ücretsiz ve güvenli bir ödeme yöntemidir.
Pwi içerisinde bulunan akış sırasıyla;
- Kullanıcı Üye giriş / Üye olma işlemini gerçekleştirir.
- OTP girişi gerçekleştirir.
- Ödeme ekranında, ödeme işlemini gerçekleştirir.
- Gerekli olduğu durumda bankanın 3D Koruma ekranına yönlendirilir.
- İşlem başarılı / başarısız tamamlanması durumunda üye iş yerinin vermiş olduğu callback url'ine yönlendirilir.
iyzico mobil sdk bir web projesidir ve mobil webview üzerinde çalışır. Gerekli olan parametreler ise message event’i üzerinden aktarılır. Bu sayede tüm platformlarda (Android, IOS, React Native v.b.) çalışabilme özelliğine sahiptir.
- Projeye Webview entegre edilir. (SADECE MOBIL ENTEGRASYONU İÇİN)
- Webview(IFrame) üzerinden sdk'in web url'i açılır.
- Gerekli olan JSON Objesi oluşturulur. Beklenen Örnek JSON Objesi
- Oluşturulan JSON Objesi string formatına çevrilir.
- Message event'i üzerinden sdk tarafına aktarılır.
- Kullanılacak olan ürüne yönlendirilir.
İşlem sonlandıktan sonra Webview'in kapatılması;
İşlem başarılı / başarısız şekilde sonlanması durumunda sdk initialize edilirken göndermiş olduğunuz JSON içerisindeki callback url'e yönlendirilir. Webview üzerinde yönlendirilen url'ler dinlenerek callback url'inin açılması durumunda webview'i otomatik olarak kapatabilirsiniz.
Android kullanımı için github üzerinde örnek java akışı
IOS kullanımı için github üzerinde örnek swift akışı
React Native kullanımı için github üzerinde örnek javascript akışı