Sambungkan GiveWP kepada Bayarcash

Dikemas kini 30 September 2026

Plugin Bayarcash GiveWP menambah Bayarcash pada form derma GiveWP anda. Penderma boleh menderma sekali melalui FPX, DuitNow dan saluran lain. Penderma juga boleh menderma setiap minggu atau setiap bulan melalui Direct Debit.

Derma berulang memerlukan add-on Recurring Donations for GiveWP. Selepas itu, Bayarcash memotong setiap derma dari akaun bank penderma secara automatik, dengan caj tetap. Lihat Derma berulang melalui Direct Debit.

Untuk melihat plugin ini berfungsi sebelum anda install, cuba demo langsung.

Saluran yang disokong

Setiap saluran Bayarcash menjadi satu payment gateway GiveWP yang berasingan. Anda boleh on-kan seberapa banyak yang anda mahu:

Gateway dalam GiveWP	Cara penderma membayar
Online Banking	Perbankan online FPX. Gateway ini juga menjalankan derma berulang melalui Direct Debit.
Online Banking (DuitNow)	DuitNow Online Banking/Wallets
Credit Card	FPX Line of Credit: akaun kad kredit melalui FPX, bukan bayaran kad. Lihat FPX Line of Credit
DuitNow QR	Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR
Boost PayFlex	Boost PayFlex
Indonesia Online Banking	Perbankan online Indonesia (QRIS)
Indonesia e-Wallet	E-wallet Indonesia (QRIS)
NETS	NETS (Singapura)
Alipay	Alipay
WeChat Pay	WeChat Pay
PromptPay	PromptPay (Thailand)

Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat Saluran bayaran.

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.
GiveWP yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR).
Untuk derma berulang, add-on GiveWP Recurring Donations.

Install plugin

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

Dalam WordPress, pergi ke Plugins → Add New.
Cari Bayarcash GiveWP dan klik Install.
Klik Activate.

Masukkan keys anda

Page tetapan Bayarcash ada satu tab bagi setiap saluran, dan setiap tab menyimpan keys sendiri. Isi tab bagi setiap saluran yang anda mahu guna:

Pergi ke Donations → Settings → Payment Gateways, kemudian buka bahagian Bayarcash.
Klik tab saluran itu, contohnya Online Banking.
Paste token anda ke dalam Personal Access Token (PAT) dan klik Verify Token. Plugin memaparkan “PAT Token is valid” apabila token itu berfungsi.
Pilih portal anda dalam Portal Key. Senarai ini hanya diisi selepas token itu sah.
Paste key anda ke dalam API Secret Key.
Pilihan: tetapkan Billing Fields kepada Enabled untuk meminta butiran bil penderma. Tetapkan Enable Phone field kepada Enabled untuk meminta nombor telefon bagi derma sekali sahaja.
Klik Save changes.

On-kan gateway

Keys sahaja tidak memaparkan Bayarcash pada form anda. Anda juga perlu on-kan setiap gateway dalam GiveWP:

Dalam Donations → Settings → Payment Gateways, buka senarai gateway GiveWP.
Tandakan setiap gateway Bayarcash yang anda sediakan, contohnya Online Banking dan DuitNow QR.
Pilihan: tukar label yang penderma nampak, contohnya kepada “Online Banking (FPX)”.
Simpan.

Guna keys lain pada satu form

Setiap form derma boleh menggunakan akaun atau portal Bayarcash sendiri. Ini berguna jika anda mahu melihat kutipan setiap kempen secara berasingan dalam laporan. Dalam editor form, buka tab saluran Bayarcash dan pilih satu pilihan:

Pilihan	Bila perlu guna
Global Option	Guna keys dari page tetapan Bayarcash.
Customize	Masukkan Personal Access Token (PAT), Portal Key dan API Secret Key yang lain untuk form ini sahaja.
Disable	Sembunyikan saluran ini pada form ini.

Uji dalam sandbox

Plugin ini mengikut test mode GiveWP. Apabila test mode di-on-kan, setiap bayaran Bayarcash pergi ke sandbox Bayarcash, dengan keys yang anda masukkan:

Dapatkan token, secret key dan portal key dari merchant dashboard sandbox. Keys live tidak berfungsi dalam sandbox.
On-kan test mode GiveWP.
Masukkan keys sandbox pada page tetapan Bayarcash dan simpan.
Buat satu derma ujian.
Apabila semuanya berfungsi, off-kan test mode, masukkan keys live anda dan simpan semula.

Cara keputusan bayaran sampai ke laman web anda

Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap derma, iaitu /give-api/bayarcash_gateway/ pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Plugin juga menyemak semula derma yang pending setiap 5 minit.

Jika derma kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat Callback dan checksum.

Derma berulang melalui Direct Debit

Dengan add-on GiveWP Recurring Donations, penderma boleh menderma setiap minggu atau setiap bulan melalui Direct Debit. Penderma menandatangani e-mandate sekali sahaja, dan Bayarcash memotong setiap derma dari akaun bank penderma.

Untuk menerima derma berulang:

Install dan aktifkan GiveWP Recurring Donations.
Sediakan gateway Online Banking seperti di atas.
Jadikan form itu form derma berulang, dengan tempoh mingguan atau bulanan.

Pada form derma berulang, penderma mengisi Phone Number, Identification Type dan Identification Number, kemudian meluluskan e-mandate dengan bank mereka. Bank mengenakan amaun pengesahan yang kecil pada akaun penderma, dan amaun ini tidak dipulangkan. Resit derma menyatakan perkara ini. Lihat Jadual potongan Direct Debit dan e-Mandate.

Tips

Dua habit ini membantu anda mengurus derma:

Guna portal yang berasingan bagi setiap kempen. Portal bagi setiap form memisahkan derma setiap kempen dalam laporan Bayarcash anda.
Pastikan e-mel penderma pendek pada form derma berulang. Direct Debit hanya menerima e-mel sehingga 27 aksara, jadi alamat yang panjang akan menyekat derma itu.

Isu-isu biasa

Kenapa Verify Token memaparkan "Invalid PAT Token"?

Token itu salah, atau token itu dari environment yang lain. Jika test mode GiveWP di-on-kan, guna token dari merchant dashboard sandbox. Jika test mode di-off-kan, guna token dari merchant dashboard live. Lihat Cari API keys anda.

Penderma nampak "Email length reaches a limit of 27 characters." Apa maksudnya?

Untuk derma berulang melalui Direct Debit, e-mel penderma boleh ada maksimum 27 aksara. Untuk derma sekali sahaja, hadnya 50 aksara. Minta penderma guna alamat e-mel yang lebih pendek.

Kenapa penderma nampak "Please tick the create account button if you want to create a subscription donation"?

Derma berulang memerlukan akaun penderma. Penderma perlu tandakan pilihan untuk membuat akaun pada form derma, kemudian cuba semula.

Kenapa saya hanya nampak pilihan Online Banking pada form derma berulang saya?

Derma berulang dikutip melalui Direct Debit, dan Direct Debit berjalan melalui gateway Online Banking. Saluran Bayarcash yang lain tidak dipaparkan pada form derma berulang. Saluran itu hanya menerima derma sekali sahaja.

Adakah artikel ini membantu?