Artikel ini menunjukkan cara mendapatkan pemalam (plugin) WooCommerce QashierPay dan kelayakan API anda daripada QashierHQ, memasang pemalam itu di laman WordPress anda, dan menyediakannya supaya pelanggan boleh membayar dengan QashierPay semasa checkout WooCommerce. Artikel ini untuk peniaga di Singapura dan Malaysia yang mempunyai akaun pembayaran dalam talian QashierPay yang telah diluluskan.
Terpakai untuk: Singapura dan Malaysia · pembayaran dalam talian QashierPay · QashierHQ Pembayaran dalam talian · WordPress dengan WooCommerce. Anda memerlukan log masuk QashierHQ dan akses pentadbir WordPress.
Sebelum anda bermula
Akaun pembayaran dalam talian QashierPay anda mesti diluluskan. Dalam QashierHQ, buka Gerbang Pembayaran Dalam Talian di bar sisi kiri. Jika anda melihat Mula menerima pembayaran dalam talian, klik Mohon sekarang dan lengkapkan permohonan terlebih dahulu. QashierHQ menyatakan bahawa kelulusan biasanya mengambil masa 1–2 hari bekerja.
Sediakan log masuk pentadbir WordPress anda.
Tetapkan mata wang kedai WooCommerce anda kepada SGD (Singapura) atau MYR (Malaysia) sebelum anda mendayakan gerbang pembayaran.
Pemalam ini menerima pembayaran. Ia bukan tetapan Tetapan > WooCommerce API dalam QashierHQ, yang menyegerakkan inventori. Untuk inventori, lihat Cara Menyegerakkan Inventori WooCommerce dengan Qashier.
Langkah 1: Dapatkan pemalam dan kelayakan API anda dalam QashierHQ
Terdapat dua tempat dalam QashierHQ untuk melakukan ini. Pilihan A terdapat pada halaman persediaan dalam talian untuk peniaga yang mendaftar dalam talian; jika QashierHQ tidak membuka halaman itu untuk anda, gunakan Pilihan B. Kedua-duanya mencipta set kunci yang sama: satu kunci API dan rahsia webhook bagi setiap kedai, yang juga boleh digunakan untuk Developer API.
Pilihan A: halaman persediaan pembayaran dalam talian
Log masuk ke QashierHQ dan buka hq.qashier.com/onboarding/online-payments.
Pilih tab WooCommerce dan klik Configure API keys (Konfigurasi kunci API). Tetingkap Configure for WooCommerce (Konfigurasi untuk WooCommerce) dibuka.
Jika anda mempunyai lebih daripada satu kedai, pilih kedai itu di bawah Kedai. Masukkan Your website URL (URL laman web anda) dan klik Generate API keys (Jana kunci API).
Salin API key (kunci API), Store ID (ID kedai) dan Webhook secret (rahsia webhook) dan simpan di tempat yang selamat. Nilai ini hanya dipaparkan sekali.
Pilihan B: halaman Gerbang Pembayaran Dalam Talian
Di bar sisi kiri QashierHQ, klik Gerbang Pembayaran Dalam Talian. Kunci dicipta untuk kedai yang dipilih dalam QashierHQ.
Pada kad WooCommerce, klik Sambung. Tetingkap Sambung WooCommerce dibuka.
Di bawah langkah 1, klik Muat turun pemalam (.zip) dan simpan fail itu.
Di bawah langkah 2, masukkan URL kedai anda dan klik Jana kunci.
Salin Kunci pengguna (kunci API) dan Rahsia pengguna (rahsia webhook) dan simpan di tempat yang selamat. Nilai ini hanya dipaparkan sekali. Tetingkap ini tidak menunjukkan Store ID anda, yang juga diperlukan oleh pemalam. Minta Store ID daripada kenalan onboarding Qashier anda atau sokongan Qashier. Jika anda boleh menggunakan Pilihan A, pilihan itu menunjukkan Store ID bersama kunci API dan rahsia webhook yang baharu; menjana kunci di sana akan menggantikan kunci daripada tetingkap ini, jadi tampal ketiga-tiga nilai baharu itu ke dalam pemalam.
Gunakan jadual ini untuk memadankan nilai QashierHQ dengan medan pemalam:
Dalam QashierHQ | Dalam tetapan pemalam |
API key / Kunci pengguna (kunci API) | API Key |
Webhook secret / Rahsia pengguna (rahsia webhook) | Webhook Secret Key |
Store ID | Store Id |
Jika Qashier menyediakan akaun anda untuk anda, kenalan onboarding anda mungkin telah menghantar fail pemalam dan nilai-nilai ini kepada anda.
Langkah 2: Pasang dan aktifkan pemalam
WordPress satu laman (single-site)
Dalam papan pemuka WordPress anda, pergi ke Plugins (Pemalam) > Add New (Tambah Baharu).
Klik Upload Plugin (Muat Naik Pemalam) di bahagian atas halaman.
Pilih fail .zip pemalam yang anda muat turun daripada QashierHQ dan klik Install Now (Pasang Sekarang).
Apabila pemasangan selesai, klik Activate Plugin (Aktifkan Pemalam).
WordPress berbilang laman (multisite)
Dalam papan pemuka rangkaian WordPress anda, pergi ke Plugins > Add New.
Klik Upload Plugin, kemudian pilih fail .zip pemalam.
Klik Install Now.
Klik Network Activate (Aktifkan Rangkaian) untuk mendayakan pemalam pada semua laman. Jika anda hanya mahu QashierPay pada sesetengah laman, pergi ke halaman Plugins bagi setiap laman itu dan klik Activate (Aktifkan) di sana.
Langkah 3: Sediakan pemalam dalam WooCommerce
Jika anda menggunakan multisite, buka papan pemuka laman yang anda mahu sediakan.
Pergi ke WooCommerce > Settings (Tetapan) > Payments (Pembayaran).
Cari Qashier – Qashier Pay dalam senarai dan klik Finish Setup (Selesaikan Persediaan).
Isi medan mengikut susunan ia dipaparkan:
Enable Qashier Pay (Dayakan Qashier Pay): tandakan untuk menghidupkan gerbang pembayaran.
Qashier Gateway In Use (Gerbang Qashier yang digunakan): pilih pasaran anda, Singapore atau Malaysia.
Mode (Mod): Test (Ujian) semasa anda membuat persediaan, Live (Langsung) untuk pembayaran sebenar.
Description (Penerangan): teks yang pelanggan lihat di sebelah pilihan pembayaran semasa checkout, contohnya "Pay via QPay".
Store Id: tampal Store ID anda daripada QashierHQ.
API Key: tampal kunci API anda daripada QashierHQ.
Webhook Secret Key: tampal rahsia webhook anda daripada QashierHQ.
Debug Log (Log Nyahpepijat): tandakan hanya semasa menguji.
Klik Save changes (Simpan perubahan).
Langkah 4: Uji dan mula beroperasi
Dengan Mode ditetapkan kepada Test, buat pesanan ujian di kedai anda dan pilih Qashier Pay semasa checkout. Semak bahawa anda dibawa ke halaman pembayaran QashierPay dan kembali ke kedai anda.
Dalam tetapan pemalam, tukar Mode kepada Live, nyahtanda Debug Log dan klik Save changes.
Buat pesanan sebenar yang kecil untuk mengesahkan ia dipaparkan dalam QashierHQ.
Apa yang anda patut lihat
Pelanggan melihat Qashier Pay sebagai kaedah pembayaran semasa checkout. Lihat [SG/MY] Cara Pelanggan Membayar dengan QashierPay di Kedai WooCommerce Anda untuk apa yang pelanggan lihat dan di mana setiap pembayaran direkodkan.
Pesanan yang telah dibayar ditanda sebagai dibayar dalam WooCommerce, dan pembayaran itu dipaparkan dalam QashierHQ. Bayaran balik penuh dan separa disegerakkan semula ke pesanan WooCommerce anda.
Pembayaran keluar dipaparkan dalam QashierHQ di bawah Wang & Kewangan > Laporan Pembayaran.
Jika berlaku masalah
Gejala | Kemungkinan punca | Apa yang perlu dilakukan |
Qashier Pay tidak dipaparkan semasa checkout | Pemalam tidak diaktifkan, Enable Qashier Pay tidak ditanda, atau mata wang kedai bukan SGD atau MYR | Aktifkan pemalam pada halaman Plugins, tandakan Enable Qashier Pay di bawah WooCommerce > Settings > Payments > Qashier Pay, dan tetapkan mata wang kepada SGD (Singapura) atau MYR (Malaysia) |
Halaman pembayaran gagal atau pesanan kekal belum dibayar | Kunci API, Store Id atau rahsia webhook yang salah atau lama, atau pasaran Qashier Gateway In Use yang salah | Jana semula kunci dalam QashierHQ (lihat di bawah) dan tampal ketiga-tiga nilai sekali lagi; semak bahawa pasaran sepadan dengan akaun Qashier anda |
Anda kehilangan kunci API atau rahsia webhook | Kunci hanya dipaparkan sekali | Jana semula kunci dalam QashierHQ (lihat di bawah) |
Mengklik Configure API keys meminta anda mengesahkan perniagaan anda terlebih dahulu | Anda belum menghantar permohonan QashierPay anda | Lengkapkan permohonan (Gerbang Pembayaran Dalam Talian > Mohon sekarang). Anda boleh menjana kunci sebaik sahaja permohonan dihantar; pembayaran sebenar hanya berfungsi selepas permohonan diluluskan. |
Untuk menjana semula kunci anda: dalam QashierHQ, buka Configure for WooCommerce (Pilihan A) atau Sambung WooCommerce (Pilihan B), masukkan URL kedai anda dan klik Generate API keys atau Jana semula kunci. Taip REGENERATE apabila diminta, kemudian klik Regenerate (Jana semula) atau Sahkan jana semula. Kunci API dan rahsia webhook lama anda berhenti berfungsi serta-merta, jadi tampal nilai baharu ke dalam pemalam dengan segera.
Jika anda masih menghadapi masalah, hubungi pasukan sokongan tempatan anda: Hubungi Sokongan Qashier melalui Telefon, WhatsApp, LINE atau Viber (SG, MY, TH, PH).
Artikel berkaitan
Disahkan terakhir: 25 Sep 2026 · Pasaran: SG, MY