VibeFox Helcim for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce yoksa eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

HTTPS ve PCI DSS: kart bilgileri ödeme sayfanızda girilir ve sunucunuzdan Helcim'e HTTPS üzerinden gönderilir. Asla saklanmaz veya günlüğe kaydedilmez ancak sunucunuzdan geçer; bu nedenle mağazanızın bir SSL sertifikasına ihtiyacı vardır ve barındırma hizmetiniz PCI DSS (SAQ D) standartlarını karşılamalıdır.

Helcim hesabı: Kanada veya Amerika Birleşik Devletleri'nde bir Helcim satıcı hesabı ve işlem gerçekleştirme yetkilerine sahip bir API belirteci (bkz. Yapılandırma). Helcim, CAD ve USD işlemlerini yürütür. Helcim test (geliştirici) hesabı test işlemleri için isteğe bağlıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_helcim_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Helcim'de All Tools > Integrations > API Access Configuration bölümünü açın, işlem yetkilerine sahip (satın almalar, ön provizyonlar, tahsilatlar, iadeler) bir API erişimi oluşturun ve belirtecini kopyalayın.

4. Ayarları açın: WooCommerce > Settings > Payments > Helcim > Manage yolunu izleyin veya Eklentiler sayfasında eklenti adının altındaki Settings seçeneğine tıklayın.

5. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bölümüne girin ve Activate düğmesine tıklayın.

6. Belirteci Live API token alanına yapıştırın ve varsa Helcim test hesabınızın belirtecini Test API token alanına yapıştırın.

7. Transaction type ve Account currencies seçeneklerini belirleyin, Enable / Disable ayarını açın ve kaydedin. Önce test etmek için Test mode ayarını açıp test hesabınızla ödeme yapın; ardından kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Helcim. Alanların üzerinde sayfa, mağaza para birimi Account currencies arasında yer almadığında ve ağ geçidi etkinken geçerli modun API belirteci boş olduğunda sizi uyarır. Her iki durumda da ağ geçidi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde ağ geçidi, geçerli mod bir belirtece sahip olana kadar kurulum gerektiriyor olarak işaretlenir.

Enable / Disable: Enable Helcim Gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: ödeme sayfasında gösterilen ödeme yöntemi başlığı. Varsayılan: Credit card (Helcim).

Description: ödeme sayfasında gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely with your credit card.

API kimlik bilgileri

Helcim'de All Tools > Integrations > API Access Configuration bölümüne gidin, bir API erişimi oluşturun ve belirtecini kopyalayın. Satın almalar, ön provizyonlar, tahsilatlar ve iadeler için işlem yetkileri verin. Helcim test hesapları canlı hesaplarla aynı API adresini kullanır, bu nedenle test modu yalnızca Helcim test hesabınızın belirtecini kullanır.

Live API token: canlı Helcim hesabınızın API belirteci. Test modu kapalıyken kullanılır.

Test mode: Use the Test API token (Helcim test account). Ödemeler, tahsilatlar ve iadeler Helcim test hesabınıza gider ve müşteriler bir test modu bildirimi görür. Bir siparişin iadeleri ve tahsilatları her zaman siparişin ödendiği modun belirtecini kullanır. Varsayılan: kapalı.

Test API token: Helcim test (geliştirici) hesabınızın API belirteci. Test modu açıkken kullanılır.

Ödeme

Transaction type: karttan nasıl çekim yapılacağı.

Account currencies: Helcim hesabınızın işleyebileceği para birimleri. Siparişler her zaman siparişin para biriminde tahsil edilir. Diğer para birimleri için ağ geçidi ödeme sayfasında gizlenir.

Gelişmiş

Debug log: Log API requests and responses, günlükler WooCommerce > Status > Logs yolunda, kaynak wcp_helcim_gateway. Kart numaraları son 4 haneye indirgenir. CVC, son kullanma tarihi, belirteçler, isimler, adresler, e-postalar ve IP adresleri asla günlüğe kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings, its own options (wc_hlg_*) and its log files when the plugin is deleted. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit card (Helcim)) ve ödeme sayfanızda Card Number, Expiry (MM/YY), CVC ve Cardholder Name bilgilerini girer. Başlığın yanında Visa, Mastercard, American Express ve Discover simgeleri gösterilir. Test modunda form TEST MODE — payments go to a Helcim test account, no real charges are made. uyarısını gösterir. Gönderilmeden önce eklenti kart numarası sağlama toplamını, son kullanma tarihinin geçerli ve geçmişte olmadığını, CVC'nin 3 veya 4 haneli olduğunu ve isim alanının doldurulduğunu kontrol eder.

Sipariş verildiğinde, sunucunuz kartı sipariş para biriminde sipariş toplamı tutarında bir satın alma veya ön provizyon olarak Helcim'e gönderir. Fatura adresi, telefon ve e-posta adres doğrulaması için iletilir. Ödeme Helcim'de sipariş numarası ve kısa bir koddan oluşan bir fatura numarası ile görünür. Helcim aynı istek içinde yanıt verir. Sipariş, yalnızca Helcim işlemi onayladıktan ve onaylanan tutar ile para birimi siparişle eşleştikten sonra ödendi olarak işaretlenir. Ardından müşteri sipariş alındı sayfasına yönlendirilir.

Sipariş başına aynı anda yalnızca bir ödeme denemesi çalışır ve önceden ödenmiş bir siparişten asla tekrar çekim yapılmaz. Her denemede bir idempotency anahtarı kullanılır. Helcim yanıt vermezse sipariş Ödeme bekleniyor durumunda kalır ve 5 dakika içindeki bir yeniden deneme karttan iki kez çekim yapmak yerine orijinal Helcim sonucunu döndürür.

Müşterinin görebileceği mesajlar: Helcim reddettiğinde Your card was declined. Please check the card details or use another card.; diğer reddedilen isteklerde Helcim'in gerekçesiyle birlikte Payment failed:; Helcim yanıt vermediğinde We could not confirm your payment with the card processor. Please try again in a minute; if the problem persists, contact us before using another card.; API belirteci eksik veya reddedildiğinde This payment method is temporarily unavailable. Please choose another payment method.; çift gönderimde Your payment is already being processed. Please wait a moment and check your e-mail before trying again. Teknik ayrıntılar sipariş notlarına ve günlüğe aktarılır.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda (aynı kart alanlarıyla) ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklenti HelcimPay.js veya Helcim.js kullanmaz, bu nedenle kart bilgileri sunucunuz üzerinden geçer. Kayıtlı kart, abonelik, ACH veya banka ödemesi, Apple Pay, Google Pay veya 3-D Secure desteği bulunmaz ve Helcim webhook'ları yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: ödeme reddedildi veya henüz onaylanmadı. Helcim yanıt vermediyse sipariş notu, müşteriden tekrar çekim yapmadan önce Helcim faturasını kontrol etmenizi ister.

Processing: bir satın alma onaylandı veya bir ön provizyon tahsil edildi. Yalnızca indirilebilir sanal ürünler içeren siparişler WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notu işlem kimliğini, onay kodunu, kart türünü, son 4 haneyi ve modu gösterir. İşlem kimliği Helcim işlem kimliğidir.

On hold (pre-authorization): tutarlar yalnızca bloke edilmiştir. Sipariş işlemiyle bunları tahsil edin veya tam bir iade ile serbest bırakın.

On hold after payment: Helcim bir işlemi onayladı ancak yanıtındaki tutar, para birimi veya işlem kimliği siparişle eşleşmedi. Notta Helcim response verification FAILED yazar. Siparişi karşılamadan önce Helcim'deki işlemi kontrol edin.

Tahsilat

Siparişi açın (durumu Beklemede), Capture Helcim pre-authorization sipariş işlemini seçin ve Update düğmesine tıklayın. İadeler düşüldükten sonraki mevcut sipariş toplamı tahsil edilir. Yetkilendirilen tutardan daha düşük olabilir ancak daha yüksek olamaz. Tahsilat, siparişin ödendiği modun belirtecini kullanır. Başarılı bir tahsilatın ardından sipariş Hazırlanıyor durumuna geçer ve işlem kimliği tahsilat işlemine dönüşür. Tahsilat başarısız olursa neden gösterilir ve sipariş notlarına eklenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit card (Helcim) düğmesine tıklayın (düğmede sizin Title bilginiz görünür). Bir satın alma veya tahsil edilmiş bir ön provizyonun tam ve kısmi iadeleri desteklenir. Tahsil edilmemiş bir ön provizyon yalnızca tamamen iade edilebilir: bloke kaldırılır ve müşteriden ücret alınmaz. İade, siparişin ödendiği modda gönderilir, bu nedenle o modun belirteci tanımlanmış olmalıdır. Yalnızca Helcim onayladığında geçerli sayılır. Helcim reddederse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Helcim iade işlem kimliğiyle birlikte sipariş notlarına eklenir. Zaman aşımından sonra yapılan bir yeniden deneme mükerrer iade yapmaz.

Eklenti Helcim webhook'larını almaz. Helcim panelinde yapılan tahsilat, iade ve iptal işlemleri WooCommerce'e yansımaz; bu nedenle bu işlemleri WooCommerce üzerinden gerçekleştirin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü, WooCommerce > Settings > Payments > Helcim sayfasının en üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm, örneğin lisansın geçerlilik tarihini ve alan adınızı içeren durumu gösterir. Durumu tekrar denetlemek için Check now, başka bir anahtar girmek için Change key ve bu siteden kaldırmak için Remove key seçeneklerini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını boşa çıkarmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Helcim, ödeme sayfasında müşterilere gösterilmez. Buna rağmen bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Giriş yapmış mağaza yöneticileri, anahtar satın almadan önce eklentiyi kurup test edebilmeniz için (unlicensed — visible to admins only) olarak işaretlenmiş ödeme yöntemini görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatıcı görünür. Mevcut siparişler etkilenmez: tahsilatlar ve iadeler çalışmaya devam eder.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder ancak güncellemeler ve destek için yenileme gerekir. Durum, arka planda otomatik olarak tekrar kontrol edilir.

Sorun giderme

Helcim ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable ayarının açık olduğunu, geçerli modun API belirtecine sahip olduğunu (canlıda Live API token, test modunda Test API token) ve sepet para biriminin Account currencies arasında yer aldığını kontrol edin. Pay for order sayfasında sipariş para birimi geçerlidir. Ayarlar sayfası her iki durumda da bir uyarı gösterir.

Helcim yanıt vermedi ve sipariş Ödeme bekleniyor durumunda kaldı: karttan çekim yapılmış olabilir. Müşteriden tekrar çekim yapmadan önce sipariş notunu okuyun ve Helcim'deki faturayı kontrol edin. 5 dakika içindeki bir yeniden deneme orijinal sonucu döndürür ve mükerrer çekim yapmaz.

Müşteriler This payment method is temporarily unavailable mesajını görüyor: geçerli modun API belirteci boş veya Helcim tarafından reddedildi. Sipariş notu belirteci ve izinlerini kontrol etmenizi söyler. API erişiminin işlem gerçekleştirme yetkilerine sahip olduğundan emin olun.

Ödeme bir Helcim gerekçesiyle başarısız oldu: Helcim, örneğin kart veya fatura bilgileri nedeniyle isteği reddetti. Sipariş notunda ayrıntılar yer alır.

Ödemeden sonra sipariş Beklemede durumunda: sipariş notunu okuyun. Sipariş için ön provizyon alınmış ve tahsilat bekleniyor olabilir veya Helcim'in yanıtı siparişle eşleşmemiştir (yanıt doğrulaması başarısız oldu).

Tahsilat yapılamıyor: tahsil edilecek tutar 0'dan büyük olmalı ve yetkilendirilen tutarı aşmamalıdır ve siparişin ödendiği modun belirteci tanımlanmış olmalıdır.

İade başarısız oluyor: mesajı okuyun. Tahsil edilmemiş bir ön provizyon yalnızca tamamen iade edilebilir. Modla ilgili bir mesaj, siparişin ödendiği modun belirtecinin boş olduğu anlamına gelir. Reddedilen bir iade kaydedilmez.

Test ödemeleri: test modu ödemeleri, tahsilatları ve iadeleri Helcim test hesabınıza gönderir. Siparişler ödendikleri modu korur, bu nedenle modu daha sonra değiştirmek bu siparişlerin tahsilat ve iadelerini diğer hesaba aktarmaz.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti bilinen son durumla çalışmaya devam eder.

Geliştiriciler için: wc_hlg_supported_currencies filtresi para birimleri listesini, wc_hlg_card_brands ise ödeme sayfasındaki kart simgelerini değiştirir.

Kaldırma

Eklenti devre dışı bırakıldığında tüm veriler korunur. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, eklentinin kendi seçenekleri ve günlükler yalnızca Delete data on uninstall açık olduğunda kaldırılır. Aksi takdirde daha sonra yeniden kurulum için kalırlar. Sipariş verileri sipariş geçmişinin bir parçasıdır ve asla silinmez. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Helcim, ilgili sahibinin ticari markasıdır. Bu eklenti Helcim ile bağlantılı değildir ve Helcim tarafından onaylanmamıştır.