iyzico pazaryeri çözümünün detaylı açıklaması için aşağıdaki örneği inceleyebilirsiniz.
Pazaryeri altında satış yapan 3 adet Alt Üye İşyeri (satıcı = submerchant) olsun. Bu alt üye işyerleri bireysel (C2C), şahıs şirketi (B2C) veya tüzel kişilik (B2C) olabilirler. Bir alıcı 100 TL’lik bir sepet oluşturup 3 farklı satıcıdan, örneğin;
3 farklı ürün alabilir. Bilindiği üzere escrow ürün bazındadır; her ürünün satıcısı farklı olabileceği için sepette yer alan her bir ürünün durumu da farklılık gösterebilir. Örneğin A satıcısı ürünü kargolamış, alıcının eline ulaşmış ve ürüne onay verilmiş olabilir. B satıcısının ürünü iade edilmiş/işlem iptal edilmiş; C satıcısının ürünü ise henüz kargo yapılmak üzere bekliyor olabilir.
iyzico, satıcı ve alıcı arasındaki escrow’a müdahil olmaz; ödemenin tahsilatına aracılık eder ve sepetteki ilgili ürün için üye işyerinden para transferine onay verilmesini bekler. Bu süre zarfında alıcının parası bankada korumalı havuz hesapta beklemektedir.
iyzico Pazaryeri çözümü genel olarak para toplama(collection) ve dağıtma(settlement) süreçlerini kapsamaktadır. Entegrasyonda 3 ana adım bulunmaktadır; adımlar sırasıyla şu şekildedir:
Para transferinin satıcılara (alt üye işyerlerine) yapılabilmesi için bu satıcıların iyzico’ya tek seferlik kaydının yapılması gerekir. Bu da onboarding API ile sağlanır; üye işyeri satıcıyı iyzico’ya kaydettiği anda, istek dönüşünde o satıcı için subMerchanKey alır.
Ödeme esnasında da sepetteki her bir ürünün satıcısı için ilgili subMerchantKey ve bu işlemde satıcıya kaç para gönderilecek ise bu tutar (subMerchantPrice) iletilmelidir.
Ödeme yapılabilen tüm servisler için sepet içerisindeki ürünlere parametreler eklenir. Ödeme, 3D ile ödeme, BKM Express ile ödeme, PECCO ile ödeme ve Ödeme Formu.
| Parametre ismi | Tip | Zorunluluk | Açıklama |
|---|---|---|---|
| subMerchantKey | string | evet | Alt üye işyeri oluşturma sorgusundan dönen değer. |
| subMerchantPrice | string | evet | Alt üye işyerine IBAN adresine gönderilmesi istenen tutar. |
Sandbox(test) hesabı için iyzico'da hesap tipinin pazaryeri hesabı olarak işaretlendiğinden emin olunuz. Sandbox(test) üye işyeri numaranız ile entegrasyon@iyzico.com adresine tanımlama talebinizi iletebilirsiniz.
Görünüm şu şekilde olacaktır;
sepetteki her bir ürün için;
Yukarıdaki örneğe istinaden;
price = 100 paidPrice=110
basketItem 1 price=30 subMerchantPrice=27 subMerchantKey=G2FCFycIof0paTP6687dOoch9Tc=
basketItem 2 price=50 subMerchantPrice=42 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs=
basketItem 3 price=20 subMerchantPrice=18 subMerchantKey=D9V/MqIRitUzA4dutL+nCBvnWfs=
Satıcı ve alıcı arasında escrow tamamlanınca da para transferi için ürüne onay verilmelidir. Entegrasyona geçmeden önce mutlaka alıcı ve satıcıların iyzico sözleşmesini kabul etmesi gerekmektedir.
Pazaryerinizde ödeme akışı iyzico tarafından kontrol edileceği için, alıcılarınızın ve satıcılarınızın, bir kereye mahsus olmak üzere iyzico sözleşmelerini onaylamaları gerekmektedir. Bunun için:
Üyelerinize web siteniz üzerinden iyzico hizmet şartlarını iki ayrı şekilde onaylatabilirsiniz:
Her bir üyeniz için bu işlem tek bir defaya mahsustur. iyzico hizmet şartlarını bir önceki listelemesinde ya da ürün ödemesinde kabul etmiş olan üyenizin, sonraki listeleme ya da ödeme aşamalarında sözleşmeyi tekrardan onaylaması gerekmeyecektir.
Alternatif - 1: Üyelik Sırasında Sözleşme Onaylatma Web sitenizdeki üyelik formunun altına "iyzico Platform Kullanım Sözleşmesi"ni Alıcılarınız için, https://www.iyzico.com/pazaryeri-alici-anlasma/ bağlantı adresinden, Satıcılarınız için https://www.iyzico.com/pazaryeri-satici-anlasma/ bağlantı adresinden iframe ile çekebilir ve pazaryerinize üye olmak isteyen kişilerin aynı zamanda iyzico’ya da otomatik olarak kayıt olmalarını sağlayabilirsiniz.
Alternatif - 2: Ürün Listeleme ya da Ürün Ödeme Sayfasında Kayıt Bu alternatifi kullanarak ayrı ayrı yönlendirmelerle satıcı ve alıcılarınızın iyzico hizmet şartlarını onaylamasını, dolayısıyla birer iyzico üyeliklerinin olmasını sağlayabilirsiniz.
Web siteniz üzerinden ürün satmak isteyen satıcı üyenize, ürün listeleme bölümlerinin herhangi bir aşamasında https://www.iyzico.com/pazaryeri-satici-anlasma/ bağlantı adresinden iyzico hizmet şartlarını iframe ile çekebilir ve satıcılarınıza onaylatabilirsiniz.
Alıcılarınız da almak istedikleri ürün için ödeme yapacakları sayfada tek sefere mahsus, https://www.iyzico.com/pazaryeri-alici-anlasma/ adresindeki iyzico hizmet şartlarını kabul ederek; ürünü teslim alıp onay verene kadar paralarının güvenli bir şekilde iyzico havuz hesabında bekletileceğini kabul etmelidir.