PayTR servislerinden dönen Hata Kodlarına ait tablolar
ÖDEME İŞLEMİ SONRASI BANKAYA GİTMEDEN PAYTR TARAFINDAN BİLDİRİM URL ADRESİNİZE DÖNÜLEN HATA KODLARI VE AÇIKLAMALARI
| failed_reason_code | failed_reason_msg | Açıklama |
|---|---|---|
| 0 | DEĞİŞKEN (AÇIKLAMAYI OKUYUN) | Ödemenin neden onaylanmadığına ilişkin,detaylı hata mesajı (Örneğin: Kartın limiti /bakiyesi yetersiz). |
| 1 | Kimlik Doğrulama yapılmadı. Lütfen tekrar deneyin ve işlemi tamamlayın. | Müşteri, kimlik doğrulama adımında cep telefonu numarasını girmedi. |
| 2 | Kimlik Doğrulama başarısız. Lütfen tekrar deneyin ve şifreyi doğru girin. | Müşteri, cep telefonuna gelen şifreyi doğru girmedi. |
| 3 | Güvenlik kontrolü sonrası onay verilmedi veya kontrol yapılamadı. | Müşterinin işlemi PayTR tarafından güvenlik kontrolünden geçemedi veya kontrol yapılamadı. |
| 6 | Müşteri ödeme yapmaktan vazgeçti ve ödeme sayfasından ayrıldı. | Müşteri, kendisine tanınmış olan işlem süresinde(1. ADIM’da tanımlanan request_exp_date değeri) işlemini tamamlamadı veya müşteri ödeme sayfasını kapatarak işlemi sonlandırdı. |
| 8 | Bu karta taksit yapılamamaktadır. | Müşterinin kullanmakta olduğu kart ile seçmiş olduğu taksitli ödeme yöntemi kullanılamaz. |
| 9 | Bu kart ile işlem yetkisi bulunmamaktadır. | Müşterinin kullanmakta olduğu kart için mağazanızın işlem yetkisi bulunmuyor. |
| 10 | Bu işlemde 3D Secure kullanılmalıdır. | Müşteri, yapmış olduğu işlemde 3D Secure ile ödeme yapmalıdır. |
| 11 | Güvenlik uyarısı. İşlem yapan müşterinizi kontrol edin. | Müşterinin işleminde fraud tespiti bulunuyor. Güvenliğiniz için müşterinin işlemlerini kontrol edin. |
| 99 | İşlem başarısız: Teknik entegrasyon hatası. | Teknik entegrasyon hatası varsa dönülecektir. (debug_on değeri 0 ise) |
İADE API SERVİSİ ÜZERİNDEN DÖNÜLEN HATA KODLARI VE AÇIKLAMALARI
| err_no | err_msg | Açıklama |
|---|---|---|
| 000 | iade yapilamiyor, daha sonra tekrar deneyin | Ödeme çıkışı esnasında iade servisinin kilitlenmesi durumunda yaşanmaktadır. Bir süre sonra tekrar deneyebilirsiniz. |
| 001 | Gecersiz istek veya magaza aktif degil | İstekte merchant_id bilgisinin iletilmemesi veya mağazanın aktif olmaması durumunda dönülmektedir. |
| 002 | Gecersiz merchant_oid | İstekte merchant_oid alanını iletmemeniz durumunda dönülmektedir. |
| 003 | Gecersiz return_amount | İstekte return_amount alanını iletmemeniz durumunda dönülmektedir. |
| 004 | paytr_token gonderilmedi veya gecersiz | paytr_token alanının iletilmemesi veya doğru olmaması durumunda dönülmektedir. |
| 005 | merchant_oid ile basarili odeme bulunamadi | İlettiğiniz sipariş numarası ile başarılı bir ödemenin olmadığı durumda dönülmektedir. |
| 007 | merchant_oid bulundu ancak odeme henuz siteye bildirilmemis | İlettiğiniz sipariş numarasının bildirim akışının tamamlanmadığını belirtmektedir. |
| 008 | XYZ odeme tipi iade desteklemiyor | İlettiğiniz ödeme tipi ile iade işlemi yapılmamaktadır. |
| 009 | Toplam iade tutari odeme tutarindan fazla olamaz | İlettiğiniz iade tutarı işleme ait kalan tutardan fazla olması durumunda dönülmektedir. |
| 010 | Net bakiyeniz yetersiz | Hesabınızda iade etmek istediğiniz tutar kadar bakiye bulunmaması durumunda dönülmektedir. |
| 011 | Bir yildan eski islemler icin iade islemi yapilamaz. | Bir yıldan önceki bir işlem için iade işlemi denemeniz durumunda dönülmektedir. |
DURUM SORGU SERVİSİ ÜZERİNDEN DÖNÜLEN HATA KODLARI VE AÇIKLAMALARI
| err_no | err_msg | Açıklama |
|---|---|---|
| 001 | Gecersiz istek veya magaza aktif degil | İstekte merchant_id bilgisinin iletilmemesi veya mağazanın aktif olmaması durumunda dönülmektedir. |
| 002 | Gecersiz merchant_oid | İstekte merchant_oid alanını iletmemeniz durumunda dönülmektedir. |
| 003 | paytr_token gonderilmedi veya gecersiz | paytr_token alanının iletilmemesi veya doğru olmaması durumunda dönülmektedir. |
| 004 | merchant_oid ile islem bulunamadi | İlettiğiniz sipariş numarasına ait bir işlem bulunamaması durumunda dönülmektedir. |
| 004 | merchant_oid ile basarili odeme bulunamadi | İlettiğiniz sipariş numarası ile başarılı bir ödemenin olmadığı durumda dönülmektedir. |
PLATFORM TRANSFER TALEBİ SERVİSLERİ ÜZERİNDEN DÖNÜLEN HATA KODLARI VE AÇIKLAMALARI
| err_no | err_msg | Açıklama |
|---|---|---|
| 001 | Gecersiz istek veya magaza aktif degil | İstekte merchant_id bilgisinin iletilmemesi veya mağazanın aktif olmaması durumunda dönülmektedir. |
| 002 | Bu servis icin yetkiniz yok | Mağaza türünüzün pazaryeri olmaması durumunda bu hata dönülmektedir. |
| 003 | Gecersiz trans_id | trans_id değeri gönderilmemesi durumunda bu hata yanıtı dönülmektedir. |
| 004 | paytr_token gonderilmedi veya gecersiz | paytr_token alanının iletilmemesi veya doğru olmaması durumunda dönülmektedir. |
| 005 | Gecersiz merchant_oid | İstekte merchant_oid alanını iletmemeniz durumunda dönülmektedir. |
| 006 | merchant_oid ile basarili odeme bulunamadi | İlettiğiniz sipariş numarası ile başarılı bir ödemenin olmadığı durumda dönülmektedir. |
| 007 | merchant_oid bulundu ancak odeme henuz siteye bildirilmemis | İlettiğiniz sipariş numarasının bildirim akışının tamamlanmadığını belirtmektedir. |
| 008 | valor tarihi gecmeden transfer yapilamaz, (valör tarihi) sonrasi tekrar deneyin | İşlem için geçerli olan valör tarihinizden önce istekte bulunmanız durumunda dönülmektedir. |
| 009 | trans_id benzersiz olmalidir, bu trans_id daha once kullanilmis. | Daha önce iletilen bir trans_id değeri iletmeniz durumunda dönülmektedir. |
| 010 | toplam transfer tutari, kalan tutardan fazla olamaz. | İletmiş olduğunuz transfer tutarı işlem için kalan tutardan fazla olması durumunda dönülmektedir. |
| 012 | platform komisyonu sifirdan az olamaz | Yapmış olduğunuz istekte PayTR komisyonu kadar tutar kalmaması durumunda dönülmektedir. |
| 091 | transfer_iban degeri IBAN dogrulamasindan gecemedi, lutfen kontrol edin. | Geçerli bir IBAN numarası girmemeniz durumunda dönülmektedir. |
| 092 | transfer_iban TR ile baslamalidir, bosluk veya '-' icermemeli ve 26 hane olmalidir, lutfen kontrol edin. | IBAN alanı doğru formatta iletilmemesi nedeniyle dönülmektedir. |
| 095 | submerchant_amount sifirdan kucuk olamaz. | Alt satıcınıza aktaracağınız tutar 0 dan küçük gönderilmesi nedeniyle dönülmektedir. |
| 096 | trans_id alfanumerik olmalidir, ozel karakter iceremez | İletilen trans_id alanının alfa numerik olmaması nedeniyle dönülmektedir. |
| 097 | transfer_iban zorunludur, lutfen kontrol edin | transfer_iban alanının iletilmemesi durumunda dönülmektedir. |
| 098 | transfer_name zorunludur, lutfen kontrol edin | transfer_name alanının iletilmemesi durumunda dönülmektedir. |
| 099 | total_amount sifirdan buyuk ve sayisal olmalidir | total_amount alanının doğru formatta iletilmemesi veya 0'dan küçük iletilmesi durumunda dönülmektedir. |
| 100 | transfer_name icerisinde ad ve soyad arasinda bosluk olmalidir | transfer_name alanının doğru formatta iletilmemesi durumunda dönülmektedir. |
| 101 | transfer_name icerisinde ad ve soyad en az 2 karakter olmalidir | transfer_name alanının doğru formatta iletilmemesi durumunda dönülmektedir. |
| 201 | paytr_token gonderilmedi veya gecersiz | paytr_token alanının iletilmemesi veya doğru olmaması durumunda dönülmektedir. |
| 202 | trans_id alfanumerik olmalidir, ozel karakter iceremez | İletilen trans_id alanının alfa numerik olmaması nedeniyle dönülmektedir. |
| 203 | trans_id benzersiz olmalidir, bu trans_id daha once kullanilmis. | Daha önce iletilen bir trans_id değeri iletmeniz durumunda dönülmektedir. |
| 204 | trans_info izin verilenden uzun, daha az kayit ile tekrar deneyin | trans_info alanında beklenenden fazla kayıt iletilmesi durumunda dönülmektedir. |
| 205 | trans_info en az 2 islem en fazla 2000 islem icermelidir | trans_info alanında beklenenden fazla veya az kayıt iletilmesi durumunda dönülmektedir. |
| 206 | trans_info gecerli bir JSON string degil | trans_info alanı beklenen formatta iletilmemesi durumunda dönülmektedir. |
| 301 | paytr_token gonderilmedi veya gecersiz | paytr_token alanının iletilmemesi veya doğru olmaması durumunda dönülmektedir. |
| 302 | trans_id alfanumerik olmalidir, ozel karakter iceremez | İletilen trans_id alanının alfa numerik olmaması nedeniyle dönülmektedir. |
| 303 | trans_id benzersiz olmalidir, bu trans_id daha once kullanilmis. | Daha önce iletilen bir trans_id değeri iletmeniz durumunda dönülmektedir. |
| 305 | merchant_oids en az X islem, en fazla Y islem icermelidir" | İletilen değer merchant_oids alanının alabileceği değerler olmaması durumunda dönülmektedir. |
| 306 | merchant_oids gecerli bir JSON string degil | merchant_oids alanı beklenen formatta iletilmemesi durumunda dönülmektedir. |
| BLK | merchant_oid numarali islemde bloke mevcut, detayli bilgi icin bize ulasin | İletilen sipariş numarasında bloke olması durumunda dönülmektedir. |