VibeFox Vindi for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Brezilya Reali (BRL). Vindi yalnızca BRL ile tahsilat yapar, bu yüzden diğer para birimlerinde ödeme yöntemi gizlenir.

Vindi hesabı: Vindi hesabınızın API anahtarına ihtiyacınız vardır. Vindi sandbox, kendi anahtarına sahip ayrı bir test hesabıdır. Boleto, PIX ve BolePix'i sunmak istiyorsanız bunların Vindi hesabınızda da etkin olması gerekir.

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

Kurulum

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

2. Ayarları açın: WooCommerce > Settings > Payments > Vindi > Manage ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

3. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

4. Sandbox API key değerini, hazır olduğunuzda Live API key değerini yapıştırın. Offered methods seçeneklerini belirleyin.

5. Ayarlardaki webhook URL'sini Vindi'ye kopyalayın (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Vindi. Alanların üstünde, mağaza para birimi BRL değilse veya geçerli modun API anahtarı boşsa sayfa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gösterilmez. Ödeme yöntemleri listesinde, geçerli modda API anahtarı olana kadar Vindi kurulum gerektiren olarak işaretlenir. Kaydettiğinizde anahtarlar kırpılır; hiçbir ödeme yöntemi seçili değilse kredi kartı seçilir ve sayfada Choose at least one payment method — credit card was selected. mesajı görünür.

Genel

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

Title: ödeme sayfasında gösterilen ödeme yönteminin adı. Varsayılan: Vindi.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay by credit card on the secure Vindi page, or by boleto / PIX.

API anahtarları

Anahtarları Vindi panelinde Settings > API keys altında oluşturun: canlı için app.vindi.com.br, sandbox için sandbox-app.vindi.com.br. Her sipariş faturasının oluşturulduğu ortamı kaydeder; bu nedenle kontroller, iptaller ve iadeler her zaman o ortamı kullanır.

Sandbox mode: Create new payments in the Vindi sandbox, sandbox API anahtarıyla sandbox-app.vindi.com.br adresini kullanır. Müşteriler ödeme sayfasında TEST MODE notunu görür: Vindi sandbox: no real charges. Varsayılan: on. Gerçek ödemeleri kabul etmek için işareti kaldırın.

Live API key: canlı Vindi hesabının özel anahtarı. Yalnızca Vindi API'sine gönderilir.

Sandbox API key: Vindi sandbox hesabının özel anahtarı.

Ödeme yöntemleri

Offered methods: müşterilerin seçebileceği yöntemler. Varsayılan: credit card. Yöntemlerin Vindi hesabınızda da etkin olması gerekir.

Ödeme bildirimleri (webhook)

Webhook, mağazanıza bir faturanın ödendiğini, iptal edildiğini veya iade edildiğini bildirir. Ayarların bu bölümünde webhook URL'si gösterilir. URL şu biçimdedir: https://your-site/wc-api/webhook_wc_vindi/?token=... ve eklenti tarafından oluşturulan gizli bir jeton içerir. Ayarlarda gösterildiği gibi aynen kopyalayın. Vindi'de canlı hesapta ve sandbox hesabında Settings > Webhooks bölümüne gidin, bu URL'yi ekleyin ve şu olayları seçin:

Jetonu eksik veya hatalı olan istekler reddedilir. Her bildirim, bir sipariş değişmeden önce eklentinin faturayı yalnızca Vindi API'si üzerinden yeniden okumasını sağlar. Webhook olmadan kart, boleto ve PIX ödemeleri yalnızca müşteri sipariş alındı sayfasını açtığında onaylanır.

Gelişmiş

Debug log: Log API calls and notifications ayrıntıları WooCommerce > Status > Logs sayfasına, wcp_vindi_gateway kaynağıyla yazar. Hatalar ve uyarılar bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: off.

Delete data on uninstall: Remove the settings, webhook token and logs when the plugin is deleted. Varsayılan: off.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Vindi). Birden fazla yöntem sunulduğunda ödeme kutusunda Pay with ve kredi kartı, boleto, PIX veya BolePix arasında bir seçim görünür. Boleto, PIX veya BolePix sunulduğunda kutuda ayrıca bir CPF or CNPJ alanı bulunur. Yalnızca bu yöntemler sunuluyorsa alan zorunludur; aksi halde Required for boleto and PIX. mesajı gösterilir. Numara kontrol basamaklarıyla doğrulanır. Brazilian Market on WooCommerce etkin olduğunda klasik ödeme sayfasında alan gösterilmez, çünkü bu eklenti CPF / CNPJ'yi zaten ister. Bu durumda o eklentinin CPF / CNPJ, bina numarası ve mahalle bilgileri kullanılır. Eksik bir bilgi varsa müşteri Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. veya Please enter your CPF or CNPJ — it is required for boleto and PIX. mesajlarından birini görür.

Sipariş verildiğinde eklenti, fatura bilgilerinden bu sipariş için bir Vindi müşterisi ve sipariş tutarı için tek taksitli bir Vindi faturası oluşturur.

Credit card: müşteri Vindi fatura sayfasına yönlendirilir ve ödemeyi orada yapar. Vindi'nin faturalar için bir dönüş URL'si yoktur, bu yüzden müşteri otomatik olarak mağazaya geri dönmez. Sipariş, webhook ile ya da müşteri sipariş alındı sayfasını açtığında onaylanır. Ödeme tamamlanana kadar bu sayfada ve My account altındaki siparişte Your payment has not been completed yet. mesajı ile Pay at Vindi düğmesi görünür.

Boleto, PIX ve BolePix: fatura hemen oluşturulur, sipariş Beklemede durumuna geçer ve müşteri sipariş alındı sayfasına gelir. Orada ve My account > Orders bölümünde Payment başlığı altında PIX QR kodu, Copy code düğmesiyle birlikte kopyala-yapıştır PIX kodu ve son kullanma tarihi, ayrıca Open boleto düğmesi gösterilir. Müşterinin beklemedeki sipariş e-postası ve fatura e-postası PIX kodunu ve boleto bağlantısını içerir.

Sipariş, yalnızca Vindi onayladıktan sonra ödenmiş olarak işaretlenir: eklenti faturayı Vindi API'sinden okur ve faturanın siparişe ait olduğunu (sipariş kodu ve Vindi müşterisi) ve ödenen tutarın sipariş toplamına eşit olduğunu kontrol eder.

Müşteri, ödenmemiş bir siparişi Pay for order sayfasından yeniden ödeyebilir. Yöntem, tutar ve ortam aynıysa bekleyen Vindi faturası yeniden kullanılır. Aksi halde yeni bir fatura oluşturulmadan önce Vindi'de iptal edilir; böylece müşteri aynı siparişi iki kez ödeyemez. Önceki fatura bu arada ödendiyse sipariş ödenmiş olarak işaretlenir ve yeni fatura oluşturulmaz.

Vindi ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin CPF / CNPJ, fatura adresi, e-posta veya telefon numarasını kontrol etmesi ya da Vindi'nin geçici olarak kullanılamadığına dair bir mesaj. Aynı sipariş o anda başka bir istek tarafından işleniyorsa müşteriden kısa bir süre beklemesi ve yeniden denemesi istenir.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca tek taksitli tek seferlik ödemeleri kabul eder. Abonelik veya yinelenen faturalandırma, kayıtlı kart, taksit ve sitenizde kart formu yoktur: kart her zaman Vindi sayfasında girilir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: bir kart ödemesi başlatıldı ve Vindi henüz onaylamadı.

On hold: bir boleto, PIX veya BolePix ödemesi bekliyor (Awaiting ... payment at Vindi. notu) ya da Vindi faturası incelemede.

Processing or Completed: ödeme onaylandı. Durum WooCommerce'in standart yöntemiyle ayarlanır: İşleniyor veya yalnızca sanal indirilebilir ürün içeren siparişler için Tamamlandı. Sipariş notu Vindi faturasını, tutarı ve ortamı gösterir. İşlem kimliği Vindi fatura kimliğidir.

On hold after payment: ödenen fatura siparişle eşleşmiyor (tutar, sipariş kodu veya Vindi müşterisi) ya da fatura sipariş iptal edildikten sonra ödendi. Sipariş notu bunu açıklar. Siparişi ve stoğu kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Failed: Vindi ödeme denemesini reddetti. Not, varsa acquirer'dan gelen nedeni gösterir. Müşteri aynı faturayı yine ödeyebilir ve sonraki bir ödeme siparişi tamamlar.

Cancelled: fatura Vindi'de iptal edildi ya da sipariş sizin, müşterinin veya WooCommerce'in stok bekletme zaman aşımı tarafından iptal edildi. Bir sipariş mağazada iptal edildiğinde bekleyen Vindi faturası da iptal edilir, böylece artık ödenemez. Bu mümkün değilse bir not, faturayı Vindi panelinden iptal etmenizi ister. Stok bekletme zaman aşımı bir siparişi iptal etmeden önce fatura kontrol edilir: bu arada ödendiyse sipariş bunun yerine ödenmiş olarak işaretlenir.

Zaten ödenmiş bir sipariş için ikinci bir fatura ödenirse sipariş yeniden değiştirilmez. Bir not, Vindi'de bir ödemeyi iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Vindi düğmesine tıklayın. Kart ve PIX ödemelerinin tam ve kısmi iadeleri desteklenir. Tam iade, Vindi'deki faturayı da iptal eder. İade, ödemenin ortamında (canlı veya sandbox) gönderilir; bu nedenle o ortamın API anahtarı tanımlı olmalıdır. Başarılı bir iade, Vindi tahsilatı ve durumuyla birlikte sipariş notlarına eklenir. Vindi veya acquirer iadeyi reddederse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez.

Vindi boleto ödemelerini iade edemez. Eklenti Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually. mesajını gösterir.

Vindi panelinde yapılan iadeler charge_refunded webhook'u ile gelir ve sipariş notlarına eklenir. Bunlar otomatik olarak WooCommerce iadesi olarak kaydedilmez. Gerekirse Refund via Vindi kullanmadan WooCommerce'de manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Vindi sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o alan adının yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Vindi müşterilere ödeme sayfasında 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Vindi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, mağaza para biriminin BRL olduğunu, Offered methods altında en az bir yöntemin seçili olduğunu ve geçerli modun API anahtarı olduğunu kontrol edin: sandbox modunda Sandbox API key, canlı modda Live API key. Anahtar eksikse ya da para birimi BRL değilse ayarlar sayfası bir uyarı gösterir.

Ödeme geçti, ancak sipariş Pending payment veya On hold durumunda kalıyor: webhook çalışmıyor. Vindi'de kullandığınız hesapta (canlı veya sandbox) webhook'un var olduğunu, URL'sinin ayarlarda gösterilenle tam olarak aynı olduğunu (jeton dahil) ve dört olayın da seçili olduğunu kontrol edin. Müşteri sipariş alındı sayfasını açtığında sipariş yine onaylanır.

Webhook Forbidden yanıtı veriyor: URL'deki jeton eksik veya hatalı. URL'yi ayarlardan yeniden kopyalayın.

Webhook Verification failed, retry later veya Order busy, retry later yanıtı veriyor: fatura Vindi API'sinden okunamadı (örneğin o ortamın API anahtarı kaldırıldı) ya da sipariş tam o anda başka bir istek tarafından güncelleniyordu. Vindi bildirimi yeniden gönderir.

Müşteri This payment method is temporarily unavailable mesajını görüyor: Vindi API anahtarını reddetti. Geçerli modun anahtarını kontrol edin.

Müşteri sipariş verirken bir hata görüyor: WooCommerce > Status > Logs altında, wcp_vindi_gateway kaynağıyla sipariş notlarını ya da günlüğü açın. Debug log kapalı olsa bile hatalar kaydedilir. Boleto için fatura adresinde cadde, posta kodu, şehir ve eyalet bulunmalıdır.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar, sipariş kodu veya Vindi müşterisi siparişle eşleşmiyordu ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi tamamlayın veya ödemeyi iade edin.

Canlıya geçtikten sonra eski sandbox siparişleri: her sipariş, faturasının ortamını korur. Sandbox siparişlerinin kontrolleri, iptalleri ve iadeleri, sandbox anahtarı ayarlarda kaldığı sürece o anahtarı kullanmaya devam eder.

İade başarısız oluyor: mesajı okuyun. Boleto ödemeleri Vindi üzerinden iade edilemez ve ödemenin ortamının API anahtarı tanımlı olmalıdır.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Tamamen kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, webhook jetonu, eklentinin depolanan diğer verileri ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde ileride yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve Vindi verilerini korur.

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