Amazon Türkiye Mağaza API Entegrasyon Rehberi

Amazon Türkiye mağazanızı NİTRU'ya bağlamak için Seller ID, Refresh Token, Client ID ve Client Secret bilgilerine ihtiyacınız var. Amazon, SP-API (Selling Partner API) sistemi kullanır.

1. Amazon Seller Central'a Giriş

sellercentral.amazon.com.tr adresine giriş yapın. Sağ üst köşedeki Ayarlar menüsünden "Kullanıcı İzinleri" seçeneğine tıklayın.

2. Seller ID (Satıcı Kimliği) Bulma

Seller ID'nizi bulmak için:

1. Ayarlar → Hesap Bilgileri sayfasına gidin.
2. "Satıcı Bilgileri" bölümünde "Satıcı Hesap Numarası" veya "Merchant Token" olarak gösterilir.
3. Alternatif olarak URL'deki merchant=XXXXX değeri sizin Seller ID'nizdir.

Bu değer genellikle A ile başlayan 13-14 karakterlik bir koddur (örn: A1B2C3D4E5F6G).

3. SP-API Developer Kaydı

Amazon SP-API'ye erişim için developer kaydı yapmanız gerekir:

1. Ayarlar → Kullanıcı İzinleri sayfasına gidin.
2. Sayfanın alt kısmında "Geliştirici olarak Ziyaret Edin" veya "Developer Central" bağlantısını bulun.
3. Developer Central sayfasında "Yeni Uygulama Kaydet" butonuna tıklayın.
4. Uygulama adı olarak "NİTRU Entegrasyon" gibi bir isim girin.
5. API türü olarak "SP-API" seçin.

Not: Amazon'da developer kaydı onay süreci 1-3 iş günü sürebilir. Onay aldıktan sonra bir sonraki adıma geçebilirsiniz.

4. LWA (Login with Amazon) Credentials

Developer kaydınız onaylandıktan sonra LWA bilgilerinizi oluşturun:

1. Developer Central'da "LWA Credentials" veya "Uygulama Bilgileri" bölümüne gidin.
2. Burada Client ID ve Client Secret bilgilerinizi göreceksiniz.
3. Bu bilgileri güvenli bir yere kaydedin.

5. Refresh Token Alma

Refresh Token, NİTRU'nun sizin adınıza Amazon API'sine erişmesini sağlar:

1. Developer Central'da uygulamanızın detay sayfasına gidin.
2. "Authorize" veya "Yetkilendir" butonuna tıklayın.
3. Amazon size bir yetkilendirme sayfası gösterecek — "İzin Ver" butonuna tıklayın.
4. Yetkilendirme sonrasında bir Refresh Token oluşacaktır.

Önemli: Refresh Token sadece bir kez gösterilir! Mutlaka güvenli bir yere kaydedin. Kaybederseniz yeniden yetkilendirme yapmanız gerekir.

6. Self-Authorization (Kendi Hesabınız İçin)

Eğer sadece kendi mağazanız için entegrasyon yapıyorsanız:

• Developer Central'da "Kendi hesabınızı yetkilendirin" seçeneğini kullanın.
• Bu yöntemle Client ID, Client Secret ve Refresh Token'ı tek adımda alabilirsiniz.
• Oluşan bilgileri NİTRU'ya girin.

Amazon entegrasyonu için Seller ID, LWA Client ID, LWA Client Secret ve Refresh Token bilgileri gereklidir.

7. NİTRU'da Mağaza Ekleme

Tüm 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 Amazon'u seçin.
4. Seller ID, Refresh Token, Client ID ve Client Secret bilgilerinizi girin.
5. Marketplace olarak Amazon.com.tr seçili olduğundan emin olun.
6. "Doğrula" butonu ile bağlantıyı test edin.
7. Bağlantı başarılıysa "Ekle" butonuna tıklayarak mağazanızı kaydedin.

Sık Karşılaşılan Sorunlar

• "Invalid grant" hatası: Refresh Token süresi dolmuş olabilir. Yeniden yetkilendirme yapın.
• "Access denied" hatası: Developer hesabınızın onaylanmış olduğundan emin olun.
• "Invalid client" hatası: Client ID veya Client Secret'ı yanlış girmiş olabilirsiniz. Boşluk olmadan kopyalayın.
• API erişim gecikmesi: Amazon developer onayı 1-3 gün sürebilir. Onay bekleyin.

İpucu: Amazon SP-API bilgileri diğer pazaryerlerine göre daha karmaşık olabilir. Herhangi bir adımda takılırsanız NİTRU destek ekibine ulaşabilirsiniz.

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.