# Sambungkan Paymattic kepada Bayarcash

> Install Bayarcash for Paymattic, masukkan keys anda dan tambah kaedah bayaran Bayarcash pada form Paymattic Pro anda.
>
> Source: https://docs.bayarcash.com/ms/paymattic/

**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](https://form.bayarcash-demo.com/paymattic/).

## 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](/ms/payment-channels/).

## 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](/ms/api-keys/).
- 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](https://bayarcash.com/wp-content/uploads/sites/2/2025/02/bayarcash-for-paymattic.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](https://console.bayarcash-sandbox.com). 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](/ms/transactions/).

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 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 (/ms/api-keys/).

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

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