Terminal

Bağlantıyı telefon veya tablette açın, tutarı tuş takımına girin, cihazı müşteriye uzatın. Ödeme onaylandıktan sonra sayfa otomatik olarak tuş takımına döner — bir sonraki satışa hazır.

Terminal kutudan çıktığı gibi çalışır. Kod yok, gömülü API anahtarı yok, sunucu tarafı yok. Marka, para birimleri ve etkin ağlar projenin kendi ayarlarından devralınır.

Terminal URL'sini nereden alırsınız

Terminal'in Panel'de kendi sayfası var: /terminal. Sayfa, o sırada açık olan projeyi gösterir — Terminal erişimi kartında o projenin adresi, yanında da terminalin kasiyerin ekranında nasıl göründüğünü gösteren bir önizleme yer alır. Terminal URL'si satırındaki değeri kopyalayın.

Terminal her projede bulunmaz. Bir projede terminal, yalnızca proje oluşturulurken Entegrasyon yöntemi olarak Terminal seçildiyse bulunur; sonradan açılıp kapatılan bir ayar yoktur. Bu seçim bir kez yapılır ve değişmez — mevcut bir projeyi terminale çevirmek yerine yeni bir proje açarsınız.

URL şöyle görünür:

https://paymos.io/terminal?key=pk_live_xxx&pid=prj_yyy

Bağlantıyı kasiyerlerle paylaşın veya kasa cihazının yer imlerine kaydedin.

URL'nin içindekiler

Parametre	Amacı
key	Projenin herkese açık anahtarı (pk_live_ veya pk_test_ öneki). Gizli değildir — ama sahip olmak projeniz adına fatura oluşturma yetkisi verir. Projenizin etkin payment anahtarından alınır.
pid	Proje kimliği (prj_ öneki). Hangi tokenların, ağların ve markanın yükleneceğine karar verir.

URL cihaza bağlı değildir — tarayıcısı olan herhangi bir cihazda açın. Her açılış bağımsız bir oturumdur.

Satış nasıl işler

• 01Kasiyer terminal URL'sini tarayıcıda açar (telefon veya tablet).
• 02Fiat para birimini seçer (USD, EUR, RUB artı 43 tane daha) ve tutarı tuş takımına girer.
• 03Öde düğmesine dokunur — terminal bir fatura oluşturur ve standart ödeme sayfasını açar.
• 04Müşteri kendi cihazından öder: terminal ekranındaki QR'ı tarar veya bağlantıyı izler.
• 05Zincir üzerinde onaylandığında terminal otomatik olarak tuş takımına döner.

Kasiyer cüzdana asla dokunmaz. Müşteri Paymos'a asla kaydolmaz. Beklemenin çoğu zincir üstü onaydır — hızlı kesinlikli bir zincirde saniyeler, yavaş bir zincirde büyük ödeme için birkaç dakika.

Görünümü özelleştirme

Terminal, normal ödeme sayfasıyla aynı marka ayarlarını devralır. Bunları Panel'deki Ödeme formu sayfasında, Markalama kartından düzenleyin:

Ayar	Neyi değiştirir
Ödeme sayfası stili	Ödeme sayfasının temel stil şablonu (arka plan deseni, tema)
Vurgu	Birincil renk: düğmeler, bağlantılar, hover, etkin ağ göstergesi
Arka plan	Sayfa arka planı
Yüzey	Kart ve panel yüzeyi
Metin	Ana gövde metni
Soluk	İkincil metin (ipuçları, altyazılar)
Köşe yarıçapı	Düğme ve kartlardaki yuvarlama, 0-32px

Kaydettikten sonra aynı sayfadaki önizleme kendiliğinden güncellenir. Terminal değişiklikleri bir sonraki açılışta alır.

Logo

Proje logosu terminal başlığında kendiliğinden görünür. Logo bir adres alanına yapıştırılmaz, dosya olarak yüklenir: Projeler altında projeyi açın, ayrıntı sayfasındaki yükleyiciden dosyayı seçin. Seçici PNG, JPEG ve WebP kabul eder; dosya başına sınır 2 MB. SVG kabul edilmez.

Para birimi listesi

Terminal, proje ayrıntı sayfasındaki Para birimleri sekmesinde etkinleştirdiğiniz fiat para birimlerini sunar. Varsayılan perakende seti USD, EUR, RUB'dur. Coğrafyanıza göre ekleyin veya çıkarın.

Etkin ağlar ve tokenlar

Terminal müşteriye yalnızca projenin Para birimleri sekmesinde etkinleştirilen ağları ve tokenları gösterir. Tipik bir perakende karışımı:

• Tron (USDT) — BDT ve Asya müşterileri
• Polygon (USDC/USDT) — düşük müşteri komisyonu
• BSC (USDT) — Binance kullanıcıları
• TON — Telegram kullanıcı kitleleri

Yüksek tutarlı satışlar bekliyorsanız Ethereum mainnet'i etkin tutun.

Sandbox ve üretim

Terminal URL'sindeki anahtar öneki ortamı belirler — sandbox için pk_test_, üretim için pk_live_. Sandbox'ta çalışırken terminal, kartın en üstünde Sandbox bandı gösterir.

Test için:

1. Panel → Geliştirici → API Anahtarları bölümünde bir pk_test_ anahtarı üretin.
2. Sandbox terminal URL'sini oluşturun (aynı biçim, test anahtarı).
3. Faturaları testnet cüzdanlarından ödeyin.

Yayına geçmek için bir pk_live_ anahtarı oluşturun ve kasa cihazlarındaki URL'yi güncelleyin.

Low-Code SDK geri dönüşü olarak Terminal

Low-Code SDK'yı sabit tutar olmadan kullanıyorsanız (amount verilmemiş), terminal URL'sini SDK'nın pos_url seçeneği olarak geçin — bileşen standart ödeme formu yerine terminali açar. Tek bileşen iki akışı kapsar:

• Sabit tutar — müşteri belirlenen tutarı standart form üzerinden öder.
• Serbest tutar — müşteri tutarı terminal tuş takımına girer.

Tek betik, iki mod, ayrı derleme yok. pos_url olmadan geri dönüş yoktur: çözülebilir tutarı olmayan bir tıklama, terminali açmak yerine paymos:error olayı oluşturur.

Birden fazla kasiyer veya cihaz

URL paylaşılır. İhtiyacınız kadar cihazda açın — hepsi aynı projeye karşı paralel çalışır. İşlemler projenin ortak geçmişine akar; Panel her şeyi gösterir.

Birden fazla konum

Konum başına proje çalıştırın:

1. Panel → Projeler → Yeni proje adımını izleyin.
2. Entegrasyon yöntemi olarak Terminal seçin; bu yöntem sonradan eklenemez.
3. Markayı ve etkin ağları yapılandırın, sonra o konumun terminal URL'sini kopyalayın.

Tüm projeler tek satıcı hesabı altındadır — raporlama ortak Panel'e toplanır.

Güvenlik

URL'deki key herkese açık anahtardır. Çekimlere, proje ayarlarına veya kısıtlı herhangi bir işleme erişim vermez. Projeniz adına fatura oluşturma yetkisi verir.

Pratikte:

• Terminal URL'sini herkese açık bir kasa cihazının tarayıcı yer imlerinde tutmak güvenlidir.
• URL bir yabancıya sızarsa fatura oluşturabilir (ama sizin adınıza ödeme yapamaz ve para çekemez).
• Ele geçirilirse Panel → Geliştirici → API Anahtarları bölümünde yeni bir pk_live_ anahtarı üretin ve URL'yi güncelleyin. Eski anahtarı iptal edin.

Sorun giderme

Terminal açılmıyor

Sırayla kontrol edin:

1. URL hem key hem de pid içeriyor.
2. Proje Terminal entegrasyon yöntemiyle oluşturulmuş — başka bir yöntemle açılan projede bu adres çalışmaz.
3. Anahtar iptal edilmemiş; durumunu Panel → Geliştirici → API Anahtarları sayfasında görürsünüz.

Sayfa "Ödeme kullanılamıyor" diyor

Tek ekran, birden çok neden: yanlış ya da iptal edilmiş key, yanlış pid, ya da terminal dışında bir yöntemle açılmış proje. Adresi Terminal sayfasından yeniden kopyalayın — iki değer de aynı projeden gelmelidir. Sayfada kopyalanacak bir URL yoksa neden entegrasyon yöntemidir: o projeye terminal sonradan eklenmez, kasa kendi projesiyle çalışır.

"Öde"ye dokunduktan sonra QR görünmüyor

Projenin Para birimleri sekmesinde en az bir token etkin mi kontrol edin.

Ödeme onaylanmıyor

Onay derinliği ağa ve ödeme tutarına bağlıdır — küçük tutarlar hızlı onaylanır, büyükler kesinlik için daha uzun bekler. Yerel hızlı kesinliği olan zincirler (BSC, Polygon, Solana, Avalanche, Plasma) saniyeler içinde sonuçlanır; Tron, Ethereum ve L2'lerde büyük bir tutar birkaç dakika sürebilir. Müşteri birkaç dakika önce ödediyse ve sayfa ilerlemediyse, işlemin zincire düştüğünü kontrol etmek için ağın gezgininde açın.

Tema değişikliğinden sonra Terminal bozuk görünüyor

Eski tema hâlâ açık sekmede önbellekte. Sekmeyi kapatıp URL'yi yeniden açarak yenisini çekin.