Pazaryeri Entegrasyonu

Satıcı Yönetimi

Pazaryerinize bağlı alt satıcıları ekleyin, güncelleyin, sorgulayın ve listeleyin. Her satıcı bir ödeme profiliyle ilişkilendirilir.

Satıcı Tipleri

Tip	Kod	Açıklama	Kimlik
Gerçek Kişi	1	Bireysel satıcılar	11 haneli TCKN
Şahıs Şirketi	2	Tek kişilik şirketler	11 haneli TCKN
Tüzel Kişi Şirketi	3	Limited, anonim şirketler	10 haneli VKN

CreateSeller

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

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

İstek — JSON

{
  "sellerExternalId": "SELLER_001",
  "nameSurname": "Ahmet Yılmaz",
  "sellerType": 1,
  "tckn": "12345678901",
  "vkn": null,
  "birthDate": "15.05.1985",
  "taxOffice": "Kadıköy",
  "contactPerson": "Ahmet Yılmaz",
  "email": "ahmet@example.com",
  "phoneNumber": "5551234567",
  "city": "34",
  "address": "Atatürk Cad. No:123 Kadıköy",
  "iban": "TR330006100519786457841326",
  "accountHolder": "Ahmet Yılmaz",
  "apiSecretKey": "sx_value_here",
  "active": true,
  "mpPaymentProfileExternalId": "PREMIUM_PROFILE"
}

Parametre	Tip	Zorunlu	Açıklama
sellerExternalId	String	✅	Tekil dış ID — kendi sisteminizdeki satıcı ID'si
nameSurname	String	✅	Ad soyad (gerçek/şahıs) veya şirket adı (tüzel)
sellerType	Integer	✅	1 = Gerçek Kişi, 2 = Şahıs Şirketi, 3 = Tüzel Kişi
tckn	String	✅*	11 haneli TCKN — tip 1 ve 2 için zorunlu
vkn	String	✅*	10 haneli VKN — tip 3 için zorunlu
birthDate	String	❌	Doğum tarihi (dd.MM.yyyy)
taxOffice	String	❌	Vergi dairesi adı
contactPerson	String	❌	İrtibat kişisi
email	String	❌	E-posta adresi
phoneNumber	String	❌	Cep telefonu (5551234567 biçiminde)
city	String	❌	Şehir plaka kodu (34, 06, 35…)
address	String	❌	Adres
iban	String	✅	IBAN (TR ile başlamalı, 26 karakter)
accountHolder	String	❌	Hesap sahibi adı — nameSurname ile aynı olmalı
apiSecretKey	String	✅	Pazaryerine ait SX değeri
active	Boolean	❌	Satıcı aktif mi? (varsayılan: true)
mpPaymentProfileExternalId	String	✅	Atanacak ödeme profili ID'si

Yanıtta satıcı, bağlı olduğu paymentProfile nesnesi ve marketplaceCode ile birlikte döner. Tüzel kişi için sellerType: 3 + vkn gönderilir, tckn boş bırakılır.

GetSellerById

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

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

İstek — JSON

{
  "apiSecretKey": "sx_value",
  "sellerExternalId": "SELLER_001"
}

UpdateSeller

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

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

Tüm parametreler gönderilmelidir; sellerType ve tckn/vkn gibi temel kimlik bilgileri değiştirilemez. Güncellenmeyecek alanları mevcut değerleriyle yollayın.

DeleteSellerById

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

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

Bekleyen ödemesi olan satıcılar silinemez ve silme işlemi geri alınamaz. Satıcıyı silmek yerine active: false ile pasifleştirmeyi düşünün.

GetAllSellerByApiSecretKey

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/seller/sellers

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/seller/sellers

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

GetSellersByPaymentProfile

Belirli bir ödeme profiline atanmış satıcıları listeler — örneğin bir profilin komisyonunu değiştirmeden önce hangi satıcıları etkileyeceğini görmek için.

TESTPOST https://apitest.paynkolay.com.tr/marketplace/v1/seller/sellers/byPaymentProfile

PRODPOST https://api.paynkolay.com.tr/marketplace/v1/seller/sellers/byPaymentProfile

İstek — JSON

{
  "apiSecretKey": "sx_value",
  "profileExternalId": "PREMIUM_PROFILE",
  "active": null
}

Geçersiz bir profileExternalId gönderilirse servis HTTP 400 ile status: "REJECTED" içeren hata yanıtı döner.

Göndermeden Önce Doğrulayın

IBAN: TR ile başlamalı, 26 karakter olmalı (mod-97 kontrolü önerilir)
TCKN: 11 hane, ilk hane 0 olamaz (checksum algoritmasıyla doğrulanabilir)
VKN: 10 hane (checksum algoritmasıyla doğrulanabilir)

Bu sayfa yardımcı oldu mu?

Son güncelleme: 5 Eylül 2026