Pazaryeri Entegrasyonu

Ödeme Profili Yönetimi

Ödeme profili; komisyon oranları, işlem ücretleri, ödeme günleri ve valör kurallarını içeren yapılandırma setidir. Farklı satıcı gruplarına farklı profiller atayabilirsiniz.

Ödeme Profili Nedir?

Pazaryeri, satıcılarıyla farklı ödeme profillerinde çalışabilir — örneğin premium satıcılara %2, standart satıcılara %5, yeni satıcılara %7 komisyon uygulayabilirsiniz.

Valör Hesaplama Tipleri

Profilde tanımlanan valör tipi, satıcıya ödemenin ne zaman yapılacağını belirler:

Kod	Tip	Açıklama
W	WEEKLY	Haftalık — haftanın belirli gününde ödeme yapılır
H	HALF_MONTHLY	Yarım aylık — ayda iki kez ödeme yapılır
M	MONTHLY	Aylık — ayın belirli gününde ödeme yapılır
T	TRANSACTION	İşlem tarihi temelli — işlemden N gün sonra ödeme yapılır
D	DELIVERY	Teslim tarihi temelli — teslimattan N gün sonra ödeme yapılır

Teslim tarihi bazlı (D) profillerde satıcıya ödeme, teslimat tarihi bildirilmeden yapılmaz — her işlemin teslimatını UpdateDeliveryDate servisiyle bildirmeniz gerekir.

CreatePaymentProfile

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/paymentprofile

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/paymentprofile

İstek — JSON

{
  "profileExternalId": "IslemValor1",
  "apiSecretKey": "sx_value_here",
  "name": "Premium Satıcı Profili",
  "mpCommissionRate": 5.00,
  "mpCost": 0.50,
  "paymentDay": null,
  "valorDateCount": 1,
  "valorCalculationType": "T",
  "active": true
}

Parametre	Tip	Zorunlu	Açıklama
profileExternalId	String	✅	Tekil dış ID — kendi sisteminizdeki ID
apiSecretKey	String	✅	Pazaryerine ait SX değeri
name	String	❌	Profil adı
mpCommissionRate	BigDecimal	✅	Pazaryeri komisyon oranı (%)
mpCost	BigDecimal	❌	İşlem başına sabit ücret (TL)
paymentDay	Integer	✅*	Ödeme günü (1-7, pazartesi=1) — haftalık/aylık profillerde zorunlu
valorDateCount	Integer	✅	Para transferi için bekleme süresi (gün)
valorCalculationType	String	✅	Valör tipi: W, H, M, T, D
active	Boolean	❌	Profil aktif mi? (varsayılan: true)

Örnekteki profil, işlem yapıldıktan 1 gün sonra ödeme yapan işlem-temelli (T) bir profildir. Yanıtta profil, marketplaceCode ve tarih alanlarıyla birlikte döner.

GetPaymentProfileById

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/paymentprofile/get

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/paymentprofile/get

İstek — JSON

{
  "profileExternalId": "IslemValor1"
}

UpdatePaymentProfile

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/paymentprofile/update

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/paymentprofile/update

Güncellemede tüm parametreler gönderilmelidir; değiştirmek istemediğiniz alanları mevcut değerleriyle yollayın.

DeletePaymentProfileById

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/paymentprofile/delete

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/paymentprofile/delete

Aktif satıcılara atanmış profilleri silemezsiniz — önce satıcıları başka bir profile geçirmeniz gerekir.

GetAllPaymentProfileByApiSecretKey

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/paymentprofile/list

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/paymentprofile/list

Parametre	Tip	Zorunlu	Açıklama
apiSecretKey	String	✅	Pazaryerine ait SX değeri
active	Boolean	❌	true = sadece aktif, false = sadece pasif, null = tümü

Örnek Profil Kurguları

Premium Satıcı

%3 komisyon, işlem ücreti yok
valorDateCount: 1 — ertesi gün ödeme
valorCalculationType: "T"

Standart Satıcı

%5 komisyon + 0.50 TL işlem ücreti
valorDateCount: 3
valorCalculationType: "T"

Haftalık Ödemeli

%5 komisyon
paymentDay: 1 — her pazartesi
valorCalculationType: "W"

Teslimat Sonrası

%4 komisyon
Teslimattan 2 gün sonra ödeme
valorCalculationType: "D" + UpdateDeliveryDate

Bu sayfa yardımcı oldu mu?

Son güncelleme: 5 Eylül 2026