Pazarama Mağaza API Entegrasyon Rehberi

Pazarama mağazanızı NİTRU'ya bağlamak için Client ID, Client Secret ve Seller ID bilgilerine ihtiyacınız var. Pazarama, OAuth 2.0 tabanlı modern bir API sistemi kullanır.

1. Pazarama Satıcı Paneline Giriş

isortagim.pazarama.com adresine satıcı hesabınızla giriş yapın. Bu, Pazarama'nın satıcı yönetim panelidir (Turkcell ekosistemi).

1. Hesabım Sayfasına Gidin

Pazarama satıcı panelinde sol menüden Hesabım bölümüne girin.

2. Entegrasyon Bilgileri Sekmesi

Hesabım sayfasındaki Entegrasyon Bilgileri sekmesine tıklayın.

3. API Anahtarlarını Kopyalayın

Bu sayfada API Key ve API Secret değerlerini göreceksiniz. Her ikisini de kopyalayın.

4. Detaylı API Bilgileri

Yukarıdaki ekranda tüm adımlar numaralandırılmıştır: 1) Hesabım menüsü, 2) Hesap Bilgileri, 3) Entegrasyon Bilgileri sekmesi, 4) Satıcı ID, API Key ve API Secret alanları.

2. Entegrasyon Sayfasına Erişim

API bilgilerinize ulaşmak için:

1. Sol menüden "Entegrasyon" veya "Ayarlar" sekmesine tıklayın.
2. "API Entegrasyon Bilgileri" veya "Geliştirici Ayarları" sayfasına gidin.

Alternatif yol: Hesap Ayarları → Entegrasyon → API Bilgileri

3. OAuth 2.0 Kimlik Bilgileri

Pazarama OAuth 2.0 protokolü kullanır. Bu, modern ve güvenli bir kimlik doğrulama yöntemidir:

1. Entegrasyon sayfasında "Uygulama Oluştur" veya "API Erişimi Talep Et" butonuna tıklayın.
2. Uygulama adı olarak "NİTRU Entegrasyon" yazabilirsiniz.
3. Sistem size aşağıdaki bilgileri üretecektir:
   • Client ID: Uygulamanızın benzersiz kimliği
   • Client Secret: Gizli anahtar (güvenli saklayın!)

Önemli: Client Secret sadece oluşturulduğunda gösterilir. Mutlaka güvenli bir yere kaydedin. Kaybederseniz yeni uygulama oluşturmanız gerekir.

4. Seller ID (Satıcı Kimliği)

Seller ID bilginizi bulmak için:

• Satıcı panelinin "Mağaza Bilgileri" veya "Hesap Bilgileri" sayfasına gidin.
• "Satıcı No", "Mağaza ID" veya "Seller ID" olarak gösterilen değeri kopyalayın.
• Bu genellikle sayısal bir ID'dir.

5. Token Alma Süreci

OAuth 2.0 sisteminde API erişimi token bazlı çalışır:

• NİTRU, Client ID ve Client Secret'ı kullanarak otomatik olarak Access Token alır.
• Token süresi dolduğunda NİTRU otomatik olarak yeniler — sizin bir şey yapmanız gerekmez.
• Bu süreç arka planda tamamen otomatik yönetilir.

6. API Erişim Kapsamı

Pazarama API'si aşağıdaki servisleri kapsar:

• Ürün Yönetimi: Ürün listeleme, oluşturma, güncelleme
• Sipariş Yönetimi: Sipariş listeleme ve durum güncelleme
• Stok & Fiyat: Stok ve fiyat güncelleme
• Kategori: Kategori ağacı ve özellikleri
• Komisyon: Komisyon bilgileri sorgulama

Pazarama için Satıcı ID, API Key ve API Secret bilgileri gereklidir. Tüm bilgiler GUID formatındadır.

7. NİTRU'da Mağaza Ekleme

API bilgilerinizi aldıktan sonra NİTRU panelinde:

1. Mağaza Yönetimi sayfasına gidin.
2. "Yeni Mağaza" butonuna tıklayın.
3. Platform olarak Pazarama'yı seçin.
4. Client ID, Client Secret ve Seller ID bilgilerinizi girin.
5. "Doğrula" butonu ile bağlantıyı test edin.
6. Bağlantı başarılıysa "Ekle" butonuna tıklayarak mağazanızı kaydedin.

İpucu: Pazarama entegrasyonu OAuth 2.0 kullandığı için bağlantı kurulduktan sonra ayrıca token yenilemeniz gerekmez. NİTRU bu süreci tamamen otomatik yönetir.

Turkcell Ekosistemi Avantajları

Pazarama, Turkcell grubuna ait bir pazaryeridir:

• Turkcell müşterilerine özel kampanyalar ve görünürlük avantajı sunar.
• Paycell ile ödeme entegrasyonu sayesinde geniş müşteri kitlesine ulaşırsınız.
• Komisyon oranları diğer pazaryerlerine göre rekabetçi olabilir.

Sık Karşılaşılan Sorunlar

• "Invalid client" hatası: Client ID veya Client Secret yanlış girilmiş olabilir. Boşluk olmadan kopyaladığınızdan emin olun.
• "Unauthorized" hatası: API erişim talebiniz henüz onaylanmamış olabilir. Pazarama destek ekibiyle iletişime geçin.
• Token hatası: NİTRU token'ları otomatik yeniler, ancak nadiren Client Secret değişmiş olabilir. Bu durumda mağaza ayarlarından bilgileri güncelleyin.
• Seller ID bulunamıyor: Seller ID'niz satıcı panelindeki hesap bilgileri sayfasında yer alır. Satıcı destek hattından da öğrenebilirsiniz.

NİTRU Mağaza Yönetimi sayfasında tüm bağlı mağazalarınızı, API bağlantı durumlarını ve ürün sayılarını görebilirsiniz.