Terima bayaran Bayarcash dalam OpenCart

Dengan modul Bayarcash, kedai OpenCart anda boleh menerima bayaran melalui Bayarcash. Modul ini ada dua fail zip: satu untuk OpenCart 3 dan satu lagi untuk OpenCart 4. Guna fail yang sepadan dengan versi kedai anda.

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

Sebelum anda mula

Anda memerlukan perkara berikut:

• Akaun merchant Bayarcash yang sudah diluluskan, dengan saluran bayaran anda sudah di-on-kan.
• Personal Access Token, API Secret dan Portal Key anda. Lihat Cari API keys anda dan Portal.
• Ringgit Malaysia (MYR) sebagai salah satu mata wang dalam kedai anda.

Install modul

Muat turun fail zip modul dari page plugin Bayarcash. Kemudian:

1. Dalam admin OpenCart, pergi ke Extensions → Installer dan upload fail zip itu.
2. Pergi ke Extensions → Extensions dan pilih jenis Payments.
3. Cari Bayarcash dalam senarai. Klik Install, kemudian Edit.

Masukkan keys anda

Tetapan dibuka pada tab API details. Untuk mengisinya:

1. Kekalkan atau tukar Payment Name. Pelanggan nampak nama ini semasa checkout.
2. Paste Personal Access Token, API Secret dan Portal Key anda.
3. Biarkan Sandbox Mode off untuk bayaran sebenar. On-kan hanya dengan keys sandbox.
4. Simpan. OpenCart menyemak token anda semasa anda simpan.

Pilih saluran & aktifkan modul

Seterusnya, buka tab General:

1. Di bawah Payment Channels, pilih saluran yang anda mahu tawarkan. Tekan Ctrl atau Cmd untuk memilih beberapa saluran.
2. Tetapkan Status kepada on.
3. Simpan.

Semasa checkout, pelanggan nampak setiap saluran dengan nama mengikut Payment Name anda, contohnya “Bayarcash - Credit Card”.

Tetapan lain

Tab-tab ini pilihan:

Tab	Fungsinya
Order status	Menetapkan status untuk Canceled Order Status, Failed Order Status dan Paid Order Status.
Customize checkout	Instruction memaparkan teks anda sendiri sebelum pelanggan membayar.
Troubleshoot	Debug logging menulis butiran ke log ralat OpenCart.

Tips

Dua habit ini membantu anda dengan OpenCart:

• Uji sebelum anda go live. On-kan Sandbox Mode dengan keys sandbox dan buat satu pesanan. Kemudian, off-kan suis itu dan guna keys live anda.
• Semak Sandbox Mode dahulu jika bayaran live gagal. Sandbox Mode mesti off untuk bayaran sebenar.

Isu-isu biasa

Kenapa checkout memaparkan 'Bayarcash requires MYR currency to be set-up.'?

Tambah ringgit Malaysia (MYR) sebagai mata wang dalam kedai anda. Bayarcash hanya memproses MYR. Mata wang lain hanya berfungsi jika Convert To Processing di-on-kan.

Kenapa saya tidak dapat menyimpan tetapan kerana ada ruangan yang kosong?

Personal Access Token, API Secret, Portal Key dan Payment Name wajib diisi. Jika anda on-kan Instruction, Bayarcash Instructions juga wajib diisi.

Kenapa saya nampak teks error_invalid_token atau error_pat_required semasa menyimpan tetapan?

Ini mesej ralat yang belum siap. Maksudnya, Personal Access Token kosong, atau Bayarcash tidak menerima token itu. Copy token itu sekali lagi dari merchant dashboard anda dan simpan.

Kenapa pelanggan nampak 'Invalid redirect.' atau 'Payment method is incorrect!' semasa checkout?

Minta pelanggan kembali ke checkout dan pilih kaedah bayaran Bayarcash sekali lagi. Jika masalah ini berulang, on-kan Debug logging pada tab Troubleshoot dan kongsi log ralat OpenCart dengan team Bayarcash.

Artikel berkaitan

• Cari API keys & portal key anda
• Tambah & guna portal
• Saluran bayaran yang boleh anda terima melalui Bayarcash
• Semak transaksi dan statusnya