İstek
| Alan | Yer | Açıklama |
|---|---|---|
| sellerId | Yol | Satıcı ID; 2025 adres değişikliğinde yola eklendi |
| claimId | Yol | İade kimliği; iade çekme servisinden alınır |
| claimLineItemIdList | Gövde | Onaylanacak iade kalemi kimliklerinin dizisi |
| params | Gövde | Ek parametreler; boş nesne gönderilebilir |
Örnek gövde: claimLineItemIdList: ["IADE_KALEM_ID_1", "IADE_KALEM_ID_2"], params: {}. Kalem kimlikleri iade kaydındaki claimItems dizisindeki id değerleridir; sipariş kalemi (orderLine) kimliği değildir.
Uluslararası doküman sürümü (v3.0) bu istekte storeFrontCode başlığının gönderilmesini ister. Türkiye sayfasında başlıktan söz edilmez; Türkiye mağazası için değer TR'dir.
Onaydan sonra ne olur?
| Adım | Statü |
|---|---|
| İade ürünü depoya ulaştı | WaitingInAction |
| Satıcı onayladı | WaitingFraudCheck (belirli kurallarda) |
| Kontrol tamamlandı | Accepted |
Fraud kontrolü her iadede yapılmaz; belirli kurallara göre devreye girer. Onay sonrası iadenin son durumunu iade çekme servisinden izleyin. Finansal etkisi cari hesap ekstresinde Return türündeki kayıtlarda görünür.
Limit: dakikada 5 istek
İade onaylama servisinin limiti çok düşüktür: dakikada 5 istek. Toplu onay yapacaksanız şu düzeni kurun:
- Onaylanacak iadeleri bir kuyruğa alın.
- Aynı iadenin birden çok kalemini tek istekte, claimLineItemIdList dizisiyle gönderin.
- İstekler arasında en az 12 saniye bırakın.
- 429 alırsanız bekleme süresini artırarak yeniden deneyin.
- Kullanıcı arayüzünde onay düğmesine art arda basılmasını engelleyin.
Onaylamadan önce kontrol listesi
İade onayı geri alınamayan bir karardır. Onay isteği göndermeden önce şu kontrolleri yapın:
- Ürün gerçekten depoya ulaştı mı ve iade WaitingInAction statüsünde mi?
- Gelen ürün siparişteki ürünle aynı mı; adet ve aksesuarlar tam mı?
- Ürün kullanılmış, hasar görmüş ya da hijyen ambalajı açılmış mı? Öyleyse onay yerine ret talebi açın ve kanıt fotoğrafı ekleyin.
- Müşterinin iade sebebi (customerClaimItemReason) ile ürünün durumu uyuşuyor mu?
- Birden çok kalem varsa hepsini aynı istekte mi onaylıyorsunuz?
Kontrolleri depoda ürünü açarken yapmak ve sonucu iade kaydına not etmek, ileride ihtilaf çıkarsa elinizi güçlendirir.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 400 | İade WaitingInAction değil ya da kalem kimliği yanlış | İadeyi yeniden çekin; statüyü ve claimItems kimliklerini kontrol edin |
| 404 | Yol eksik ya da eski adres kullanılıyor | Yolun /items/approve ile bittiğini ve apigw.trendyol.com adresine gittiğini kontrol edin |
| 401 ya da 429 art arda | Dakikada 5 istek sınırı | İstekleri yayın, kuyruk kullanın |
| Onaylandı ama Accepted görünmüyor | Fraud kontrolü sürüyor | WaitingFraudCheck statüsünü bekleyin |
Ürün hasarlı, eksik ya da farklı geldiyse onay yerine ret talebi oluşturun. Onaylanan iade için sonradan ret açılamaz.
Sık sorulanlar
Trendyol iadesini API ile nasıl onaylarım?
PUT /integration/order/sellers/{sellerId}/claims/{claimId}/items/approve servisine claimLineItemIdList dizisiyle iade kalemi kimliklerini gönderin. İade WaitingInAction statüsünde olmalıdır.
Hangi iadeler onaylanabilir?
Yalnız WaitingInAction statüsündeki, yani ürünü deponuza ulaşmış iadeler onaylanabilir.
Onay sonrası neden WaitingFraudCheck görünüyor?
Onaylanan iadeler belirli kurallar çerçevesinde fraud kontrolüne girebilir. Kontrol bitince statü Accepted olur.
İade onaylama limiti nedir?
Dakikada 5 istek. Aynı iadenin kalemlerini tek istekte gönderin ve toplu onaylarda istekleri zamana yayın.
claimLineItemIdList içine hangi kimlik yazılır?
İade kaydındaki claimItems dizisinde yer alan iade kalemi kimlikleri yazılır. Sipariş kaleminin (orderLine) kimliği bu alanda kullanılmaz.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı