İki ortamın farkı
| Konu | Canlı ortam | Test (stage) ortamı |
|---|---|---|
| API adresi | https://apigw.trendyol.com | https://stageapigw.trendyol.com |
| Satıcı paneli | partner.trendyol.com | stagepartner.trendyol.com |
| IP yetkilendirmesi | Gerekmez | Zorunlu; ağ çıkış IP'niz tanımlanmalı |
| API bilgileri | Canlı mağazanın Entegrasyon Bilgileri | Test hesabının Hesap Bilgilerim sayfası |
| Test servisleri | Yok | Test siparişi, test statüsü, test sorusu |
Canlıda IP kısıtı olmasa da Trendyol bazı nedenlerle bir IP'yi engelleyebilir. Her iki ortamda erişim sorunu yaşarsanız IP adresinizle birlikte satıcı paneli üzerinden bildirim açmanız istenir.
Test ortamına erişim adımları
- Uygulama sunucunuzun ağ çıkış IP adresini öğrenin. Ev ya da ofis IP'si değil, isteği gönderen sunucunun IP'si gerekir.
- IP yetkilendirmesini talep edin. Doküman bunun için satıcı bildirimi açılmasını ister; bildirimle iletilen IP 24 saat içinde tanımlanır.
- Ortak test hesabını kullanın ya da özel test hesabı isteyin. Özel hesap için e-posta, telefon ve şirketinizin TCKN veya VKN bilgisi yeterlidir.
- stagepartner.trendyol.com paneline girip Hesap Bilgilerim bölümünden test API bilgilerini alın.
- İlk isteği stageapigw.trendyol.com adresine gönderin. 503 alırsanız IP tanımını kontrol edin.
IP whitelist servisi
Trendyol, test ortamı IP listesini API ile yönetmenize de izin verir. Üç işlem aynı adreste çalışır: listeleme GET, ekleme POST, silme DELETE ile yapılır. Silmede IP adresi yolun sonuna eklenir.
| Kural | Değer |
|---|---|
| Desteklenen adres türü | Yalnız IPv4; IPv6 kabul edilmez |
| Listede aynı anda en fazla | 7 IP |
| Günlük ekleme isteği | En fazla 7 |
| Geçerlilik | Her kayıt için sistem bir son geçerlilik tarihi (expiresAt) üretir |
| Başarılı ekleme | HTTP 201 ve eklenen kaydın expiresAt bilgisi |
| Başarılı silme | HTTP 204, gövde yok |
Ekleme isteğinin gövdesinde yalnız ip alanı bulunur, örneğin ip: 203.0.113.10. Silinen IP yedi IP'lik kotada yer açar ama günlük ekleme sayacını sıfırlamaz. Süresi dolan kayıt geçersiz olur; uzun süren testlerde expiresAt tarihini izleyin.
Sık hatalar ve çözümleri
| Hata | Anahtar | Çözüm |
|---|---|---|
| Test ortamında 503 | - | Sunucu IP'niz yetkili değil; IP'yi whitelist'e ekleyin ya da bildirim açın. |
| 400 | ip.whitelist.ip.invalid | IPv4 biçiminde bir adres gönderin. |
| 409 | ip.whitelist.already.active | IP zaten listede; yeni istek gerekmez. |
| 422 | ip.whitelist.security.check.failed | IP güvenlik kontrolünden geçemedi; başka bir çıkış IP'si deneyin. |
| 429 | ip.whitelist.limit.exceeded | 7 IP ya da günlük 7 ekleme sınırı doldu; kullanılmayan IP'yi silin, ertesi gün deneyin. |
| 401 | - | Basic Auth bilgisi eksik ya da hatalı. |
Testte çalışan bir akışı canlıya alırken yalnız temel adresi ve API bilgilerini değiştirin. Test servisleri (test siparişi gibi) canlıda yoktur; bu çağrıları canlı kod yolundan çıkarın. Ayrıntılar için test siparişi oluşturma sayfasına bakın.
Sık sorulanlar
Trendyol canlı ortamda IP whitelist gerekir mi?
Hayır. Doküman canlı ortamda IP yetkilendirmesi gerekmediğini söyler. Yine de bir IP engellenmişse IP adresinizle birlikte satıcı panelinden bildirim açmanız istenir.
Test ortamında neden 503 hatası alıyorum?
Trendyol dokümanına göre test ortamındaki 503 hatası IP yetkilendirmesi olmamasından kaynaklanır. İsteği gönderen sunucunun çıkış IP'sini yetkilendirin.
Test ortamına kaç IP ekleyebilirim?
Whitelist'te aynı anda en fazla 7 IPv4 adresi bulunabilir. Günde en fazla 7 ekleme isteği gönderilebilir; silme işlemi bu günlük sayacı sıfırlamaz.
Test ortamı API bilgilerini nereden alırım?
Test hesabıyla stagepartner.trendyol.com paneline girip Hesap Bilgilerim bölümünden alırsınız. Canlı mağazanızın anahtarları test ortamında geçerli değildir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı