Sambungkan Paymattic kepada Bayarcash

Bayarcash for Paymattic menambah kaedah bayaran Bayarcash pada form Paymattic Pro anda. Pelanggan anda mengisi form, membuat bayaran di page Bayarcash, dan kemudian kembali ke page pengesahan form anda.

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

Kaedah bayaran yang disokong

Setiap saluran ialah satu kaedah bayaran yang anda tambah pada form:

Kaedah bayaran	Pelanggan anda membayar dengan
FPX Online Banking	Online banking FPX
Credit Card	Akaun kad kredit melalui FPX
DuitNow Online Banking	DuitNow Online Banking/Wallets
DuitNow QR	Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR
SPayLater	SPayLater daripada Shopee
Boost PayFlex	Boost PayFlex
Indonesia Online Banking	Online banking Indonesia (QRIS)
Indonesia e-Wallet	E-wallet Indonesia (QRIS)
NETS Singapore	NETS (Singapura)

Setiap bayaran ialah bayaran sekali sahaja, dalam MYR. Langganan dan Direct Debit tidak disokong. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat Saluran bayaran.

Sebelum anda mula

Sediakan perkara ini sebelum anda menyediakan plugin:

• Akaun merchant Bayarcash yang sudah diluluskan.
• Personal Access Token (PAT), API Secret Key dan Portal Key anda. Lihat Cari API keys anda.
• Paymattic Pro yang sudah di-install dan aktif, dengan mata wang ringgit Malaysia (MYR).
• Fail zip plugin Bayarcash for Paymattic. Plugin ini tiada di WordPress.org. Muat turun fail zip daripada Bayarcash.

Install plugin

Upload fail zip itu ke WordPress:

1. Dalam WordPress, pergi ke Plugins → Add New → Upload Plugin.
2. Pilih fail zip itu dan klik Install Now.
3. Klik Activate Plugin.

Masukkan keys anda

Anda hanya perlu masukkan keys sekali untuk semua form anda:

1. Pergi ke Paymattic → Bayarcash Settings. Tab Global Configuration dibuka.
2. Biarkan Enable Sandbox Mode off untuk bayaran sebenar.
3. Paste token anda ke dalam Personal Access Token dan klik Verify Token. Jika token itu sah, mesej “Token verified successfully” dipaparkan.
4. Paste portal key anda ke dalam Portal Key.
5. Paste secret key anda ke dalam API Secret Key.
6. Pilihan: di bawah Miscellaneous, tukar Payment Title. Secara default, tajuk ini ialah Bayarcash.
7. Simpan tetapan anda.

Tambah Bayarcash pada form

Selepas keys anda disimpan, tambah kaedah bayaran pada setiap form:

1. Buka form itu dalam Paymattic.
2. Tambah ruangan nama dan ruangan e-mel jika form itu belum ada ruangan ini. Bayarcash memerlukan kedua-duanya.
3. Tambah elemen kaedah bayaran Bayarcash yang anda mahu, contohnya FPX Online Banking dan DuitNow QR. Setiap elemen hanya boleh ditambah sekali dalam satu form.
4. Pilihan: tukar Payment Option Label bagi setiap kaedah. Secara default, label ini ialah “Pay with” diikuti nama kaedah itu.
5. Simpan form itu.

Guna keys lain untuk satu form

Sesuatu form boleh menggunakan akaun atau portal Bayarcash sendiri, dan bukan tetapan global:

1. Dalam Paymattic → Bayarcash Settings, buka Form Configuration dan pilih form itu.
2. On-kan Customization.
3. Masukkan Personal Access Token, Portal Key dan API Secret Key untuk form ini.
4. Simpan tetapan anda.

Tambah caj pemprosesan

Dengan tab Bayarcash Gateway Fee, anda boleh menambah caj pada amaun yang pelanggan bayar. Caj ini boleh ditetapkan untuk FPX Online Banking, Credit Card, DuitNow Online Banking dan DuitNow QR. Caj boleh dalam amaun tetap, peratusan, atau kedua-duanya, dengan keterangan yang pelanggan nampak. Saluran lain menggunakan caj DuitNow QR.

Uji dalam sandbox

Buat ujian dalam sandbox Bayarcash sebelum anda menerima bayaran sebenar:

1. Dapatkan token, secret key dan portal key dari merchant dashboard sandbox. Keys live tidak berfungsi dalam sandbox.
2. On-kan Enable Sandbox Mode. Page itu memaparkan “Sandbox mode is enabled. Make sure to use sandbox credentials for testing.”
3. Masukkan keys sandbox, sahkan token dan simpan.
4. Buat satu test payment pada form anda.
5. Apabila semuanya berfungsi, off-kan Enable Sandbox Mode, masukkan keys live anda dan simpan semula.

Jika Customization di-on-kan untuk sesuatu form, form itu ada suis Enable Sandbox Mode sendiri. Semak suis itu juga.

Cara Bayarcash menghantar keputusan bayaran ke laman web anda

Anda tidak perlu paste callback URL ke dalam merchant dashboard. Plugin ini menghantar alamatnya sendiri bersama setiap bayaran. Bayarcash melaporkan keputusan bayaran ke laman web anda di /index.php?wpf_payment_api_notify=1, dan pelanggan anda kembali ke page pengesahan form anda. Plugin ini menandakan bayaran itu sebagai sudah dibayar atau gagal. Bayaran yang masih pending kekal pending.

Sentiasa sahkan bayaran dalam merchant dashboard sebelum anda menghantar apa-apa yang bernilai tinggi. Lihat Transaksi.

Jika bayaran kekal pending walaupun pelanggan berjaya membayar, pastikan laman web anda boleh diakses oleh umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu.

Tips

Dua habit ini membantu anda dengan Paymattic:

• Guna Backup and Restore sebelum perubahan besar. Dengan tab Backup and Restore, anda boleh export tetapan Bayarcash anda dan memulihkannya kemudian.
• Guna portal berasingan untuk setiap form yang memerlukan laporan sendiri. Jika satu form ada portal sendiri, bayaran form itu berasingan dalam laporan Bayarcash anda.

Isu-isu biasa

Kenapa form saya memaparkan "Currency not supported. Only MYR is supported."?

Bayarcash hanya menerima bayaran dalam MYR. Tukar mata wang kepada ringgit Malaysia dalam tetapan bayaran Paymattic. Selagi mata wang belum ditukar, page tetapan Bayarcash memaparkan notis merah tentang mata wang yang tidak disokong.

Kenapa form saya memaparkan "Bayarcash doesn't support subscriptions at this time"?

Bayarcash for Paymattic hanya untuk bayaran sekali sahaja. Buang item langganan daripada form itu, atau guna kaedah bayaran lain untuk item itu.

Kenapa Verify Token memaparkan "Verification failed" atau "Invalid token or API response"?

Token itu salah, atau token itu dari merchant dashboard yang lain. Jika Enable Sandbox Mode di-on-kan, guna token dari merchant dashboard sandbox. Jika suis itu off, guna token dari merchant dashboard live. Lihat Cari API keys anda.

Kenapa saya nampak "Bayarcash for Paymattic requires Paymattic to be installed and activated."?

Install dan aktifkan Paymattic Pro dahulu, kemudian refresh page itu.

Artikel berkaitan

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