VibeFox iPay88 for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

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

PHP: 8.0 veya üzeri.

iPay88 satıcı hesabı: Merchant Code ve Merchant Key, satıcı hesabınız etkinleştirildiğinde iPay88 tarafından verilir. Ayrıca iPay88 satıcı portalinde de görüntülenir. Henüz satıcı değilseniz iPay88 web sitesinden başvurun. Merchant Key'i gizli tutun: ödemeleri imzalar.

Request URL: web sitenizin adresi iPay88'e Request URL olarak kayıtlı olmalıdır. Aksi halde iPay88 sayfasında "Permission not allow" görüntülenir.

Mağaza para birimi: Malaysia — MYR ve iPay88 hesabınızda çoklu para birimi seçeneği etkinse USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP veya THB; Philippines — PHP veya USD; Indonesia — IDR; Thailand — THB.

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 ve Install Now düğmesine tıklayın. Ayrıca wcp_ipay88_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > iPay88 > Manage veya 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. iPay88 region seçeneğinizi belirleyin ve Merchant Code ile Merchant Key bilgilerini girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. Kurulumu kontrol etmek için Test mode açıkken bir ödeme yapın, ardından test modunu kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > iPay88. Alanların üstünde sayfa; Merchant Code veya Merchant Key eksik olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez), mağaza para birimi seçilen bölgede tahsil edilemediğinde ve test modu açık olduğu sürece sizi uyarır. Ödeme yöntemleri listesinde iPay88, her iki anahtar girilene kadar kurulum gerektirdiği şeklinde işaretlenir ve test modu açık olduğu sürece bir test modu rozeti gösterir.

Genel

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

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

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via iPay88 (credit card, online banking, e-wallet).

iPay88 hesabı

iPay88 region: iPay88 satıcı hesabınızın ülkesi. iPay88 ödeme sayfasını ve tahsil edilebilecek para birimlerini belirler. Sipariş her zaman kendi para biriminde tahsil edilir. Varsayılan: Malaysia.

Malaysia (payment.ipay88.com.my): MYR ve hesabınızda çoklu para birimi etkinse Gereksinimler bölümünde listelenen diğer para birimleri.

Philippines (payment.ipay88.com.ph): PHP, USD.

Indonesia (payment.ipay88.co.id): IDR, ondalıksız gönderilir.

Thailand (payment.ipay88.co.th): THB.

Merchant Code: iPay88 Merchant Code'unuz, örneğin M01234.

Merchant Key: iPay88 Merchant Key'iniz. Ödeme isteklerini imzalar ve iPay88 yanıtlarını doğrular. Gizli tutun.

Signature type: ödeme isteklerinin nasıl imzalanacağı. Yanıtlar her iki biçimde de doğrulanır.

SHA256 (recommended): iPay88'in güncel spesifikasyonu (varsayılan).

SHA1 (legacy): yalnızca iPay88 eski imzayı kullanmanızı istediyse seçin.

Ödeme

Payment method: Malezya PaymentId listesinden bir iPay88 ödeme yöntemini önceden seçin veya Let the customer choose on the iPay88 page seçeneğini bırakın (varsayılan). Liste; Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay ve ShopeePay yöntemlerini içerir.

Reference prefix: isteğe bağlı. iPay88 referansındaki (RefNo) sipariş numarasının önüne eklenir, örneğin SHOP1-. Aynı iPay88 hesabını kullanan her mağazada farklı bir önek kullanın; böylece bir mağazanın yanıtı asla başka bir mağazanın siparişine uygulanamaz. Harfler, rakamlar, "-" ve "_" kullanılabilir, en fazla 10 karakter. Rakamla biten önek kaydedilirken düzeltilir, çünkü sipariş numarası referansın sonundan okunur.

Test mode: Charge a fixed test amount instead of the order total. iPay88'in ayrı bir sandbox ortamı yoktur: test ödemeleri, canlı iPay88 ödeme sayfasında küçük bir tutarla yapılan gerçek işlemlerdir (1,00; IDR 10.000). Test tutarı alındığında sipariş ödenmiş olarak işaretlenir ve sipariş notunda bu belirtilir. Test modu açıkken ödeme sayfasında TEST MODE: only a test amount of ... will be charged. ifadesi gösterilir. Canlı bir mağazada test modunu asla açık bırakmayın. Varsayılan: kapalı.

Yanıt ve backend URL'leri

Eklenti her ödemede iki URL'yi de gönderir, bu nedenle yapılandırılacak bir şey yoktur. iPay88 bunları isterse ayarların bu bölümünden kopyalayın. Şu biçimdedirler: https://your-site/wc-api/ipay88_p_response/ (Response URL, müşterinin dönüşü) ve https://your-site/wc-api/ipay88_p_backend/ (Backend URL, sunucudan sunucuya bildirim). Bölümde ayrıca iPay88'e Request URL olarak kayıtlı olması gereken web sitesi adresiniz de görünür.

iPay88'in her iki yanıtı da aynı şekilde kontrol edilir: Merchant Key'inizle oluşturulan imza, bu mağazanın bu sipariş için başlattığı bir ödemenin referansı, tutar ve para birimi. Geçerli imzası olmayan istekler reddedilir ve bir siparişi asla değiştirmez. Backend bildirimi yalnızca işlendikten sonra RECEIVEOK yanıtını alır; aksi halde iPay88 bildirimi yeniden gönderir. iPay88 şu ödeme durumlarını bildirir:

1 (başarılı): ödeme yapıldı. Tutar ve para birimi kontrol edildikten sonra sipariş ödenmiş olarak işaretlenir.

6 (beklemede): ödeme hâlâ bekliyor, örneğin ATM veya sanal hesap havalesi. iPay88 ödemeyi onaylayana veya başarısız sayana kadar sipariş beklemeye alınır.

Diğer tüm durumlar: ödeme başarısız oldu veya iptal edildi. Sipariş, iPay88'in nedeniyle birlikte Başarısız durumuna geçer.

Gelişmiş

Debug log: WooCommerce > Status > Logs sayfasında, kaynak wcp_ipay88_payment olacak şekilde Log payment requests and iPay88 responses; kişisel veri veya imza içermez. Hatalar her zaman kaydedilir. Varsayılan: kapalı.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Siparişlerin kendisi asla silinmez. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak iPay88) ve siparişi verir. Sipariş Pending payment durumunda kalır ve bölgenizin iPay88 ödeme sayfasına bir form gönderilirken müşteri Redirecting to iPay88 payment gateway... mesajını görür. JavaScript olmadan müşteri Pay Now düğmesine tıklar. Sipariş kalemleri, müşterinin adı, e-posta adresi ve telefonu iPay88'e iletilir. iPay88 sayfasında müşteri kartla, FPX çevrimiçi bankacılıkla, e-cüzdanla veya hesabınızın sunduğu başka bir yöntemle öder.

Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, iPay88 imzalı bir yanıtla ödemeyi onayladığında ödenmiş olarak işaretlenir; bu onay müşterinin dönüşünde ya da backend bildirimiyle gelir. Onay henüz ulaşmadıysa sayfa We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. mesajını gösterir. Bekleyen bir ödeme için Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. mesajını gösterir.

Ödeme başarısız olduysa veya iptal edildiyse müşteri The payment was not completed: mesajı ve iPay88'in nedeniyle birlikte Pay for order sayfasına gelir; yeniden ödeme yapabilir veya başka bir ödeme yöntemi seçebilir. Yanıt doğrulanamazsa müşteri The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. mesajını ve mağazaya dönüş bağlantısını görür.

Stok, müşteri yönlendirildiğinde değil, ödeme onaylandığında düşülür. Ö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 seferlik ödemeleri destekler. WooCommerce üzerinden iade, kayıtlı kart, abonelik, ön provizyon ve tahsilat ya da sitenizde kart alanları yoktur. Ödeme durumu için iPay88'e yeniden sorgu göndermez: siparişler yalnızca iPay88 yanıtı ve backend bildirimiyle güncellenir. iPay88 Indonesia API 2.0 (JSON / ödeme bağlantısı) kullanılmaz.

Siparişler

Order statuses

Pending payment: müşteri iPay88'e yönlendirildi ve henüz ödeme yapmadı ya da iPay88 ödemeyi henüz onaylamadı.

Processing or Completed: ödeme onaylandı. WooCommerce, ödenmiş bir sipariş için olağan durumu ayarlar. Sipariş notunda iPay88 TransID, PaymentID, tutar ve para birimi görünür. İşlem kimliği iPay88 TransID'dir. Test modunda ikinci bir not, sipariş tutarı yerine test tutarının tahsil edildiğini belirtir.

On hold, pending at iPay88: iPay88 ödemeyi beklemede olarak bildirdi. iPay88 ödemeyi onaylayana veya başarısız sayana kadar sipariş güncellenmez.

On hold, for review: iPay88, siparişten farklı bir tutar veya para birimiyle başarılı bir ödeme bildirdi ya da ödeme siparişin iptal edilmesinden sonra geldi. Sipariş ödenmiş olarak işaretlenmedi. Sipariş notu bunu açıklar. Ödemeyi iPay88 portalında kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Failed: ödeme başarısız oldu veya iptal edildi. Notta iPay88'in nedeni görünür. Müşteri yeniden ödeme yapabilir.

Zaten ödenmiş veya iade edilmiş bir sipariş için başka bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, iPay88 portalında kontrol etmeniz ve mükerrer ise iade etmeniz için sizi uyarır. Başarısız bir yanıt, ödenmiş, iade edilmiş veya iptal edilmiş bir siparişi asla değiştirmez.

İadeler

İadeler WooCommerce'ten iPay88'e gönderilmez. Ödemeyi iPay88 satıcı portalinde iade edin ve iadeyi WooCommerce'te elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > iPay88 sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görüntülenir; örneğin lisansın geçerli olduğu tarih 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 yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa iPay88 ö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.

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

iPay88 ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, Merchant Code ve Merchant Key alanlarının girildiğini ve mağaza para biriminin seçilen iPay88 region bölgesinde tahsil edilebildiğini kontrol edin. Eksik bir şey olduğunda ayarlar sayfası uyarı gösterir.

Ödeme başarılı oldu ama sipariş Pending payment durumunda kaldı: ne müşterinin dönüşü ne de backend bildirimi, geçerli bir imzayla mağazanıza ulaştı. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasına, kaynak wcp_ipay88_payment olacak şekilde bakın. Merchant Key değerinin iPay88'in verdiği değerle birebir aynı olduğunu ve sitenizin ayarlarda gösterilen Backend URL'ye iPay88'ten gelen istekleri alabildiğini kontrol edin.

iPay88 sayfasında "Permission not allow" görünüyor: web sitenizin adresi iPay88'e Request URL olarak kayıtlı değil. iPay88'ten Response and backend URLs bölümünde gösterilen adresi kaydetmesini isteyin.

Backend bildirimi BAD SIGNATURE yanıtı veriyor: imza Merchant Key ile eşleşmiyor. Merchant Key değerini kontrol edin.

Backend bildirimi NOT CONFIGURED yanıtı veriyor: Merchant Code veya Merchant Key ayarlanmamış, bu nedenle yanıt doğrulanamıyor. iPay88 bildirimi yeniden gönderir.

Backend bildirimi UNKNOWN ORDER yanıtı veriyor: bu referans için bu mağazada bir iPay88 ödemesi başlatılmadı. Örneğin aynı hesabı kullanan başka bir mağaza Reference prefix kullanmıyor ya da aynı öneki kullanıyor olabilir.

Sipariş, tutar veya para birimiyle ilgili bir notla On hold durumunda: iPay88, siparişle eşleşmeyen bir ödeme bildirdi ya da sipariş iptal edilmişti. Sipariş ödenmiş olarak işaretlenmedi. iPay88 portalında ödemeyi kontrol edin ve tamamlayın veya iade edin.

Müşteri bir para birimi için "iPay88 cannot accept payments in" mesajını görüyor: sipariş para birimi seçilen bölgede tahsil edilemez. iPay88 Malaysia'da MYR dışındaki para birimleri için iPay88 hesabınızda çoklu para birimi seçeneğinin de açık olması gerekir.

Gerçek müşteriler yalnızca 1,00 tahsil ediliyor: Test mode açık. Kapatın.

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 hak 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.

Geliştiriciler; ödeme sayfası URL'sini, para birimlerini, ondalık basamakları, test tutarını ve simgeyi ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount ve ipay88_p_icon filtreleriyle değiştirebilir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi 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ı, günlükler ve siparişlerde saklanan iPay88 verileri yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Siparişlerin kendisi asla silinmez ve ödeme notlarını ile işlem kimliklerini korur.

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