Stripe Terminal ile kartlı ödeme¶

Bir Stripe kart okuyucu kartları, telefonları ve akıllı saatleri temassız veya çipli olarak kabul eder; DiKAS onu Stripe bulutu üzerinden yönetir. Kasa tutarı Stripe'a gönderir, Stripe de okuyucuda gösterir. Donanım ajanı ve işletme yönlendiricisinde herhangi bir izin gerekmez; okuyucunun yalnızca internete ihtiyacı vardır. Bu sayfa, neye uygun olduğunu, okuyucunun nasıl kurulduğunu ve kasada neler olduğunu gösterir.

Bir bakışta¶


DiKAS'ta terminal türü	Stripe Terminal
Ödemenin işleyişi	Kasa → Stripe bulutu → okuyucu (işletme ağı üzerinden geçmez)
Kart fişi	Okuyucunun yazıcısı yoktur: DiKAS kart fişini kasa fişine yazdırır
Okuyucuda bahşiş	kasaya bildirilmez
Karta iade	yalnızca ilk ödemeye atıfla (fiş iptali)
Okuyucuda gün sonu	yoktur; ödemeler Stripe üzerinden otomatik aktarılır

Desteklenen cihazlar ve ülkeler¶

Ne	Durum
Stripe hesabınızda okuyucu olarak tanımlı ve bir okuyucu kimliğine (`tmr_` ile başlar) sahip Stripe kart okuyucular	✅ destekleniyor
Stripe'ın bulut üzerinden yönetim için hangi okuyucu modellerine izin verdiği	Stripe belirler; modeli ve kullanılabilirliği Stripe hesabınızda kontrol edin
Diğer sağlayıcıların kart terminalleri	kendi kılavuzlarına bakın, örn. ZVT terminali

Para birimi: Tahsilat, işletmenizin ana para biriminde yapılır (örn. avro veya İsviçre frangı). Stripe'ın kart okuyucuları hangi ülkelerde sunduğunu ve hangi kartların kabul edildiğini DiKAS değil, Stripe hesabınız belirler.

Önkoşullar¶

Kart okuyucunun okuyucu olarak tanımlandığı ve çevrimiçi olduğu bir Stripe hesabı.
Okuyucunun okuyucu kimliği (tmr_…): Stripe hesabınızda Terminal bölümünde görünür.
Stripe hesabınızın gizli anahtarı (Secret Key, sk_live_ veya sk_test_ ile başlar): Stripe hesabınızdaki API anahtarları bölümünde bulunur. Form, rk_ ile başlayan anahtarları da kabul eder.
Okuyucuda ve DiKAS sunucusunda veya bulut kasada internet erişimi.
Admin → Ayarlar bölümüne erişimi olan bir kullanıcı.

Önce test modunda

sk_test_ ile başlayan bir anahtarla Stripe test modunda çalışır; gerçek kart borçlandırılmaz. Gerçek kullanım için daha sonra sk_live_ anahtarını girin.

8 adımda kurulum¶

Ödeme seçeneklerini açın: Admin → Ayarlar → Donanım → Ödeme seçenekleri.
Terminal ekle (artı simgesi) düğmesine tıklayın ve bir ad verin, örn. «Bar okuyucusu».
Tür alanında Stripe Terminal seçin. Okuyucu kimliği alanı görünür (yer tutucu tmr_xxx).
Okuyucunun okuyucu kimliğini girin.
Terminal listesinin altında Stripe sekmesi görünür. Secret Key değerini oraya girin. DiKAS onu şifreli saklar ve bir daha asla açık metin olarak göstermez; kayıtlı anahtar «•••• kayıtlı (korumak için boş bırakın)» olarak görünür.
Üstteki Kaydet düğmesine tıklayın. Kaydetmeden sunucu yeni okuyucuyu tanımaz.
Stripe sekmesinde Bağlantıyı test et düğmesine tıklayın. Bağlantı başarılı görünüyorsa anahtar doğrudur. Hata durumunda DiKAS Stripe'ın metnini gösterir.
Okuyucunun satırında Durumu kontrol et simgesine (Wi-Fi işareti) tıklayın. Yeşil nokta, okuyucunun Stripe'ta çevrimiçi olduğu anlamına gelir. Aksi halde ipucu metninde örn. Reader-Status: offline yazar.

Ardından küçük tutarlı bir deneme ödemesi yapın (aşağıya bakın) ve iptal edin.

Stripe sekmesindeki diğer alanlar

Publishable Key okuyucuda kartlı ödeme için gerekmez; aynı sekmeyi kullanan diğer Stripe işlevleriyle ilgilidir (örn. çevrimiçi sipariş veya QR kodla ödeme). Location-ID değerini DiKAS okuyucudaki ödemelerde değerlendirmez. Erişim bilgileri işletmenin tüm Stripe işlevleri için ortaktır.

Birden çok okuyucu ve kasa¶

Her okuyucu için ayrı bir terminal kaydı, kendi adı ve kendi okuyucu kimliği ile.
Hangi okuyucunun hangi kasada kullanılacağı Varsayılan terminal (terminal listesinin altındaki seçim) ile veya iş istasyonu ya da cihaz bazında belirlenir; bkz. Donanım: kart terminalleri.
Ödeme penceresi her zaman okuyucunun adını gösterir; böylece yanlış cihaz hemen fark edilir.

Kasada ödeme nasıl çalışır¶

Ürünleri girin ve Öde, ardından EC kartı veya Kredi kartı seçin.
Tutar ve okuyucunun adıyla (Terminal: …) Kart ile ödeme penceresi açılır.
Tutar okuyucuda görünür. Müşteri kartı, telefonu veya akıllı saati okuyucuya yaklaştırır ya da kartı takar.
Stripe ödemeyi tamamlanmış olarak bildirdiğinde DiKAS Ödeme başarılı gösterir ve fişi kaydeder.

Ödeme onaylanmadan kalırsa¶

DiKAS sorduğu anda Stripe henüz tamamlandığını bildirmemişse DiKAS, Tekrar tahsil ETMEYİN — ödemeyi terminalde kontrol edin. uyarısıyla Ödeme onaylanmadı gösterir ve bir Kapat düğmesi sunar.

Körü körüne tekrarlamayın

Önce okuyucuda ve Stripe hesabınızda (Ödemeler bölümü) kartın borçlandırılıp borçlandırılmadığını kontrol edin. Ardından ödemeyi aynı okuyucuda yeniden başlatın: DiKAS ikinci bir tahsilat başlatmak yerine önce açık işlemi Stripe ile karşılaştırır. Başarılıysa ve tutar uyuyorsa işlem devralınır. Tutar farklıysa, siz netleştirene kadar DiKAS bir netleştirme durumu bildirir. DiKAS sunucusu arada yeniden başlatıldıysa açık işlem orada artık kayıtlı değildir; o zaman yalnızca Stripe hesabınızdaki kontrol geçerlidir.

Bahşiş¶

Okuyucu kasaya bahşiş bildirmez. Bahşişi diğer ödemelerde olduğu gibi kasada kaydedin.

Kart fişi: kim yazdırır?¶

Bir Stripe okuyucunun kendi yazıcısı yoktur. Tür oluşturulurken DiKAS Terminalin kendi yazıcısı var seçeneğini otomatik olarak kapalı yapar: kart fişi kasa fişine yazdırılır, çift baskı olmaz.

İptal ve karta iade¶

Durum	İşleyiş
Fiş iptali	İptal, ilk ödemeye atıfla yapılır: DiKAS ödemenin tamamını Stripe üzerinden karta iade eder ve ardından iptal fişini oluşturur. İptal yalnızca ödemenin okuyucusunun atandığı kasada yapılabilir ve Kart iadesi yapabilir yetkisini gerektirir (yöneticiler her zaman).
Serbest karta iade (ilk ödeme olmadan)	Mümkün değildir. Stripe yalnızca mevcut bir ödemeye iade yapar. DiKAS şunu bildirir: Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift … Bitte mit Bezug auf den Ursprungsbeleg stornieren (funktioniert) oder bar erstatten. (Stripe Terminal atıfsız karta iadeyi desteklemez; ilk fişe atıfla iptal edin, bu çalışır, ya da nakit iade edin.)

Gün sonu ve günlük kapanış¶

Stripe'ta klasik kart terminallerindeki gibi bir gün sonu yoktur. DiKAS, ödeme seçeneklerinde okuyucunun gün sonu simgesine tıkladığınızda Stripe Terminal kennt keinen Kassenschnitt — Auszahlungen laufen automatisch über Stripe (Dashboard → Auszahlungen). uyarısını gösterir (Stripe Terminal'de gün sonu yoktur; ödemeler Stripe üzerinden otomatik aktarılır, Dashboard → Ödemeler/Aktarımlar). Kasa menüsünde (Menü → Kart terminali → Gün sonu) DiKAS bir Stripe okuyucu için yalnızca Gün sonu tamam bildirir; okuyucuda hiçbir şey kapatılmaz. Kartlı satışları gerekirse Stripe hesabınızda mutabık kılın. Okuyucudan satış ara toplamı yoktur.

Sınırlar¶

Okuyucuda bahşiş yok, serbest karta iade yok, gün sonu yok.
İnternet zorunludur; Stripe bağlantısı olmadan okuyucuda kartlı ödeme mümkün değildir.
Bir okuyucu tek bir Stripe hesabına aittir; gizli anahtar işletmenin tüm Stripe okuyucuları için ortaktır.

Hatalar ve çözümler¶

Mesaj / Ne görürsünüz	Neden ve çözüm
Stripe Terminal ist nicht konfiguriert (Secret Key oder Reader-ID fehlt) (yapılandırılmamış: gizli anahtar veya okuyucu kimliği eksik)	Stripe sekmesine Secret Key'i, terminale okuyucu kimliğini girin ve Kaydet.
Stripe-Terminal … nicht gefunden (bulunamadı)	Okuyucu henüz kaydedilmemiş veya silinmiş. Terminali oluşturun veya Kaydet.
Reader-Status: offline (veya «online» yerine başka bir durum)	Okuyucuyu açın, internet bağlantısını kontrol edin; Stripe hesabınızda çevrimiçi görünmelidir. Sonra Durumu kontrol et.
Bağlantıyı test et sırasında bağlantı hatası veya Stripe hata metni	Gizli anahtarı kontrol edin (biçim `sk_…`) ve yeniden girin. Biçim yanlışsa form Beklenen biçim: sk_… uyarısını gösterir.
Zahlung unbestätigt — wird geprüft. Bitte NICHT erneut versuchen, sondern kurz warten. (ödeme onaylanmadı, tekrar DENEMEYİN, kısa süre bekleyin)	Bkz. Ödeme onaylanmadan kalırsa.
Stripe-Terminal-Status nach Reader-Push unsicher. (okuyucuya gönderimden sonra durum belirsiz)	Gönderimden sonra Stripe bağlantısı koptu; ödeme okuyucuya ulaşmış olabilir. «Onaylanmadı» gibi ele alın: Stripe hesabında kontrol edin, hemen yeniden tahsil etmeyin.
Unbestätigte frühere Zahlung über einen abweichenden Betrag gefunden — bitte klären (farklı tutarlı onaylanmamış önceki ödeme bulundu)	Başka tutarlı açık bir işlem var. Stripe hesabında netleştirin (gerekirse iade edin), ancak ondan sonra yeniden tahsil edin.
Zahlung abgebrochen. / Zahlung abgelehnt oder abgebrochen. (iptal edildi / reddedildi veya iptal edildi)	Müşteri veya personel okuyucuda iptal etti ya da kart reddedildi. Başka bir kart veya ödeme yöntemi deneyin.
Stripe Terminal unterstützt keine referenzlose Karten-Gutschrift …	Stripe ile serbest iade mümkün değildir. Fişi iptal edin veya nakit iade edin.
Keine Transaktionsreferenz für das Storno vorhanden. (iptal için işlem referansı yok)	Fişte Stripe referansı yok. DiKAS üzerinden iade o zaman mümkün değildir; destek ile iletişime geçin.
Diese Kartenzahlung lief über … Stornieren ist nur an der Kasse mit diesem Terminal möglich. (iptal yalnızca bu terminalin bulunduğu kasada mümkün)	İptali bu okuyucunun atandığı kasada yapın.
Keine Berechtigung für Karten-Erstattungen. (karta iade için yetki yok)	Kullanıcıya Admin → Personel altında Kart iadesi yapabilir yetkisini verin veya bir yöneticinin iptal etmesini sağlayın.

Sonraki adım¶

→ Ödeme yöntemleri ve kasada kartlı ödeme: iptal, iade ve ödeme yöntemi olarak kart türü → Donanım: kart terminalleri: tüm terminal türlerine genel bakış