PayTR Hata Kodları: Detaylı Rehber

PayTR entegrasyonlarında, bazen işlem sırasında hata kodları ile karşılaşabilirsiniz. Bu makalede, PayTR tarafından ödeme, iade, durum sorgu ve transfer taleplerinde gönderilebilecek tüm hata kodlarını ve anlamlarını ayrıntılı bir şekilde bulabilirsiniz.

Ödeme İşlemi Sonrasında Bankaya Gitmeden Dönen Hata Kodları

failed_reason_code	failed_reason_msg	Açıklama
0	Değişken (Detaylı hata mesajı)	Örnek: Kart limiti/bakiyesi yetersiz
1	Kimlik Doğrulama yapılmadı	Cep telefonu numarası girilmedi
2	Kimlik Doğrulama başarısız	Doğrulama kodu hatalı girildi
3	Güvenlik kontrolü başarısız	Fraud tespiti veya kontrol hatası
6	Müşteri ödeme yapmaktan vazgeçti	Sayfa kapatıldı veya süre aşımı
8	Taksit desteklenmiyor	Kart tipi ile taksit uyumsuzluğu
9	Kart ile işlem yetkisi yok	Mağaza yetkilendirilmemiş
10	3D Secure zorunlu	3D Secure ile ödeme gerekli
11	Güvenlik uyarısı	Şüpheli işlem tespiti
99	Teknik entegrasyon hatası	Entegrasyon problemleri

İade API Servisinden Dönen Hata Kodları

err_no	err_msg	Açıklama
000	İade yapılamıyor	Sistem yoğunluğu veya kilitlenme
001	Geçersiz istek veya mağaza pasif	merchant_id eksik veya pasif
002	Geçersiz merchant_oid	Sipariş numarası iletilemedi
003	Geçersiz return_amount	İade tutarı gönderilmedi
004	Hatalı paytr_token	Token eksik veya geçersiz
005	Başarılı ödeme bulunamadı	İlgili sipariş yok
007	Bildirim tamamlanmadı	Sipariş işlemi henüz bitmedi
008	Ödeme tipi iade desteklemiyor	Belirli ödeme yöntemi iade dışı
009	İade tutarı fazla	Kalan tutardan fazla iade
010	Net bakiye yetersiz	Hesapta yeterli bakiye yok
011	Bir yıldan eski işleme iade olmaz	Yıllık süre aşımı

Durum Sorgu Servisinden Dönen Hata Kodları

err_no	err_msg	Açıklama
001	Geçersiz istek veya mağaza pasif	merchant_id eksik
002	Geçersiz merchant_oid	Sipariş numarası eksik
003	Hatalı paytr_token	Token eksik veya yanlış
004	İşlem bulunamadı	Sipariş yok veya başarısız

Platform Transfer Talebi Hataları

err_no	err_msg	Açıklama
001	Geçersiz istek veya mağaza pasif	merchant_id eksik
002	Yetkiniz yok	Mağaza pazaryeri değil
003	Geçersiz trans_id	transfer ID eksik
004	paytr_token geçersiz	Token eksik veya hatalı
005	Geçersiz merchant_oid	Sipariş numarası eksik
006	Başarılı ödeme yok	Sipariş bulunamadı
007	Bildirim tamamlanmadı	Sipariş bildirimi eksik
008	Valör tarihi geçmedi	Valör tarihi beklenmeli
009	trans_id tekrar kullanıldı	Benzersiz ID zorunlu
010	Transfer tutarı fazla	Kalan tutardan fazla transfer
091	IBAN doğrulama başarısız	IBAN hatalı
092	IBAN formatı yanlış	TR ile başlamalı, 26 karakter
095	Alt satıcı tutarı 0'dan küçük	Hatalı işlem
096	trans_id formatı hatalı	Sadece alfanumerik karakterler
097	IBAN eksik	transfer_iban alanı boş
098	transfer_name eksik	transfer_name alanı boş
099	total_amount hatalı	Sayısal değer bekleniyor
100	Ad-Soyad format hatası	Boşluksuz ad/soyad hatalı
101	Ad veya soyad eksik	Her biri min 2 karakter olmalı
201-306	JSON hataları, benzersiz trans_id kontrolleri	JSON doğrulama ve özel kurallar

Sonuç:

Bu hata kodlarını şeffaf bir şekilde doğrulamak ve her hata durumunda sisteminizde doğru aksiyonlar almak, PayTR ödeme altyapısı entegrasyonunuzun sağlıklı çalışması için kritik öneme sahiptir.

Daha detaylı PayTR entegrasyon rehberleri ve çözümler için Eka Sunucu Bilgi Merkezi üzerinden veya PayTR Hata Kodları ulaşabilirsiniz.