Tami Sanal POS
Kategori: Ödeme Versiyon: 1.0.0
Tami (Garanti BBVA), banka iş ortaklığı ile sunulan sanal POS hizmetidir. JWT tabanlı imzalama ile yüksek güvenlik sağlar.
Desteklenen Özellikler
- Kredi/banka kartı
- 3D Secure
- JWT imzalı işlem (yüksek güvenlik)
- Taksit
- Test ve canlı ortam
1. Ön Hazırlık — Banka Tarafından Verilecek Bilgiler
Tami panelinizde POS Yönetimi → API ekranından ya da banka temsilcinizden aşağıdaki beş değeri temin edin:
| Alan | Açıklama |
|---|---|
| Üye İş Yeri Numarası | POS Yönetimi → API ekranındaki 8 haneli numara (örn. 77026363) |
| Terminal Numarası | Aynı ekranda "Terminal-…" etiketinin yanındaki 8 haneli sayı. Üye iş yeri numarasıyla karıştırmayın |
| Güvenlik Anahtarı | PG-Auth-Token üretimi için zorunlu |
| Kid Değeri | API ayarlarındaki Kid — securityHash imzası için |
| K Değeri | API ayarlarındaki K — base64url HMAC anahtarı |
💡 Canlı ve test ortamı için ayrı setler verilir; ikisi birbirinin yerine kullanılamaz.
📖 Teknik ayrıntılar: dev.tami.com.tr/api-katalog
2. Eklentiyi Yapılandırın
- Sol menüden Eklenti Mağazası sayfasına gidin ve Tami Sanal POS kartındaki Eklentiyi Yapılandır butonuna tıklayın. (Aynı sayfaya Ödeme Entegrasyonları listesinden de ulaşabilirsiniz.)
- Beş alanı doldurun (yukarıdaki tabloyla aynı).
- Test modu (Sandbox) anahtarını, canlı Tami panelinden aldığınız anahtarlarla çalışıyorsanız kapalı tutun. Yalnızca sandbox portal anahtarları için açın.
- Entegrasyonu aktif et anahtarını açın, ardından Ayarları kaydet ve Bağlantıyı test et.
Sık Karşılaşılan Sorunlar
"JWT imza doğrulanamadı": Kid Değeri veya K Değeri yanlış. Tami panelinden tekrar kopyalayın; özellikle K değerinde gizli boşluk veya satır sonu olmadığını kontrol edin.
Güvenlik anahtarını yenilediniz: Tami panelinde Güvenlik Anahtarı için "Yenile" yaptıysanız, yeni anahtarı eklenti formuna yapıştırıp tekrar kaydetmeniz gerekir.
"Terminal kapalı": Banka tarafında terminal'iniz aktif değil olabilir. Banka destek ekibine "tami terminal aktif mi" diye sorun.
Test → canlı geçişi: Test bilgileriniz çalışırken canlıya geçmeden önce canlı üye iş yeri / terminal / Kid-K seti alın ve Test modu anahtarını kapatın. İki ortamın anahtarları birbiriyle değişmez.