VibeFox Helcim for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerinde kurulmayı reddeder.

HTTPS ve PCI DSS: kart bilgileri ödeme sayfanızda girilir ve sunucunuzdan Helcim'e HTTPS üzerinden gönderilir. Bu bilgiler asla saklanmaz veya günlüğe yazılmaz, 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) gerekliliklerini karşılamalıdır.

Helcim hesabı: Kanada veya Amerika Birleşik Devletleri'nde bir Helcim satıcı hesabı ve işlem işleme yetkisine sahip bir API belirteci (bkz. Yapılandırma). Helcim CAD ve USD işler. Test için Helcim test (geliştirici) hesabı 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. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Helcim Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

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

6. Transaction type ve Account currencies seçeneklerini belirleyin, Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Önce test etmek için Test mode seçeneğini açın ve test hesabınızla ödeme yapın; sonra kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Helcim payment authorized ve Helcim payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Helcim Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, mağazanızın varsayılan para biriminin Account currencies arasında olmadığını ve ödeme yöntemi etkinken geçerli modun API belirtecinin boş olduğunu size bildirir. Bu durumda ödeme yöntemi ödeme sayfasında gizlenir.

Helcim

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

Title: ödeme sayfasında gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit card (Helcim). Zorunlu.

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. Ona satışlar, ön provizyonlar, tahsilatlar ve iadeler için işlem işleme yetkisi verin. Helcim test hesapları canlı hesaplarla aynı API adresini kullanır; dolayısıyla 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: Test API token'ı kullanır (Helcim test hesabı). Ödemeler, tahsilatlar ve iadeler Helcim test hesabınıza gider ve müşteriler bir test modu uyarısı görür. Bir siparişin tahsilatları ve iadeleri her zaman siparişin ödendiği modun belirtecini kullanır. Varsayılan: off.

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

Kaydedilmiş belirteçler bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved tokens: bir belirteci işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kaydedilmiş değeri korur.

Ödeme

Transaction type: kartın nasıl çekileceği.

Account currencies: Helcim hesabınızın işleyebildiği para birimleri. Siparişler her zaman sepetin para biriminde çekilir. Diğer para birimleri için ödeme yöntemi ödeme sayfasında gizlenir.

Gelişmiş

Debug log: API isteklerini ve yanıtlarını modül klasöründeki logs/wc_hlg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Kart numaraları son 4 haneye indirilir. CVC, son kullanma tarihi, belirteçler, adlar, adresler, e-postalar ve IP adresleri asla kaydedilmez. Hatalar (reddedilen veya başarısız ödemeler, API hataları, başarısız tahsilatlar ve iadeler) bu seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: off.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa modül kaldırıldığında gateway ayarları ve günlük dosyaları silinir. Helcim işlemleri, iadeler ve sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak bir kart simgesiyle Credit card (Helcim)) ve altındaki formda Card Number, Expiry (MM/YY), CVC ve Cardholder Name alanlarını doldurur. Test modunda form TEST MODE — payments go to a Helcim test account, no real charges are made. ifadesini gösterir. Müşteri siparişi verdiğinde modül 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 adın doldurulduğunu kontrol eder. Hatalar ödeme sayfasında gösterilir ve Helcim'e hiçbir şey gönderilmez.

Ardından sunucunuz kartı, sepet para biriminde sepet toplamı için satış veya ön provizyon olarak Helcim'e gönderir. Fatura adresi, telefon ve e-posta adres doğrulaması için iletilir. Ödeme Helcim'de; sepet numarası, -PS ve kısa bir koddan oluşan bir fatura numarasıyla görünür. Helcim aynı istekte yanıt verir. Sipariş yalnızca Helcim işlemi onayladıktan sonra oluşturulur ve müşteri standart sipariş onay sayfasına yönlendirilir. Bundan önce hiçbir sipariş yoktur.

Bir sepet için aynı anda yalnızca bir ödeme denemesi çalışır ve zaten siparişi olan bir sepetten asla tekrar çekim yapılmaz. Her deneme bir idempotency anahtarı kullanır. Helcim yanıt vermezse sipariş oluşturulmaz ve 5 dakika içindeki bir yeniden deneme, karttan iki kez çekim yapmak yerine orijinal Helcim sonucunu döndürür. Ödeme onaylanmış ama sipariş oluşturulamamışsa, aynı sepetin bir sonraki denemesi kartı yeniden çekmeden siparişi oluşturur.

Müşterinin ödeme sayfasında görebileceği mesajlar: Helcim reddettiğinde Your card was declined. Please check the card details or use another card.; Helcim diğer reddedilen isteklerde neden belirtirse 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 olduğunda veya Helcim tarafından 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.; ödeme onaylanmış ama sipariş otomatik oluşturulamamışsa Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.. Sepet korunur. Teknik ayrıntılar günlüğe yazılır.

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

Siparişler ve iadeler

Sipariş durumları

No order: kart reddedildi, Helcim yanıt vermedi veya müşteri henüz ödeme yapmadı. Yalnızca sepet vardır. Reddedilmeler ve hatalar günlüğe yazılır.

Payment accepted: bir satış onaylandı veya bir ön provizyon tahsil edildi. Ödeme Helcim işlem kimliğiyle kaydedilir ve bir not işlem kimliğini, onay kodunu, kart türünü, son 4 haneyi ve modu gösterir.

Helcim payment authorized: bir ön provizyon onaylandı. Tutar yalnızca bloke edilmiştir. Tahsil edin veya tam iadeyle serbest bırakın.

Helcim payment on hold: Helcim bir işlemi onayladı, ancak yanıttaki tutar, para birimi veya işlem kimliği sepetle eşleşmiyor; örneğin kısmi onaydan sonra veya ödeme sırasında sepet değiştiğinde. Not Helcim response verification FAILED ifadesini gösterir. Satışlarda ödeme, Helcim'in gerçekte çektiği tutarla kaydedilir. Siparişi işlemeden önce işlemi Helcim'de kontrol edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Canceled: tahsil edilmemiş bir ön provizyon serbest bırakıldı. Müşteriden çekim yapılmadı.

Zaten siparişi olan bir sepet için ikinci bir işlem onaylanırsa sipariş değişmez. Bir not, bunu kontrol edip Helcim'de iptal etmenizi veya iade etmenizi ister.

Helcim ödeme bloğu

Sipariş sayfasında Helcim payment bloğu görünür; bu blok işlem kimliğini (tahsilattan sonra ön provizyon kimliğini de), işlem türünü ve tahsilat durumunu, fatura numarasını, kartı ve onay kodunu, onaylanan tutarı, sipariş toplamını ve iade edilen tutarı, test ödemeleri için bir Test mode rozetini, iade geçmişini ve siparişin Helcim notes notlarını içerir. Tahsilat ve iadeler için siparişleri düzenleme yetkisi gerekir.

Tahsilat

Helcim payment authorized durumundaki bir sipariş için bloktaki Capture payment düğmesine tıklayın ve Capture the pre-authorized amount through Helcim? ifadesini onaylayın. İadeler düşüldükten sonra mevcut sipariş toplamı tahsil edilir. Bu tutar ön provizyon tutarından düşük olabilir, ama yüksek olamaz. Tahsilat, siparişin ödendiği modun belirtecini kullanır. Tahsilat başarılı olursa sipariş Ödeme alındı durumuna geçer ve ödeme tahsilat işlem kimliğiyle kaydedilir. Tahsilat başarısız olursa blok nedeni gösterir ve notlara ekler.

İadeler

Bloğa tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Helcim düğmesine tıklayın. Refund this amount through Helcim? This cannot be undone. ifadesini onaylayın. Bir satışın veya tahsil edilmiş bir ön provizyonun tam ve kısmi iadeleri, Helcim'in gerçekte çektiği tutara kadar desteklenir; bu nedenle kısmi onaydan sonra müşterinin ödediğinden fazlasını iade edemezsiniz. Tahsil edilmemiş bir ön provizyon için düğme Release pre-authorization olur: yalnızca tam tutar serbest bırakılabilir, blokesi kaldırılır ve sipariş İptal edildi durumuna geçer.

İade, siparişin ödendiği modda gönderilir; bu nedenle o modun belirteci ayarlı olmalıdır. İade yalnızca Helcim onaylarsa geçerli sayılır. Helcim reddederse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Helcim iade işlem kimliğiyle eklenir. Tam iade siparişi Refunded durumuna alır. Kısmi iade durumu değiştirmez. Zaman aşımından sonraki bir yeniden deneme iki kez iade yapmaz.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Helcim üzerinden para geri göndermez. Modül Helcim webhook'ları almaz: Helcim panelinde yapılan tahsilat, iade ve iptal işlemleri PrestaShop'a yansımaz; bu yüzden bunları sipariş sayfasından yapın.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Modülün Configure sayfasının üstündeki lisans bloğu License — VibeFox Helcim Gateway,Modules > Module Manager > VibeFox Helcim Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-helcim satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Helcim ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. PrestaShop vitrini back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten yapılmış ödemeler korunur ve tahsilatlar ile iadeler çalışmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonra haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Helcim ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, geçerli modun API belirtecinin (Live API token veya test modunda Test API token) bulunduğunu ve sepet para biriminin Account currencies arasında olduğunu kontrol edin. Ayarlar sayfası, belirteç eksik olduğunda veya mağaza para birimine izin verilmediğinde bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Müşteri "We could not confirm your payment" mesajını gördü: Helcim yanıt vermedi, bu nedenle kart çekilmiş olabilir. Log alanına bakın: hata sepeti ve Helcim faturasını belirtir. Müşteriden tekrar çekim yapmadan önce bu faturayı Helcim'de kontrol edin. 5 dakika içindeki bir yeniden deneme orijinal sonucu döndürür ve iki kez ç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 reddedilmiş. Günlük belirteci ve yetkilerini kontrol etmenizi söyler. API erişiminin işlem işleme yetkisine sahip olduğundan emin olun.

Ödeme bir Helcim nedeniyle başarısız oldu: Helcim isteği reddetti; örneğin kart veya fatura bilgileri nedeniyle. Ayrıntılar günlükte yer alır.

Müşteri "Your payment was received, but the order could not be completed" mesajını gördü: Helcim ödemeyi onayladı, ancak PrestaShop siparişi oluşturamadı (örneğin modül devre dışıysa). Günlük nedeni gösterir. Müşteri aynı sepeti tekrar gönderdiğinde sipariş, ikinci bir çekim olmadan onaylanmış ödemeden oluşturulur.

Sipariş Helcim payment on hold durumunda: Helcim bloğundaki notları okuyun. Helcim'in yanıtı sepetle eşleşmedi (yanıt doğrulaması başarısız oldu). İşlemi Helcim'de kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Tahsilat mümkün değil: tahsil edilecek tutar 0'dan büyük olmalı ve ön provizyon tutarını aşmamalıdır; ayrıca siparişin ödendiği modun belirteci ayarlı olmalıdır.

İade başarısız: mesajı okuyun. Tahsil edilmemiş bir ön provizyon yalnızca tam olarak serbest bırakılabilir. Mod ile 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, onların tahsilatlarını ve iadelerini diğer hesaba taşımaz.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Helcim Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa gateway ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Helcim işlemleri ve iadeleri ile Helcim payment authorized ve Helcim payment on hold sipariş durumları her zaman saklanır; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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