VibeFox Xendit 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: IDR, PHP, VND, THB, MYR, USD veya SGD. Diğer para birimlerinde ödeme yöntemi gösterilmez. Gerçekte hangi ödeme kanallarının ve para birimlerinin kullanılabilir olduğu Xendit hesabınıza bağlıdır.

Xendit hesabı: test modu için Money-in (faturalar) izni yazma yetkisi olan bir gizli API anahtarına, canlı mod için başka bir gizli API anahtarına ve her modun webhook doğrulama jetonuna ihtiyacınız var (bkz. Yapılandırma). Yalnızca gizli anahtarlar ve doğrulama jetonları kullanılır. Müşteri, Xendit tarafından barındırılan fatura sayfasında ödeme yaptığı için genel anahtar gerekmez.

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, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_xendit_payment_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

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

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

5. Xendit gizli anahtarlarınızı yapıştırın, Xendit Dashboard'da webhook URL'sini ayarlayın ve doğrulama jetonlarını yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. Test modunda deneme siparişi verin, ardından gerçek ödemeleri kabul etmek için Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Xendit. Alanların üstündeki bir banner etkin modu gösterir: TEST MODE (faturalar test gizli anahtarıyla oluşturulur ve gerçek para tahsil edilmez) veya LIVE MODE (faturalar canlı gizli anahtarla oluşturulur ve müşterilerden tahsilat yapılır). Banner, etkin modun gizli anahtarı eksik olduğunda ya da yanlış ön eke sahip olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve etkin modun webhook doğrulama jetonu boş olduğunda uyarır (Xendit bildirimleri reddedilir, bu yüzden siparişler yalnızca müşteri mağazanıza döndüğünde güncellenir). Ödeme yöntemleri listesinde, etkin modun geçerli bir gizli anahtarı olana kadar Xendit kurulum gerektiriyor olarak işaretlenir.

Genel

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: Xendit.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with virtual accounts, e-wallets, QR codes, retail outlets or cards via Xendit.

API anahtarları

Xendit Dashboard > Settings > Developers > API keys bölümünde Money-in (faturalar) için yazma izni olan bir gizli API anahtarı oluşturun; bir kez Test modunda, bir kez Live modunda. Faturanın nerede oluşturulacağını anahtar belirler. Kaydetme sırasında alanının ön ekiyle başlamayan bir anahtar kaydedilmez ve sayfa, örneğin Test secret key was not saved: it must start with xnd_development_ mesajını gösterir. Diğer ayarlar kaydedilir.

Test Mode: Enable test mode faturaları test gizli anahtarıyla oluşturur, bu nedenle gerçek para tahsil edilmez. Varsayılan: açık. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için işareti kaldırın.

Test Secret Key: Xendit Test modunun gizli anahtarı. xnd_development_ ile başlar.

Live Secret Key: Xendit Live modunun gizli anahtarı. xnd_production_ ile başlar.

Webhook'lar

Webhook, faturanın ödendiğini mağazanıza bildirir. Xendit Dashboard > Settings > Developers > Webhooks bölümünde, ayarların bu bölümünde gösterilen URL'yi Invoices > Invoice paid için; Test modunda ve Live modunda ayarlayın. İsteğe bağlı olarak Invoice expired için de ayarlayabilirsiniz. URL şu biçimdedir: https://your-site/wc-api/xendit_p_callback/. Ayarların gösterdiği gibi birebir kopyalayın.

Ardından Xendit Dashboard'dan her modun Webhook verification token değerini ilgili alana kopyalayın. Xendit bunu x-callback-token başlığında gönderir. Faturanın oluşturulduğu modun jetonu olmayan bildirimler reddedilir. Jeton yalnızca bildirimin Xendit'ten geldiğini kanıtlar: fatura durumu, tutarı ve para birimi her zaman o modun gizli anahtarıyla Xendit API'sinden yeniden okunur. Webhook olmadan bir sipariş, ancak müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Test Webhook Verification Token: Xendit Test modunun webhook doğrulama jetonu.

Live Webhook Verification Token: Xendit Live modunun webhook doğrulama jetonu.

Ödeme

Invoice Description: Xendit faturasında gösterilen açıklama. {order_id}, {order_number} ve {site_name} yer tutucularını kullanabilirsiniz. HTML kaldırılır ve metin 255 karakterde kesilir. Varsayılan: Order #{order_id}.

Order Status After Payment: Xendit ödemeyi onayladıktan sonra ayarlanan sipariş durumu. Durum, tek bir durum değişikliğiyle hemen ayarlanır.

Gelişmiş

Debug Log: Log API requests and webhooks istekleri, webhook'ları ve durum değişikliklerini WooCommerce > Status > Logs sayfasına, kaynak wcp_xendit_payment_gateway olarak yazar. Hatalar ve uyarılar bu kapalıyken bile her zaman kaydedilir. API anahtarları, jetonlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri (siparişlerdeki fatura kimlikleri) her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme yöntemi, mağaza para birimi IDR, PHP, VND, THB, MYR, USD veya SGD olduğunda gösterilir. Pay for order sayfasında sipariş para birimi geçerlidir. Müşteri ödeme yöntemini seçer (varsayılan olarak Xendit) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir Xendit faturası oluşturur ve müşteriyi Xendit fatura sayfasına yönlendirir. IDR ve VND tutarları tam sayıya yuvarlanır, çünkü Xendit bu para birimleri için ondalık kabul etmez. Müşterinin fatura e-posta adresi Xendit'e iletilir. Fatura sayfasında müşteri, bu para birimi için Xendit hesabınızda etkinleştirilmiş ödeme kanallarından biriyle öder; örneğin sanal hesap, e-cüzdan, QR kodu, perakende noktası veya kart.

Ödeme yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca Xendit onayladıktan sonra ödenmiş olarak işaretlenir: webhook ile ya da müşteri bu sayfaya ulaştığında Xendit API'sine sunucu tarafı bir istekle. O zamana kadar sipariş Ödeme bekleniyor durumunda kalır.

Fatura başarısız olursa veya süresi dolarsa Xendit müşteriyi geri gönderir. Ödeme sayfasında verilen bir sipariş bu durumda WooCommerce'in standart yöntemiyle iptal edilir ve faturası geçersiz kılınır. Pay for order sayfasından ödenen bir sipariş (örneğin müşteri için oluşturduğunuz bir sipariş) The Xendit payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner ve ödenebilir durumda kalır.

Müşteri ödenmemiş bir siparişi yeniden ödeyebilir. Sipariş toplamı, para birimi ve mod değişmemişse ve açık fatura hâlâ geçerliyse müşteri aynı faturaya yönlendirilir. Aksi halde eski fatura önce geçersiz kılınır ve yeni bir fatura oluşturulur; böylece bir sipariş için hiçbir zaman iki açık fatura olmaz. Eski fatura zaten ödenmişse, yeni bir ödeme yerine sipariş Tamamlandı olur.

Xendit ödemeyi başlatamazsa müşteri kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir; örneğin Xendit is temporarily unavailable. Please try again in a few minutes or choose another payment method. mesajı, hesabınız için para biriminin kabul edilmediğine veya sipariş toplamının Xendit tutar sınırlarının dışında olduğuna dair bir mesaj. Teknik neden günlüğe yazılır. Toplamı sıfır olan bir sipariş Xendit ile ödenemez.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. Test modunda Ödeme bloğu, ödeme yönteminin altında Test mode: no real money is charged. mesajını gösterir. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Ödeme her zaman Xendit sayfasında gerçekleşir. Eklentide WooCommerce'den iade, kayıtlı kart, abonelik veya yinelenen ödeme, ödeme sayfasında kart ya da e-cüzdan alanları, ayrı yetkilendirme ve tahsilat, xenPlatform alt hesapları, özel fatura süresi veya ödeme ücretleri yoktur.

Siparişler

Sipariş durumları

Pending payment: fatura oluşturuldu ve müşteri henüz ödeme yapmadı ya da Xendit henüz ödemeyi onaylamadı. Sipariş notu fatura kimliğini, tutarı, para birimini ve modu gösterir.

Processing or Completed: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notu fatura kimliğini, ödenen tutarı, ödeme kanalını ve modu gösterir. İşlem kimliği Xendit fatura kimliğidir.

On hold: ödenen fatura sipariş toplamı veya para birimiyle eşleşmedi ya da toplamın altında ödeme yapıldı (örneğin fatura oluşturulduktan sonra sipariş düzenlendi). Sipariş notu bunu açıklar; sipariş zaten beklemedeyse de. Ödemeyi Xendit Dashboard'da kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Failed: mevcut fatura ödeme yapılmadan süresi doldu. Müşteri siparişi yeniden ödeyebilir.

Cancelled: müşteri başarısız ya da süresi dolmuş bir faturadan döndü ya da sipariş sizin tarafınızdan ya da ödenmemiş siparişler için WooCommerce zaman aşımıyla iptal edildi. Açık fatura geçersiz kılınır, bu nedenle artık ödenemez. Xendit bunu kabul etmezse, bir not sizden faturayı Xendit Dashboard'da geçersiz kılmanızı ister.

Zaten ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş için bir fatura ödenirse sipariş değişmez. Bir not, ödemeyi Xendit Dashboard'da iade etmeniz ya da siparişi elle geri yüklemeniz için sizden ister.

İadeler

İadeler WooCommerce'den Xendit'e gönderilmez. Ödemeyi Xendit Dashboard'da iade edin (sipariş notu ve işlem kimliği fatura kimliğini içerir) ve iadeyi WooCommerce'de elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Xendit 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, 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 sitenin alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Xendit ö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. Giriş yapmış mağaza yöneticileri, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. Plugins 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.

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

Xendit ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, etkin modun doğru ön eke sahip bir gizli anahtarı bulunduğunu (test modunda xnd_development_ ile Test Secret Key, canlı modda xnd_production_ ile Live Secret Key) ve mağaza para biriminin IDR, PHP, VND, THB, MYR, USD veya SGD olduğunu kontrol edin. Anahtar eksik veya yanlışsa ayarlardaki banner uyarı gösterir.

Ödeme geçti ama sipariş Ödeme bekleniyor durumunda kalıyor: webhook çalışmıyor. Kullandığınız modun (test veya canlı) Xendit Dashboard'ında, ayarlarda gösterilen URL'nin Invoice paid için ayarlandığını ve o modun doğrulama jetonunun ilgili alana kaydedildiğini kontrol edin. Xendit Dashboard, her webhook için mağazanızın yanıtını gösterir. Müşteri sipariş alındı sayfasına döndüğünde de sipariş onaylanır.

Webhook yanıtı «Webhook verification token is not configured»: iki doğrulama jetonundan hiçbiri ayarlanmamış. Jetonu ayarlara yapıştırın.

Webhook yanıtı «Unauthorized»: Xendit'in gönderdiği jeton, ayarlardaki hiçbir jetonla eşleşmiyor. Doğru modun jetonunu yeniden kopyalayın.

Webhook yanıtı «Token does not match the mode of this invoice»: fatura diğer modda oluşturulmuş. Test bildirimi asla canlı bir siparişi onaylamaz, tersi de geçerlidir. Webhook'u ve jetonu siparişin ödendiği modda ayarlayın.

Webhook yanıtı «Ignored: not an invoice of this store»: fatura bu mağaza tarafından oluşturulmamış, örneğin aynı Xendit hesabındaki başka bir entegrasyon tarafından. Xendit Dashboard'daki Test düğmesi de bu yanıtı alır; bu da URL'nin ve jetonun çalıştığını doğrular.

Webhook yanıtı «Temporary error»: faturayı kontrol etmek için Xendit API'sine ulaşılamadı, faturanın modunun gizli anahtarı eksik ya da sipariş aynı anda başka bir istek tarafından güncelleniyordu. Xendit webhook'u yeniden dener. İki moddan siparişleriniz varsa her iki gizli anahtarın da ayarlı olduğunu kontrol edin.

Bir anahtar kaydedilmiyor: değer, alanının ön ekiyle başlamıyor. Test anahtarları xnd_development_, canlı anahtarlar xnd_production_ ile başlar.

Müşteri «This payment method is temporarily unavailable» mesajını görüyor: Xendit isteği reddetti; örneğin gizli anahtar yanlış olduğu ya da Money-in (faturalar) için yazma izni olmadığı için. Gerekirse Debug Log seçeneğini açın ve WooCommerce > Status > Logs sayfasına, kaynak wcp_xendit_payment_gateway olarak bakın. Fatura bilgileriyle ilgili bir mesaj, Xendit'in istek verisini kabul etmediği anlamına gelir; örneğin e-posta adresi.

Müşteri «A payment for this order was already received by Xendit and is being reviewed» mesajını görüyor: bu siparişin daha önceki bir faturası ödenmiş, ancak siparişle eşleşmediği için sipariş beklemede. Ödemeyi Xendit Dashboard'da kontrol edin.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı. Siparişi yerine getirin veya ödemeyi Xendit Dashboard'da iade edin.

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, anahtarı yeni alan adında etkinleştirmek için 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. 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 diğer seçenekleri, geçici veriler ve günlükleri (döndürülmüş dosyalar dahil günlük dosyaları, veritabanı günlük kayıtları ve sürüm 1.0'ın günlük klasörü) yalnızca Delete Data on Uninstall açıkken kaldırılır. Aksi halde sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını, fatura kimliklerini ve işlem kimliklerini korur.

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