Skip to content
GUIDE-0012RehberYürürlüktesürüm 1.0.012 Kasım 2026

Sorun giderme ​

Bu sayfa, Tamga'ya bağlanan geliştiricilerin en sık karşılaştığı sorunları ve çözümlerini toplar.

Ne zaman okunur: bir doğrulama beklenmedik sonuç verdiğinde, cüzdan bir belgeyi alamadığında ya da gösteremediğinde, kayıt başvurusu geri döndüğünde.

Önce: sonuç ne diyor? ​

Doğrulama üç değerli bir sonuç döner (SPEC-API-0001 §2):

outcomeAnlamıİlk bakılacak alan
ACCEPTEDBütün adımlar geçti—
REJECTEDBelge geçersizfailed_step
INDETERMINATEŞu an kontrol edilemedi; belge hakkında hüküm yokindeterminate_reason

REJECTED ile INDETERMINATE'i aynı mesajla göstermeyin. "Bu belge geçersiz" ile "şu an kontrol edemiyorum" farklı kararlardır (AP2).

"Doğrulanamadı" (INDETERMINATE) ​

indeterminate_reasonSebepÇözüm
STATUS_UNREACHABLEBelgenin iptal listesi (status list)Her belgenin tek bir konumu olduğu sıkıştırılmış, imzalı liste; geçerli, askıda ya da iptal olduğunu söyler. indirilemediİptal listelerini önceden çekin (PrefetchStatusCache + düzenli refresh); doğrulama anında ağa çıkmayın
STATUS_STALEÖnbellekteki iptal listesi tazelik eşiğini aştı ya da çapadan önce çekildi. Ya da çapa günlüğünüz eski: liste, bildiğiniz son çapadan max_anchor_lag_sec'ten (varsayılan 3600 sn) daha yeni; ya da liste çapa günlüğünüzde hiç yok (çapalar yüklenmemiş). Ya da liste, kurumun süresi dolmuş iptal anahtarıyla imzalı (anahtar yenilenmiş, önbellek eski)Yenileme aralığını kısaltın. Güven listelerini ve çapa günlüğünü (anchors: true) yalnız açılışta değil, max_anchor_lag_sec'ten sık yeniden yükleyin (ör. 10 dakikada bir). Saat farkını denetleyin (NTP)
SCHEMA_UNREACHABLEBelge türünün tanımı alınamadıŞema kataloğunu önceden önbelleğe alın
CHAIN_UNREACHABLE / INDEXER_STALEGüven kaynağı okunamadı ya da bayatGüven listelerini düzenli indirin; next_update geçmişse yeni listeyi alın
SDK_VERSION_MISMATCHKütüphane sürümü kural sürümüyle uyumsuz@tamga-network/* paketlerini güncelleyin
STATUS_VALUE_UNKNOWNİptal listesindeki değerin tanımlı anlamı yok (4/8 bitlik dış liste, uygulamaya özel değer)Belgeyi veren kurumun liste profilini sorun; Tamga türlerinde görülmez

Güven listesi bayatsa ya da indirilemiyorsa güven soruları UNKNOWN döner ve sonuç her zaman INDETERMINATE olur; asla ACCEPTED, asla REJECTED.

Reddedildi (REJECTED) ​

failed_step hangi adımın geçmediğini söyler (SPEC-API-0001 §1). En sık görülenler:

AdımNe demekBakılacak yer
A3İmza zinciri güven listesindeki bir köke bağlanmıyorDoğru listeyi ve kök parmak izlerini yüklediniz mi? Test ortamı belgesini canlı listeyle mi doğruluyorsunuz?
A3bBelgeyi imzalayan sertifika, iss alanındaki kurumla eşleşmiyorKurum kimliği her zaman sertifikadan türetilir; iss değerine güvenmeyin
A3d / A6Belge sahibine bağlılık kanıtı (KB-JWT) yok ya da aud, nonce, iat tutmuyorİstekte gönderdiğiniz nonce ile doğruladığınız aynı mı? Saatler senkron mu?
A5Bir disclosure belgedeki özetlerle eşleşmiyorSunum değiştirilmiş; yeniden isteyin
A7Belgenin süresi geçmiş (exp) ya da henüz geçerli değil (nbf)Kişi belgesini kurumdan yenilemeli; sunucunuzun saati doğru mu?
C1Kurum, belgenin verildiği anda etkin değildiKurumun kayıt geçmişine bakın (GUIDE-0006)
C2Kurum bu belge türünü vermeye yetkili değildiKurumun belge türü yetkisi (GUIDE-0007 §5)
D6Belge iptal edilmiş ya da askıya alınmışBelgeyi veren kuruma sorun
E3İstediğiniz alanlar kayıtlı kapsamınızın dışındaKapsamınızı genişletin (GUIDE-0008 §3)

Güven listesi yüklenmiyor ​

BelirtiSebepÇözüm
İmza doğrulanmıyorSabitlenmiş kök parmak izi listeyi imzalayan kökle eşleşmiyorParmak izini tamga.network/trust-anchor'dan yeniden alın; ortamı (test / canlı) karıştırmayın
"Bilinmeyen biçim sürümü"Liste daha yeni bir biçimdeOkuyucu bilerek durur; kütüphaneyi güncelleyin
Sürüm geri gittiEski bir kopya sunuluyor (önbellek, CDN)Okuyucu geri sarmayı reddeder; önbelleği temizleyin
Dış liste kayıtları görünmüyorListe bayat, imzacısı LOTL'dakiyle eşleşmiyor ya da kayıt kapsam dışındaDış listeye bağlı sorular UNKNOWN döner; diğer listeler etkilenmez (GUIDE-0011)

Cüzdan: belge alma ​

Hata (WalletError)SebepÇözüm
tx_code_mismatchPIN yanlışPIN teklifle aynı kanaldan gelmez; kişiden SMS ya da e-postadaki PIN'i isteyin
offer_expired / offer_usedTeklifin süresi doldu ya da kullanıldıKurumdan yeni teklif isteyin
offer_not_found / invalid_offerQR bozuk ya da Tamga teklifi değilTeklifi yeniden okutun
trust_errorKurum ya da cüzdan sağlayıcısı listede bulunamadı, imza doğrulanmadıGüven listesini tazeleyin; kurumun kaydını denetleyin
unsupportedBu cüzdanda desteklenmeyen tür ya da iptal edilmiş birim ("This wallet has been revoked.")Birim iptal edildiyse yeniden kaydolun
networkBağlantı yokYeniden deneyin

Cüzdan: cihaz kanıtı ve WUA ​

Aşağıdaki yanıt alanları cüzdan sağlayıcısına göre değişir; örnekler bir sağlayıcıdan alınmıştır (örnek: Tamga Wallet sağlayıcısı). Kendi sağlayıcınızın belgesine bakın.

  • Kayıt yanıtında attestation: "software": cüzdan sağlayıcısı cihaz kanıtını kullanamadı; kayıt yine yapıldı ve birim yazılım seviyesinde. reason nedeni söyler: not_configured (sağlayıcıda o platform için App ID ya da kökler ayarlı değil), invalid (kanıt doğrulanamadı — çoğunlukla uygulama kimliği, Bundle ID ya da paket adı sağlayıcının beklediğinden farklı), unsupported (geliştirme derlemesi, emülatör, kilidi açık cihaz ya da donanımsız anahtar). attestation: "none" kanıt hiç sunulmadı demektir (Expo Go, yerel modül yok). Kayıt bu nedenlerle reddedilmez.
  • Yazılım seviyesinde kayıt: Expo Go'da ya da yerel anahtar modülü olmadan çalışıyorsunuz. Geliştirme derlemesi kullanın (GUIDE-0005 §1).
  • WUA süresi doldu: belge almadan önce wuaExpiringSoon ile denetleyip yenileyin.

Cüzdan: gösterme ​

BelirtiSebepÇözüm
Ekranda "kayıtlı kapsamın dışında" uyarısıDoğrulayıcı kayıtlı değil ya da kapsamı dışında alan istiyorDoğrulayıcı kaydını ve kapsamını düzeltin (GUIDE-0008)
Kayıt sertifikası eşleşmiyorKayıt sertifikasındaki kurum kimlik numarası erişim sertifikasındakiyle aynı değilİkisi de aynı resmî kimlik numarasından üretilmelidir (ADR-0026)
Kopyalar tükendiDoğrulayıcıya özel kopya kalmadıKişiye sorun; kurumdan yenileme alınır (ADR-0023)
Takma ad isteği reddedildiDoğrulayıcı kayıtlı değil ya da kaydında pseudonyms yokKayda takma ad ayarını ekleyin (ADR-0031)

Kayıt başvurusu geri döndü ​

Kayıt aracı eksik ya da hatalı alanların tamamını tek seferde listeler (kayıt yapılamadı: ve altında maddeler). Sık görülenler: identifiers, postal_address, contact, supervisory_authority (başvuru yolu: form adresi, e-posta ya da telefon), scopes[…].privacy_policy_uri. Biçim: GUIDE-0007 §2 ve GUIDE-0008 §2.

Servis hata biçimi ​

Tamga servisleri hataları RFC 9457 biçiminde döner; tamga_code makinenin okuyacağı koddur ve detail kişisel veri içermez:

json
{
  "type": "https://docs.tamga.network/errors/schema-not-authorized",
  "title": "Belge veren bu şemayla belge veremez",
  "status": 403,
  "tamga_code": "SCHEMA_NOT_AUTHORIZED"
}
  • Reddedilen belge bir hata değildir: doğrulama çağrısı başarılıdır (200) ve sonucu gövdede taşır (AP5).
  • 409: aynı Idempotency-Key farklı gövdeyle gönderildi.
  • 429: hız sınırı; Retry-After kadar bekleyin.

Hâlâ çözülmediyse ​

Hata kaydınızdan kişisel veriyi çıkarın ve verification_id, failed_step ya da indeterminate_reason, kütüphane sürümü (sdk_version) ile birlikte bildirin. Uyum testlerini koşmak çoğu uyumsuzluğu gösterir: GUIDE-0009.