.nodeJs | Pazaryeri Entegrasyonu
Pazaryeri modelinde, ödemeleriniz tek bir hesapta toplandıktan sonra sizin tarafınızdan verilen onay sonrasında, alt üye işyerlerine otomatik olarak gönderilir. Onay verme işlemi sonrası alt üye işyerine ve pazaryeri sahibi olan üye işyerine para gönderimi iyzico tarafından yapılmaktadır. Aşağıda bu ürünümüzün işleyişini paylaşıyoruz.
iyzico pazaryeri entegrasyon dokümanına https://docs.iyzico.com/urunler/pazaryeri üzerinden ulaşabilirsiniz.
Alt Üye İşyeri Oluşturma
Pazaryeri modelinde ödeme alabilmek için, iyzico tarafında oluşturduğunuz üye işyerine bağlı alt üye işyerleri oluşturmanız gerekmektedir.
Örnek Kod ve Dokümanlar
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L1185
https://docs.iyzico.com/urunler/pazaryeri/pazaryeri-entegrasyonu/alt-uye-olusturma
Ödeme Formu Oluşturma ve Ödeme Alma
Ödeme formu oluştururken, alt üye işyerinizi belirterek formu oluşturmanız gerekmektedir. Bu, hangi ürünün kimden alındığını ve kime ne kadar para aktarılacağını belirtmek için önemlidir.
Örnek Kod ve Dokümanlar
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L268
https://docs.iyzico.com/odeme-metotlari/odeme-formu/cf-entegrasyonu/cf-baslatma
Yukarıda kod standart tipteki (Pazaryeri olmayan) ödeme formunu oluşturmaktadır. Pazaryeri formunun standart formdan tek farkı basketItems’ların içerisine aşağıdaki parametrelerin eklenmesidir.
subMerchantKey("sub merchant key"); // Alt üye işyerini belirtir.
subMerchantPrice("0.27"); // Alt üye işyerine aktarılacak tutarı belirtir.
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L653
Pazaryerinde Stopaj Uygulaması
Pazaryeri entegrasyonlarında, stopaj uygulaması yeni düzenlemelere uygun olarak çalışmaktadır.
withholdingTax Parametresi: Gönderilmesi zorunlu değildir ve iyzico tarafından herhangi bir hesaplama için kullanılmaz. Bu parametre, ödeme sonuçları ve para gönderim raporlarında, alt üye işyerine uygulanan kesinti tutarını göstermek için kullanılır.
subMerchantPrice Parametresi: Alt üye işyerine aktarılacak net tutarı belirtmek için kullanılır.
Daha fazla bilgi için https://docs.iyzico.com/urunler/pazaryeri/pazaryeri-entegrasyonu/pazaryerlerinde-stopaj-uygulamasi doküman sayfasını ziyaret edebilirsiniz.
Kısaca pazaryeri akış şemasını size 100 TL tutarında bir üründen örneklendirmek isteriz. iyzico’nun 4 TL komisyonu olduğunu varsayalım. Alt üye işyerinin hak edişi ise 80 TL olsun.
iyzico toplam tutardan kendi komisyonunu alır. 100 – 4 = 96 TL
Ardından submerchantPrice ile belirtilen tutar alt üye işyerine aktarılır. 96 – 80 = 16 TL
Son olarak kalan bu tutar size aktarılır.
Alt üye işyeri Güncelleme
İlgili işlemdeki alt üyeyi veya alt üyenize gönderilecek tutarı güncellemek istiyorsanız iyzico’ nun tutar güncelleme servisini çağırmalısınız.
Örnek Kod ve Dokümanlar
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L1025
https://docs.iyzico.com/urunler/pazaryeri/pazaryeri-entegrasyonu/alt-uye-olusturma/alt-uye-urun-guncelleme
Para Gönderimi ve Onay Süreçleri
Eğer belirtmiş olduğunuz hizmet tamamlandıysa ve siz para aktarımını onaylıyorsanız, iyzico’nun onay servisini çalıştırmalısınız.
Örnek Kod ve Dokümanlar
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L40
https://docs.iyzico.com/urunler/pazaryeri/pazaryeri-entegrasyonu/onay#onay-verme
Onayın İptal Süreci
Yanlışlıkla onay verdiyseniz ve bu onayı geri almak istiyorsanız, iyzico'nun onayı iptal etme servisini çağırabilirsiniz.
Örnek Kod ve Dokümanlar
https://github.com/iyzico/iyzipay-node/blob/master/samples/IyzipaySamples.js#L54
https://docs.iyzico.com/urunler/pazaryeri/pazaryeri-entegrasyonu/onay#onay-kaldirma
Daha fazla bilgi ve diğer entegrasyon seçenekleri için https://docs.iyzico.com/ sayfasını ziyaret edebilirsiniz.