VibeFox Iugu for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Brezilya Reali (BRL). Iugu yalnızca BRL ile tahsilat yapar. Ödeme yöntemi, mağaza veya Pay for order sayfasındaki sipariş başka bir para birimi kullanıyorsa ve R$ 1,00'ın altındaki toplamlarda (Iugu minimumu) gizlenir.

Iugu hesabı: Iugu panelinden iki API jetonu gerekir: biri "Test" türünde, diğeri "Live" türünde (bkz. Yapılandırma). Iugu iki jeton için de tek bir API adresi kullanır: faturanın test mi gerçek mi olacağına jeton karar verir. Iugu'da webhook kurmanız gerekmez.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_iugu_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. WooCommerce > Settings > General bölümünde mağaza para birimini Brezilya Reali (BRL) olarak ayarlayın.

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

5. Sayfanın üst kısmındaki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

6. Test ve canlı API jetonlarını girin (bkz. Yapılandırma), Test mode seçeneğini açık bırakın, Enable / Disable seçeneğini açın ve kaydedin.

7. Bir test siparişi verin ve Iugu test kartıyla ödeyin. Hazır olduğunuzda Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Iugu. Sayfa, ağ geçidi başlığının altında TEST MODE (faturalar test API jetonuyla oluşturulur, gerçek tahsilat yapılmaz) ya da LIVE gösterir. Etkin modun jetonu eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağaza para birimi BRL değilse uyarır. Ödeme yöntemleri listesinde, etkin modun jetonu girilene kadar Iugu kurulum gerektiren olarak işaretlenir; test modu açık olduğu sürece test modu rozeti gösterir.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Iugu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Iugu. You will be redirected to complete your payment.

API kimlik bilgileri

API jetonlarını Iugu Alia'da (alia.iugu.com) oluşturun: Settings > API integration > New. Bir "Test" türünde ve bir "Live" türünde jeton oluşturun.

Test mode: Use the test API token (no real charges). Varsayılan: on. Test modu açıkken ödeme sayfasında açıklamanın üstünde SANDBOX — Test mode enabled. No real charges. görünür. Bir siparişin durum sorguları ve iadeleri her zaman faturasının oluşturulduğu modun jetonunu kullanır; bu yüzden modu değiştirmek eski siparişleri bozmaz.

Test API token: "Test" türündeki Iugu API jetonu. Test modu açık olduğunda kullanılır.

Live API token: "Live" türündeki (üretim) Iugu API jetonu. Test modu kapalı olduğunda kullanılır. Gizli tutun.

Ödeme bildirimleri

Her fatura, durum değişikliklerini mağazanızın bildirim URL'sine bildirmesi için Iugu'ya talimat verir; bu URL ayarların bu bölümünde gösterilir. Şuna benzer: https://your-site/wc-api/webhook_wc_iugu/. Iugu'da yapılandırılacak bir şey yoktur. Aynı URL'ye yönlenen ek bir hesap genelinde tetikleyici (gatilho) zararsızdır. Bildirimler mağazanın güvendiği hiçbir ödeme verisi taşımaz: sipariş değişmeden önce fatura her zaman Iugu API'sinden okunur (durum, tutar, para birimi).

Eklenti, fatura durumunu değiştirebilecek Iugu olaylarına tepki verir: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action ve invoices. Bunların her biri için faturayı okur ve durumunu uygular:

Diğer olaylar ve bu mağazanın siparişine ait olmayan faturalar OK yanıtı alır ve yok sayılır. Bildirim olmadan, bir sipariş yalnızca müşteri Iugu sayfasından mağazaya döndüğünde kontrol edilir.

Gelişmiş

Debug log: Log API requests and notifications, WooCommerce > Status > Logs sayfasında, kaynak wcp_iugu_gateway; jeton veya müşteri verisi içermez. Hatalar her zaman kaydedilir. Varsayılan: off.

Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Iugu) ve siparişi verir. Geçerli bir fatura e-posta adresi gereklidir. Eklenti, sipariş toplamı için BRL cinsinden bir Iugu faturası oluşturur; son ödeme tarihi 3 gün sonrasıdır ve müşteriyi Iugu fatura sayfasına yönlendirir. Orada müşteri, Iugu hesabınızda etkin olan yöntemlerle kredi kartı, boleto veya PIX ile öder. Müşterinin adı ve e-postası Iugu'ya iletilir; varsa "Brazilian Market on WooCommerce" ödeme alanlarından CPF/CNPJ, bina numarası ve semt de iletilir. Telefon ve adres yalnızca Iugu'nun kabul ettiği biçimde gönderilir (Brezilya telefon numaraları, 8 haneli CEP'li Brezilya adresleri).

Ödemeden sonra müşteri mağazanızın "Sipariş alındı" sayfasına döner. Sipariş, yalnızca Iugu onayladığında ödenmiş olarak işaretlenir: fatura, müşteri döndüğünde ve Iugu bildirim gönderdiğinde Iugu API'sinden okunur. Müşteri bir boleto veya PIX kodu oluşturup ödemeden dönmüşse, Iugu ödemeyi onaylayana kadar sipariş Beklemede durumuna alınır. WooCommerce'in ödenmemiş sipariş zamanlayıcısı, Iugu faturası hâlâ açık olan siparişleri iptal etmez.

Fatura iptal edildiyse ya da süresi dolduysa ve sipariş hâlâ ödenebilir durumdaysa, müşteri The Iugu invoice was not paid (it was canceled or has expired). You can pay the order again below. mesajıyla Pay for order sayfasına gelir. Müşteri yeniden ödediğinde, tutar değişmemişse eklenti onu aynı açık faturaya yönlendirir. Aksi halde eski faturayı Iugu'da iptal eder ve yeni bir fatura oluşturur; böylece bir sipariş iki açık fatura üzerinden iki kez ödenemez. Eski bir fatura yine de ödenirse, ödeme siparişle eşleştirilmeye devam eder.

Iugu faturayı oluşturamazsa müşteri kısa bir mesaj görür; örneğin nedeni ve fatura bilgilerini kontrol etme isteğiyle birlikte Iugu could not create the invoice:, ya da Could not connect to Iugu. Please try again in a moment. Teknik neden sipariş notlarına ve günlüğe eklenir.

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

Eklenti yalnızca tek seferlik ödemeleri destekler. Sitede kart formu, kayıtlı kartlar, abonelikler veya yinelenen faturalama, carnê (ödeme defteri), bölünmüş ödemeler veya taksit ayarları yoktur; taksit için Iugu sayfasındaki ayarları kullanın. Iugu sayfasında sunulan ödeme yöntemleri eklenti ayarlarında seçilemez: Iugu hesabınızda etkin olan tüm yöntemler sunulur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: fatura oluşturuldu ve müşteri henüz ödemedi.

Processing or Completed: Iugu ödemeyi onayladı. WooCommerce, ödenmiş bir sipariş için olağan durumu ayarlar. Sipariş notunda Iugu fatura kimliği ve ödeme yöntemi (kredi kartı, boleto veya PIX) görünür. İşlem kimliği Iugu fatura kimliğidir ve sipariş ekranında Iugu'daki faturaya bağlanır.

On hold: müşteri bir boleto veya PIX oluşturup mağazaya döndü (ödeme beklemede); kart ödemesi yetkilendirildi ama henüz tahsil edilmedi (Iugu'da tahsil edin; Iugu faturayı ödenmiş olarak bildirdiğinde sipariş tamamlanır); ödeme incelemede; fatura yalnızca kısmen ödendi; bir chargeback açıldı; ya da ödenen tutar veya para birimi siparişle eşleşmedi. Sipariş iptal edildikten sonra gelen bir ödeme de siparişi sessizce yeniden açmak yerine Beklemede durumuna alır. Sipariş notları hangisinin geçerli olduğunu belirtir.

Failed: fatura ödenmeden süresi doldu. Müşteri siparişi yeniden ödeyebilir.

Cancelled: fatura Iugu'da iptal edildi.

Refunded: siparişi ödeyen fatura Iugu'da iade edildi.

Aynı siparişin başka bir faturası da ödenirse sipariş yeniden değiştirilmez. Bir not, mükerrer ödemeyi Iugu'da iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Iugu düğmesine tıklayın. İade, faturanın oluşturulduğu modun jetonuyla gönderilir.

Yalnızca ödenmiş faturalar iade edilebilir ve Iugu'da hâlâ iade edilebilir olan tutarı aşamaz. İade, yalnızca Iugu onayladığında tamamlanmış sayılır. Iugu iadeyi reddeder veya onaylamazsa WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, fatura kimliği ve nedeniyle birlikte sipariş notlarına eklenir.

Iugu panelinde yapılan tam iade siparişi İade edildi olarak ayarlar. Panelde yapılan kısmi iadeler içe aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Iugu sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu 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 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, o alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Iugu, ö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. 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 yine onaylanır ve iadeler çalışır.

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 yeniden kontrol edilir.

Sorun giderme

Iugu ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve etkin modun jetonunun girildiğini kontrol edin: test modunda Test API token, canlı modda Live API token. Mağaza para birimi BRL olmalı ve sipariş toplamı en az R$ 1,00 olmalıdır. Jeton veya para birimi yanlışsa ayarlar sayfası uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kaldı: Iugu'dan gelen bildirim mağazanıza ulaşmadı veya kontrol edilemedi. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasına bakın, kaynak wcp_iugu_gateway. Sitenizin, ayarlarda gösterilen bildirim URL'si üzerinden internetten erişilebilir olduğunu ve faturanın oluşturulduğu modun jetonunun hâlâ girili olduğunu doğrulayın. Sipariş ayrıca müşteri ödemeden sonra mağazaya döndüğünde de kontrol edilir.

Notification answers verification failed: fatura o anda Iugu API'sinden okunamadı; örneğin ağ hatası veya yanlış jeton nedeniyle. Iugu bildirimi yeniden dener.

Notification answers invalid invoice id: bildirimde geçerli bir fatura kimliği yoktu. Hiçbir şey değişmez.

Sipariş On hold durumunda: sipariş notlarını okuyun. Bir boleto veya PIX hâlâ ödenmemiş, bir kart ödemesi tahsilat bekliyor, ödeme incelemede, kısmen ödenmiş veya itiraz edilmiş, ödenen tutar siparişle eşleşmemiş ya da ödeme sipariş iptal edildikten sonra gelmiş olabilir.

The customer sees "Iugu payments are not available right now": API jetonu eksik veya yanlış. Etkin modun jetonunu kontrol edin.

İade başarısız: mesajı okuyun. Boleto ödemeleri Iugu üzerinden iade edilemez, PIX ödemeleri yalnızca tam olarak iade edilebilir ve yalnızca ödenmiş faturalar iade edilebilir. Iugu iadeyi onaylamadıysa, tekrar denemeden önce faturayı Iugu'da kontrol edin.

Lisans bloğu 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, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler fatura isteğini değiştirebilir; örneğin payable_with ile ödeme yöntemlerini sınırlayabilir, wc_igu_invoice_data filtresiyle.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Tamamen kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete Data on Uninstall açıksa kaldırılır; aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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