VibeFox Xendit for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Mağaza para birimi: IDR, PHP, VND, THB, MYR, USD veya SGD. Diğer ödeme 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) yazma izni olan bir gizli API anahtarına, canlı mod için ise başka bir gizli API anahtarına ve her modun webhook doğrulama jetonuna ihtiyacınız vardır (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 herkese açık anahtar gerekmez.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_xendit_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_xendit_payment_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_xendit_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Xendit Payment Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. Sayfanın üst kısmındaki lisans bloğunda, License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. 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).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modundayken bir test siparişi verin, ardından gerçek ödemeleri almak için Test Mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_xendit_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Xendit Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, Xendit anahtarlarını ve webhook'u OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook'lar).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Xendit Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Ayarların üzerinde bir kutu etkin modu gösterir: TEST MODE (faturalar Test gizli anahtarıyla oluşturulur; gerçek para tahsil edilmez) veya LIVE MODE (faturalar Live gizli anahtarıyla oluşturulur ve müşteriler ücretlendirilir). Etkin modun gizli anahtarı eksikse veya yanlış öneke sahipse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ya da etkin modun webhook doğrulama jetonu boşsa (Xendit bildirimleri reddedilir ve siparişler yalnızca müşteri mağazanıza döndüğünde güncellenir) sayfa sizi uyarır.

Kaydederken Title boş olamaz (en fazla 128 karakter), Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir.

Xendit

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Xendit. Zorunlu, en fazla 128 karakter.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay with virtual accounts, e-wallets, QR codes, retail outlets or cards via Xendit.

Sort Order: Xendit'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın ya da tam sayı girin.

Geo Zone: Xendit'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Xendit sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Her toplam için Xendit sunmak üzere boş bırakın.

API anahtarları

Xendit Dashboard > Settings > Developers > API keys bölümünde (bölümde bu sayfaya bağlantı vardır) Money-in (faturalar) için yazma izni olan bir gizli API anahtarı oluşturun; bir kez Test modunda, bir kez de Live modunda. Anahtar faturanın nerede oluşturulacağını belirler. Kaydederken alanının önekiyle başlamayan bir anahtar kaydedilmez ve sayfa örneğin Test secret key was not saved: it must start with xnd_development_ uyarısını gösterir. Diğer ayarlar kaydedilir.

Test Mode: faturaları Test gizli anahtarıyla oluşturur, bu nedenle gerçek para tahsil edilmez. Varsayılan: on. Gerçek ödemeleri Live gizli anahtarıyla almak için kapatın. Açıkken müşteriler Confirm Order adımında Test mode: no real money is charged. ifadesini görür.

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.

Kaydedilmiş anahtarlar ve jetonlar 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. Kayıtlı bir değeri kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook'lar

Webhook, mağazanıza bir faturanın ödendiğini bildirir. Xendit Dashboard > Settings > Developers > Webhooks bölümünde (bölümde bu sayfaya bağlantı vardır) Webhook URL alanında gösterilen URL'yi, hem Test hem de Live modunda Invoices > Invoice paid için ayarlayın. İsterseniz Invoice expired için de ayarlayabilirsiniz. URL, OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_xendit_payment_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_xendit_payment_gateway/payment/wcp_xendit_payment_gateway.webhook. OpenCart kurulumunuzun vitrin adresinden oluşturulur. Ayarların gösterdiği gibi tam olarak kopyalayın. İnternetten erişilebilir olmalıdır.

Ardından her modun Webhook verification token değerini Xendit Dashboard'dan 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: faturanın 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} ve {order_number} yer tutucularını (ikisi de OpenCart sipariş numarasıdır) ve {site_name} (mağaza adı) yer tutucusunu kullanabilirsiniz. HTML kaldırılır ve metin 255 karakterde kesilir. Varsayılan: Order #{order_id}.

Order Status After Payment: onaylanmış bir ödemenin, tek bir durum değişikliğiyle hangi durumu ayarlayacağı.

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, ancak Xendit ödemeyi API üzerinden onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Paid Order Status: Processing ile onaylanmış bir ödemeden sonraki durum. Varsayılan: Processing.

Complete Order Status: Completed ile onaylanmış bir ödemeden sonraki durum. Varsayılan: Complete.

On Hold (Review) Status: bir fatura, siparişten farklı bir tutar veya para birimiyle ödendi (fatura oluşturulduktan sonra sepet değiştirildi ya da kısmi ödeme yapıldı). Bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Gelişmiş

Debug Log: API isteklerini ve webhook'ları OpenCart günlükleri klasöründeki (storage/logs) xendit_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında xendit_p_debug.old.log.php olarak taşınır. Hatalar ve uyarılar bu kapalıyken bile her zaman kaydedilir. API anahtarları, jetonlar ve müşteri verileri kaydedilmez. Varsayılan: off.

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

Delete Data on Uninstall: açıksa eklentiyi kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Sipariş verileri (siparişlerin Xendit fatura kimlikleri) her zaman saklanır. Varsayılan: off.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar ve jetonlar dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı gizli anahtarlar ve jetonlar korunur.

Ödeme sayfası

Ödeme yöntemi, ödeme para birimi IDR, PHP, VND, THB, MYR, USD veya SGD olduğunda gösterilir. Müşteri bunu Payment Method adımında seçer (varsayılan olarak Xendit). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için sipariş para biriminde bir Xendit faturası oluşturur ve müşteriyi Xendit fatura sayfasına gönderir. IDR ve VND tutarları tam sayıya yuvarlanır, çünkü Xendit bu para birimleri için ondalık kabul etmez. Müşterinin e-posta adresi Xendit'e iletilir. Fatura sayfasında müşteri, Xendit hesabınızda bu para birimi için etkinleştirilmiş ödeme kanallarından biriyle öder: örneğin bir sanal hesap, bir e-cüzdan, bir QR kodu, bir perakende noktası veya bir kart. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve sayfanın altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Xendit onayladıktan sonra ödenmiş olarak işaretlenir: webhook aracılığıyla ya da müşteri döndüğünde Xendit API'sine sunucu tarafı bir istekle. Sipariş ardından OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını görür. Xendit ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası Your payment has not been confirmed by Xendit yet. Your order will be confirmed as soon as Xendit confirms it — please do not pay again. ifadesini, Check again ve Back to checkout düğmeleriyle birlikte gösterir. Webhook, gelir gelmez sipariş durumunu ayarlar.

Fatura başarısız olursa veya süresi dolarsa Xendit müşteriyi geri gönderir. Eklenti önce faturayı kontrol eder (başka bir sekmede ödenmiş olabilir), ardından artık ödenemeyecek şekilde süresini dolduruna çevirir. Müşteri The Xendit payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise tek bir siparişi ödeme sayfasında günceller, bu nedenle başarısız veya süresi dolmuş bir faturadan sonra bir sonraki Confirm Order aynı sipariş için yeni bir fatura oluşturur. Aynı sepetin başka bir siparişi zaten ödenmişse, müşteri doğrudan başarı sayfasına gider ve iki kez ücretlendirilmez. Sipariş toplamı, para birimi ve mod değişmemişse ve bu siparişin açık faturası en az beş dakika daha geçerliyse, müşteri aynı faturaya yönlendirilir. Aksi takdirde eski fatura önce süresi dolacak şekilde sonlandırılır ve yeni bir fatura oluşturulur; bu sayede bir sepet için hiçbir zaman iki açık fatura bulunmaz. Eski fatura zaten ödenmişse, yeni bir ödeme yerine o ödeme onaylanır.

OpenCart 4'te, sipariş ödeme sayfasında mağaza tarafından kapatılmışsa (örneğin iptal edilmiş veya iade edilmişse) ya da zaten ödenmiş ama sepet o zamandan beri değiştiyse (yeni adet dahil), müşteri Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder. OpenCart 4'te bu mesaj, tamamlanmamış ödemeye ilişkin mesaj ve We could not match this payment to an order. If you were charged, please contact us. ödeme sayfasının üstünde gösterilir.

Xendit ödemeyi başlatamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımında kalır; örneğin Xendit is temporarily unavailable. Please try again in a few minutes or choose another payment method., para biriminin hesabınız için kabul edilmediğini ya da sipariş toplamının Xendit tutar sınırlarının dışında olduğunu bildiren bir mesaj. Teknik neden günlüğe yazılır. Toplamı sıfır olan bir sipariş Xendit ile ödenemez.

Webhook ve müşterinin dönüşü de mağaza bakım modundayken çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti bunlar için bir başlangıç eylemi ekler.

Ödeme her zaman Xendit sayfasında yapılır. Eklentinin yönetim panelinden iade, kayıtlı kart, abonelik veya tekrarlayan ödeme, ödeme sayfasında kart veya e-cüzdan alanı, ayrı yetkilendirme ve tahsilat ya da xenPlatform alt hesapları yoktur.

Siparişler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Xendit'e gönderildi ve ödeme yapmadı ya da Xendit ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Paid Order Status veya Complete Order Status (varsayılan Processing veya Complete): ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Bir not, fatura kimliğini, ödenen tutarı, ödeme kanalını ve modu gösterir.

On Hold (Review) Status (varsayılan Pending): ödenmiş fatura sipariş toplamıyla ya da para birimiyle eşleşmedi ya da toplamın altında ödeme yapıldı (örneğin fatura oluşturulduktan sonra sepet değiştirildi). Not bunu açıklar. Ödemeyi Xendit Dashboard'da kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin. Aynı siparişin başka bir faturası sonradan doğru tutarla ödenirse sipariş ödenmiş duruma geçer.

Ödenen bir fatura, iptal edilmiş veya iade edilmiş gibi başka bir durumdaki bir sipariş için ödenirse sipariş durumu değişmez. Bir not, ödemeyi Xendit Dashboard'da iade etmenizi ya da siparişi elle geri yüklemenizi ister. Zaten ödenmiş bir sipariş için ya da zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir fatura ödenirse sipariş değişmez ve ödenmiş siparişteki bir not, yinelenen ödemeyi Xendit Dashboard'da iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır. Xendit kelimesiyle başlarlar.

VibeFox Xendit Payment Gateway sekmesi

Sales > Orders bölümünde Xendit ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında VibeFox Xendit Payment Gateway sekmesi Xendit invoice bilgisini, Mode (test ödemeleri için Test etiketiyle) bilgisini, ödemenin Status bilgisini, Invoices of this order and its cart tablosunu (tarih, sipariş, fatura kimliği, harici kimlik, mod, tutar, ödenen tutar, durum, ödeme kanalı) ve siparişin Payment notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

İadeler mağazadan Xendit'e gönderilmez. Ödemeyi Xendit Dashboard'da iade edin (sekmede gösterilen fatura kimliğini arayın), ardından OpenCart'ta sipariş durumunu değiştirin. Sales > Returns bölümündeki ürün iadeleri Xendit üzerinden para geri göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Xendit Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Xendit Payment Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girip Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-payment-xendit satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızda boşaltın.

Etkin bir anahtar olmadan Xendit ödeme sayfasında müşterilere gösterilmez. Bir ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

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 önekli bir gizli anahtarı olduğunu (test modunda xnd_development_ ile Test Secret Key, canlı modda xnd_production_ ile Live Secret Key) ve ödeme sayfası para biriminin IDR, PHP, VND, THB, MYR, USD veya SGD olduğunu kontrol edin. Anahtar eksik ya da yanlışsa ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin.

Ödeme yapıldı ama sipariş durumsuz kalıyor: webhook çalışmıyor. Kullandığınız modun (test ya da canlı) Xendit Dashboard'unda, Webhook URL altında gösterilen URL'nin Invoice paid için ayarlandığını ve o modun doğrulama jetonunun ilgili alanda kayıtlı olduğunu kontrol edin. Xendit Dashboard, her webhook için mağazanızın yanıtını gösterir. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de bir durum alır.

Webhook answers Webhook verification token is not configured: hiçbir doğrulama jetonu ayarlanmamış. Jetonu ayarlara yapıştırın.

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

Webhook answers Token does not match the mode of this invoice: fatura diğer modda oluşturuldu. Test bildirimi hiçbir zaman gerçek bir ödemeyi onaylamaz, tersi de geçerlidir. Webhook'u ve jetonu siparişin ödendiği modda ayarlayın.

Webhook answers Ignored: not an invoice of this store: fatura bu mağaza tarafından oluşturulmadı; örneğin aynı Xendit hesabındaki başka bir entegrasyon tarafından oluşturuldu. Xendit Dashboard'daki Test düğmesi de bu yanıtı alır ve URL ile jetonun çalıştığını doğrular. Ignored: unknown order ve Ignored: unknown invoice, siparişin ya da faturanın bu mağaza tarafından bilinmediği anlamına gelir.

Webhook answers Temporary error: faturayı kontrol etmek için Xendit API'sine ulaşılamadı, faturanın modunun gizli anahtarı eksik ya da sepet aynı anda başka bir istek tarafından güncelleniyordu. Xendit webhook'u yeniden dener. Ödemeler her iki modda başlatıldıysa her iki gizli anahtarın da ayarlandığını kontrol edin ve nedeni görmek için Debug Log seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Xendit'ten gelen istekleri kabul eder.

Bir anahtar kaydedilmiyor: değer, alanının önekiyle 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. Eklenti sayfasındaki Log alanına bakın. Fatura bilgileriyle ilgili bir mesaj, Xendit'in istek verilerini 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 sepetin daha önceki bir faturası ödendi, ancak sipariş henüz onaylanamadı. Xendit Dashboard'da ve günlükte ödemeyi kontrol edin.

Müşteri We could not match this payment to an order mesajını görüyor: Xendit'ten gelen dönüş bağlantısı bu mağazanın bir siparişine ait değil ya da fatura ona eşleştirilemedi. Xendit Dashboard'da ve günlükte ödemeyi kontrol edin.

Sipariş ödeme sonrası inceleme durumunda: VibeFox Xendit Payment Gateway sekmesindeki notları okuyun. Ödenen tutar ya da para birimi siparişten farklıydı. Siparişi yerine getirin veya ödemeyi Xendit Dashboard'da iade edin.

Geliştiriciler için: eklenti, fatura isteğini, para birimi listesini ve para birimi başına ondalık basamak sayısını değiştirebilmek için OpenCart olaylarını xendit_p_invoice_request, xendit_p_supported_currencies ve xendit_p_currency_decimals tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Xendit Payment Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Payment bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. OpenCart 4'te eklentinin olayı ve bakım modunda webhook ile müşterinin dönüşünü geçiren başlangıç eylemi de kaldırılır. Delete Data on Uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, jetonlar, fatura açıklaması, ödeme sonrası sipariş durumu, günlük kaydı) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Xendit fatura verileri her zaman saklanır. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Xendit Payment Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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