Sambungkan WooCommerce kepada Bayarcash

Plugin Bayarcash WC menambah Bayarcash pada checkout WooCommerce anda. Setiap saluran bayaran Bayarcash menjadi satu kaedah bayaran WooCommerce yang berasingan, dengan page tetapan dan keys sendiri. Jadi anda hanya perlu sediakan saluran yang anda mahu.

Plugin ini menyokong sepenuhnya produk WooCommerce Subscriptions. Pelanggan anda boleh membayar setiap pembaharuan langganan melalui Direct Debit, terus dari akaun bank mereka. Lihat Direct Debit untuk langganan.

Saluran yang disokong

Plugin ini menambah satu kaedah bayaran WooCommerce bagi setiap saluran. Anda nampak nama ini dalam WooCommerce → Settings → Payments. Pelanggan anda nampak tajuk default semasa checkout, sehingga anda menukarnya:

Kaedah bayaran dalam WooCommerce	Tajuk default semasa checkout	Cara pelanggan anda membayar
Bayarcash FPX	Online Banking	Perbankan online FPX
Bayarcash DuitNow OBW	Online Banking	DuitNow Online Banking/Wallets
Bayarcash FPX Line of Credit	FPX Line of Credit	Akaun kad kredit melalui FPX
Bayarcash Credit & Debit Card	Credit & Debit Card	Visa atau Mastercard
Bayarcash DuitNow QR	DuitNow QR	Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR
Bayarcash Shopee Pay	SPayLater / Shopee Pay	ShopeePay atau SPayLater
Bayarcash BNPL by Boost	Boost PayFlex	Boost PayFlex
Bayarcash Boost PayFlex	Boost PayFlex	Boost PayFlex dan Boost Wallet
Bayarcash Touch ’n Go eWallet	Touch ’n Go eWallet	Touch ’n Go eWallet
Bayarcash GrabPay	GrabPay	GrabPay
Bayarcash Grab PayLater	Grab PayLater	PayLater by Grab
Bayarcash QRIS Online Banking	Indonesia Online Banking	Perbankan online Indonesia (QRIS)
Bayarcash QRIS e-Wallet	Indonesia e-Wallet	E-wallet Indonesia (QRIS)
Bayarcash NETS Singapore	NETS Singapore	NETS (Singapura)
Bayarcash Alipay	Alipay	Alipay
Bayarcash WeChat Pay	WeChat Pay	WeChat Pay
Bayarcash PromptPay Thailand	PromptPay	PromptPay (Thailand)
Bayarcash Direct Debit	Recurring Direct Debit	Potongan mingguan atau bulanan dari akaun bank

Bayarcash Direct Debit hanya dipaparkan apabila WooCommerce Subscriptions aktif. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat Saluran bayaran dan Saluran bayaran cross-border.

Sebelum anda mula

Anda memerlukan perkara ini sebelum anda sediakan plugin:

• Akaun merchant Bayarcash yang sudah diluluskan.
• Personal Access Token (PAT), API Secret Key dan Portal Key anda. Lihat Cari API keys anda.
• WooCommerce yang sudah di-install dan aktif. Mata wang kedai mesti ringgit Malaysia (MYR).
• Laman web yang online dan menggunakan HTTPS, supaya Bayarcash boleh menghantar keputusan bayaran kembali ke laman web itu.

Install plugin

Plugin ini percuma di WordPress.org dengan nama Bayarcash WooCommerce. Untuk install plugin ini:

1. Dalam WordPress, pergi ke Plugins → Add New.
2. Cari Bayarcash WC dan klik Install.
3. Klik Activate.

Sediakan saluran bayaran

Ulang langkah ini bagi setiap saluran yang anda mahu tawarkan. Page tetapan setiap saluran ada semua ruangan di bawah ini, dengan nilai sendiri.

1. Pergi ke WooCommerce → Settings → Payments dan buka saluran Bayarcash yang anda mahu, contohnya Bayarcash FPX.
2. Tandakan Enable/Disable.
3. Untuk bayaran sebenar, jangan tandakan Sandbox Mode. Lihat Uji dalam sandbox di bawah.
4. Pilihan: tukar Title dan Description. Pelanggan anda nampak teks ini semasa checkout.
5. Di bawah Credentials, paste token anda ke dalam Personal Access Token (PAT). Plugin menyemak token itu dan memaparkan “PAT Token is valid”. Anda juga boleh klik Verify Token.
6. Pilih portal anda dalam Portal Key. Senarai ini hanya diisi selepas token itu sah.
7. Paste key anda ke dalam API Secret Key.
8. Klik Save changes.

Tip

Sudah sediakan satu saluran? Pada saluran seterusnya, pilih saluran itu dalam Copy Credentials dan klik Copy. Plugin copy token, secret key, portal key dan tetapan Sandbox Mode sekali gus.

Tetapan pilihan

Setiap saluran juga ada tetapan ini, di bawah Miscellaneous dan Additional Charges:

Tetapan	Fungsi
Country Restrictions	Saluran ini hanya dipaparkan kepada pelanggan dari satu negara. Off memaparkannya kepada semua pelanggan.
Email Fallback	E-mel yang dihantar kepada Bayarcash apabila checkout anda tidak meminta e-mel pelanggan.
Debug Mode	Menulis butiran tambahan dalam logs WooCommerce (WooCommerce → System Status → Logs) untuk mencari punca masalah.
Place Order Text	Teks pada butang checkout. {total} memaparkan jumlah cart.
Logo Size Unit dan Logo Size	Saiz logo saluran semasa checkout.
Enable Additional Charges	Menambah caj pada pesanan apabila pelanggan membayar dengan saluran ini. Tetapkan caj itu dengan Fee Name, Charge Type dan Charge Amount.

Untuk menerima bayaran ke dalam lebih daripada satu akaun Bayarcash, guna tab Bayarcash Multi-Merchant dalam WooCommerce → Settings. Tab ini menambah kaedah bayaran FPX dan DuitNow tambahan, dan setiap satu ada keys sendiri.

Uji dalam sandbox

Uji dalam sandbox Bayarcash sebelum anda terima bayaran sebenar:

1. Dapatkan token, secret key dan portal key dari merchant dashboard sandbox. Keys live tidak berfungsi dalam sandbox.
2. Pada page tetapan saluran itu, tandakan Sandbox Mode, masukkan keys sandbox dan klik Save changes.
3. Buat satu pesanan ujian dan bayar pesanan itu.
4. Apabila semuanya berfungsi, buang tanda Sandbox Mode, masukkan keys live anda dan simpan semula.

Sandbox mode ditetapkan bagi setiap saluran. Jadi semak setiap saluran yang anda uji.

Cara keputusan bayaran sampai ke kedai anda

Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat return dan callback sendiri bersama setiap bayaran, iaitu /?wc-api=bayarcash_callback pada laman web anda. Apabila bayaran selesai, Bayarcash menghantar keputusan ke alamat itu dan plugin mengemas kini pesanan. Plugin juga menyemak semula pesanan yang belum dibayar mengikut jadual.

Jika pesanan kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall, plugin keselamatan atau maintenance mode yang menyekat alamat ?wc-api=. Lihat Callback dan checksum.

Direct Debit untuk langganan

Bayarcash Direct Debit berfungsi dengan WooCommerce Subscriptions. Pelanggan menandatangani e-mandate sekali sahaja. Selepas itu, Bayarcash memotong bayaran setiap pembaharuan dari akaun bank pelanggan.

Untuk menggunakan Direct Debit:

1. Install dan aktifkan WooCommerce Subscriptions.
2. Sediakan Bayarcash Direct Debit sama seperti saluran lain.
3. Cipta produk langganan dengan bil setiap minggu atau setiap bulan. Tempoh bil lain akan ditolak semasa checkout.

Semasa checkout, pelanggan mengisi Identification Type dan Identification Number, kemudian meluluskan e-mandate dengan bank mereka. Bank mengenakan amaun pengesahan yang kecil pada akaun pelanggan. Nota pesanan menunjukkan sama ada pengesahan bank berjaya. Satu cart hanya boleh ada satu langganan dan tiada item lain.

Untuk mengetahui bila potongan dibuat dan cara memantaunya, lihat Jadual potongan Direct Debit dan Transaksi Direct Debit.

Tips

Dua habit ini memudahkan setup WooCommerce anda:

• Sediakan hanya saluran yang portal anda boleh terima. Saluran yang tidak di-on-kan untuk portal anda memaparkan amaran dalam tetapannya dan gagal semasa checkout.
• Guna portal yang berasingan bagi setiap kedai. Laporan dan payout lebih mudah di-reconcile apabila setiap laman web ada portal sendiri.

Isu-isu biasa

Saya sudah simpan tetapan, tetapi kaedah bayaran itu off semula. Kenapa?

Plugin ini off-kan sesuatu saluran apabila Personal Access Token (PAT), Portal Key atau API Secret Key kosong, dan memaparkan "Please enter portal key", "Please enter Personal Access Token (PAT)" atau "Please enter API secret key". Setiap saluran menyimpan keys sendiri. Isi ketiga-tiganya pada page tetapan saluran itu, atau guna Copy Credentials.

Kenapa Verify Token memaparkan "Invalid PAT Token"?

Token itu salah, atau token itu dari environment yang lain. Jika Sandbox Mode ditandakan, guna token dari merchant dashboard sandbox. Jika tidak ditandakan, guna token dari merchant dashboard live. Lihat Cari API keys anda.

Sesuatu saluran memaparkan amaran bahawa saluran itu "is not enabled for this portal". Apa yang saya perlu buat?

Portal yang anda pilih belum boleh menerima saluran itu. Pilih portal lain, atau minta Bayarcash on-kan saluran itu untuk portal ini. Lihat Saluran bayaran.

Kenapa pelanggan nampak "This payment method only supports Malaysian Ringgit (MYR) currency." semasa checkout?

Bayarcash hanya menerima bayaran dalam MYR. Tetapkan mata wang kedai anda kepada ringgit Malaysia (MYR) dalam tetapan umum WooCommerce.

Kenapa saya tidak dapat batalkan pesanan Direct Debit?

Plugin ini menyekat pembatalan itu dan memaparkan "Direct Debit orders cannot be cancelled." Untuk menghentikan potongan seterusnya, batalkan langganan itu, atau tamatkan e-mandate. Lihat Tukar atau tamatkan mandate Direct Debit.

Artikel berkaitan

• Cari API keys & portal key anda
• Saluran bayaran yang boleh anda terima melalui Bayarcash
• Semak transaksi Direct Debit anda
• Kenapa bayaran saya gagal?