PayTR — Invum POS kurulum kılavuzu

Bu kılavuz, WooCommerce mağazanızda PayTR ile kartlı ödeme almak için Invum POS'u nasıl ayarlayacağınızı anlatır. Kurulum yaklaşık 10-15 dakika sürer.

Hangi sürümde?

PayTR'nin iki yöntemi de ücretsiz Invum POS Lite sürümünde gelir; lisans gerekmez:

• PayTR (iframe) — önerilen. Ödeme formu PayTR'nin güvenli sayfasında açılır. Kart bilgisi PayTR'nin sayfasında alınır, sitenize hiç ulaşmaz; PCI yükünüz en düşük düzeydedir.
• PayTR (Direct API). Kart formu kendi sitenizde görünür; daha bütünleşik bir deneyim sunar. Kart bilgisi sitenizden geçtiği için PCI sorumluluğunuz artar; ayrıntı için Mağaza PCI rehberi sayfasını okuyun.

Başlamadan önce

• WordPress 6.6+, WooCommerce 9.0+, PHP 8.1+
• Tamamen HTTPS çalışan bir site
• Onaylı bir PayTR mağaza hesabı (paytr.com üzerinden başvurulur)

1. PayTR'den alacağınız bilgiler

PayTR mağaza panelinde Ayarlar › API Bilgileri sayfasını açın. Üç değer alacaksınız:

• Mağaza No (Merchant ID)
• Mağaza Parolası (Merchant Key)
• Mağaza Gizli Anahtarı (Merchant Salt)

Bu üç bilgi gizlidir; paylaşmayın. Kopyalarken başta veya sonda boşluk kalmamasına dikkat edin; "Mağaza No eşleşmiyor" ve "hash doğrulanamadı" hatalarının en sık nedeni budur.

2. Invum POS'ta hesap ekleme

1. WordPress panelinde Invum POS › POS Hesapları sayfasını açın.
2. Yeni POS Hesabı Ekle düğmesine tıklayın.
3. Sağlayıcı listesinden PayTR (iframe) seçeneğini seçin. Kart formunu kendi sitenizde göstermek isterseniz PayTR (Direct API) seçin.
4. Hesap Etiketi alanına bir ad yazın (ör. "PayTR test").
5. Üye İşyeri No (Merchant ID), Mağaza Parolası (Merchant Key) ve Mağaza Gizli Anahtarı (Merchant Salt) alanlarına PayTR panelindeki değerleri yapıştırın.
6. İlk kurulumda Test Modu kutusunu işaretli bırakın.
7. Bayraklar bölümünde Etkin — ödeme sayfasında sunulsun seçeneğini açın; tek POS hesabınız bu ise Varsayılan hesap'ı da işaretleyin.
8. POS Hesabını Kaydet düğmesine basın.
9. Hesap listesinde Bağlantıyı test et ile bilgilerin kabul edildiğini doğrulayın. Bu test para çekmez.

Bilgileriniz şifrelenerek saklanır. Değiştirmek için yeni değeri girin; alanı boş bırakırsanız mevcut değer korunur.

Bildirim (callback) adresi

PayTR ödeme sonucunu sunucudan sunucuya bildirir; müşterinin tarayıcısı bu adımda yer almaz. Bildirim adresiniz:

https://siteniz.com/wp-json/invum-pos/v1/paytr/callback

(siteniz.com yerine kendi alan adınızı yazın.) Eklenti bu adresi ödeme isteğiyle birlikte iletir. PayTR mağaza panelinizde ayrıca bir bildirim adresi alanı varsa aynı adresi oraya da girin. Adres herkese açık olmalıdır: bakım modu, güvenlik duvarı veya "wp-json" erişimini kapatan bir eklenti ödeme dönüşünü engeller.

Taksit

PayTR (iframe) yönteminde taksit seçimi PayTR'nin sayfasında yapılır; vade farkı PayTR panelindeki ayarlardan gelir. Direct API'de taksit tablosu POS hesabı ekranındadır. Aynı komisyonu iki kez almamak için PayTR panelindeki vade farkı ayarıyla Invum POS tablosundaki oranlardan yalnız birini kullanın. BDDK taksit sınırları otomatik uygulanır.

Test modu ve test kartı

Test Modu açıkken gerçek para hareketi olmaz. PayTR'nin kamuya açık test kartı:

• Kart no: 4355 0843 5508 4358 (Visa, başarılı)
• Son kullanma: gelecekteki herhangi bir tarih
• CVV: 000
• 3D Secure şifresi: test modunda herhangi bir değer kabul edilir

Başarısız işlem denemek için PayTR dokümantasyonundaki ilgili test kartını kullanın (dev.paytr.com). Kartlar Invum POS › Test Kartları sayfasında da listelenir.

Deneme adımları: düşük tutarlı bir ürünü sepete ekleyin, ödemede PayTR'yi seçin, test kartıyla tamamlayın. Sipariş "İşleniyor" veya "Tamamlandı" olmalı; işlem Invum POS › İşlem Logları sayfasında görünmelidir.

Canlıya geçiş kontrol listesi

• PayTR mağazanızın canlıya alınmış (onaylı) olduğunu kontrol edin.
• Bilgileriniz test için aldığınız bilgilerden farklıysa canlı değerleri girin.
• POS hesabında Test Modu kutusunu kapatıp kaydedin. Kutu açık kalırsa canlı kartlar reddedilir (bkz. ERR_PAYTR_STORE_IN_TEST_MODE).
• Bağlantıyı test et düğmesine basın.
• Kendi kartınızla 1-5 TL'lik gerçek bir ödeme yapın; PayTR panelinde göründüğünü doğrulayın, isterseniz iade edin.
• Bildirim adresinin dışarıdan erişilebildiğinden emin olun.

Sık karşılaşılan sorunlar

• "Mağaza No eşleşmiyor": Test modu ile bilgiler uyuşmuyor ya da değer boşlukla kopyalandı.
• "Hash doğrulanamadı": Mağaza Gizli Anahtarı (Salt) hatalı. Elle yazmayın, kopyala-yapıştır kullanın. Bkz. ERR_3DS_CALLBACK_INVALID.
• Gerçek kart "test işlemi" diye reddediliyor: Test Modu açık kalmış ya da PayTR mağazanız henüz canlı değil. Bkz. ERR_PAYTR_STORE_IN_TEST_MODE.
• PayTR düz metin bir mesajla reddetti: Mağaza yapılandırması sorunudur. Bkz. ERR_PAYTR_PLAINTEXT_REJECTION.
• Sipariş beklemede kalıyor: Bildirim adresine PayTR ulaşamıyordur. Bkz. ERR_3DS_CALLBACK_FAILED.
• Ödeme reddedildi: Bkz. ERR_CHARGE_FAILED ve Banka red kodları rehberi.
• Alanlar boş: Bkz. ERR_GATEWAY_NOT_CONFIGURED.

Destek

Sorun yaşarsanız Hesabım › Destek Talepleri üzerinden bize yazın. İşlem Logları'ndaki hata kodunu ve yaklaşık saati eklemeniz çözümü hızlandırır.