Hatalar

API iş kuralı hatalarında da HTTP 200 döner; sonucu gövdedeki status alanından okuyun.

{ "status": false, "message": "Minimum yatırım tutarı 100₺'dir." }

message Türkçedir ve müşteriye gösterilebilecek şekilde yazılmıştır. Kimlik doğrulama ve bazı özel durumlarda ek olarak bir code alanı bulunur.

Kimlik doğrulama

code	message	Neden
401	Unauthorized Access.	auth eksik ya da yarım (apiKey+secKey veya site+hash gerekir)
402	Unauthorized Access.	Anahtarlar ya da site adı hiçbir siteyle eşleşmedi
403	Unauthorized Access.	İmza tutmadı ya da siteniz pasif
403	Unauthorized Access. [022]	İstek IP'si izin listenizde değil

Alan doğrulama

Zorunlu bir alan eksik ya da türü yanlışsa:

{
  "status": false,
  "message": "Hatalı alanlar :  customer.fullName | amount",
  "errors": [ … ]
}

İstek sınırı

Dakikada 60 isteği aşarsanız HTTP 429 ve şu gövde döner:

{ "status": false, "message": "Too many requests.", "code": 429 }

Sık karşılaşılanlar

Mesaj	Ne yapmalı
"Bu transactionId (…) ile daha önce bir yatırım talebi oluşturulmuş."	Her talep için yeni bir numara üretin. Aynı talebi tekrar denemeniz gerekiyorsa önce eski talebin durumunu kontrol edin.
"Zaten açık bir yatırım talebiniz var."	Müşterinin önceki talebi henüz sonuçlanmadı. Müşteriyi o talebe yönlendirin ya da geri çekin.
"Minimum/Maksimum yatırım tutarı …"	Tutar sitenize tanımlı sınırların dışında. Sınırları hesap yöneticinizle konuşun.
"Sistem geçici bir süreliğine bakım durumundadır."	Kısa süreli bakım. Müşteriye mesajı gösterin, birkaç dakika sonra tekrar deneyin.
"IBAN ile banka çözümlenemedi!"	IBAN hatalı ya da eksik. Müşteriden kontrol etmesini isteyin.

İmza tutmuyor

İmza yöntemiyle 403 alıyorsanız:

1. İmzaladığınız JSON ile gönderdiğiniz JSON'un auth dışında birebir aynı olduğunu kontrol edin (alan sırası, boşluk, kaçış karakterleri).
2. sha1 girdisinin secKey + JSON olduğunu (arada ayraç yok) kontrol edin.
3. Hesabın onaltılık (hex) ve küçük harf olduğunu kontrol edin.

Ayrıntı için Kimlik doğrulama.