# Sambungkan Easy Digital Downloads kepada Bayarcash

> Install Bayarcash for Easy Digital Downloads, masukkan keys anda dan pilih kaedah bayaran Bayarcash yang pembeli nampak semasa checkout.
>
> Source: https://docs.bayarcash.com/ms/easy-digital-downloads/

**Bayarcash for Easy Digital Downloads** menambah Bayarcash pada checkout EDD anda. Pembeli anda memilih kaedah bayaran, membuat bayaran di page Bayarcash, dan kemudian kembali ke page pengesahan pembelian anda.

Untuk melihat plugin ini berfungsi sebelum anda install, cuba [demo langsung](https://edd.bayarcash-demo.com/).

## Kaedah bayaran yang disokong

Anda pilih kaedah yang pembeli nampak semasa checkout. Pilihan dalam **Payment Methods** ialah:

| Kaedah bayaran | Pembeli anda membayar dengan |
|---|---|
| **FPX Online Banking** | Online banking FPX |
| **FPX Line of Credit** | Akaun kad kredit melalui FPX |
| **DuitNow Online Banking/Wallets** | Online banking atau e-wallet DuitNow |
| **DuitNow QR** | Mana-mana aplikasi perbankan atau e-wallet yang menyokong DuitNow QR |
| **Credit Card** | Visa atau Mastercard |
| **Touch n Go** | Touch 'n Go eWallet |
| **Boost Wallet** dan **Boost PayFlex** | E-wallet Boost, atau pay later daripada Boost |
| **GrabPay** dan **Grab PayLater** | GrabPay, atau PayLater daripada Grab |
| **ShopeePay** | ShopeePay |
| **QRIS Online Banking** dan **QRIS Wallet** | Online banking atau e-wallet Indonesia |
| **NETS** | NETS (Singapura) |
| **Alipay**, **WeChat Pay** dan **PromptPay** | Alipay, WeChat Pay atau PromptPay (Thailand) |

Bayaran dibuat sekali sahaja. Sesuatu kaedah hanya berfungsi jika kaedah 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/).
- Easy Digital Downloads yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR), dan page pembelian berjaya mesti sudah ditetapkan dalam tetapan page EDD.

## Install plugin

Plugin ini percuma di WordPress.org sebagai [Bayarcash For Easy Digital Downloads](https://wordpress.org/plugins/bayarcash-for-easy-digital-downloads/). Untuk install plugin ini:

1. Dalam WordPress, pergi ke **Plugins** → **Add New**.
2. Cari **Bayarcash for Easy Digital Downloads** dan klik **Install**.
3. Klik **Activate**.

## Masukkan keys anda

Nama keys dalam plugin ini sedikit berbeza daripada nama dalam merchant dashboard. **Token** ialah Personal Access Token (PAT) anda, dan **Secret Key** ialah API Secret Key anda.

1. Pergi ke **Downloads** → **Settings** → **Payments** dan buka bahagian **Bayarcash**.
   
2. Paste Personal Access Token anda ke dalam **Token**. Plugin ini menyemak token itu dan memaparkan "PAT Token is valid". Anda juga boleh klik **Verify Token**.
3. Paste API Secret Key anda ke dalam **Secret Key**.
4. Pilih portal anda dalam **Portal Key**. Senarai portal dipaparkan selepas token itu sah.
5. Dalam **Payment Methods**, tandakan kaedah yang pembeli anda boleh pilih.
6. Simpan.

## On-kan gateway Bayarcash

Keys sahaja tidak memaparkan Bayarcash semasa checkout. Anda juga perlu on-kan Bayarcash dalam EDD:

1. Dalam **Downloads** → **Settings** → **Payments**, buka senarai payment gateway EDD.
2. Tandakan **Bayarcash**.
3. Simpan.

Semasa checkout, pembeli nampak Bayarcash sebagai **Pay with Bayarcash**, dengan senarai kaedah yang anda tandakan.

## Uji dalam sandbox

Plugin ini mengikut test mode EDD, dan menggunakan test keys sendiri:

- **Test mode on:** bayaran dihantar ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Keys yang anda masukkan tidak digunakan.
- **Test mode off:** bayaran dihantar ke Bayarcash dengan keys anda sendiri.

On-kan test mode EDD, beli satu produk dan bayar di page sandbox. Apabila semuanya berfungsi, off-kan test mode. Kemudian, buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri.

## Cara keputusan bayaran dikemas kini di kedai anda

Anda tidak perlu paste callback URL ke dalam merchant dashboard. Selepas membayar, pembeli anda kembali ke page pembelian berjaya EDD anda. Kemudian, plugin ini menyemak keputusan bayaran di Bayarcash setiap minit dan mengemas kini pesanan itu. Setiap kali status berubah, plugin ini menambah nota pada pesanan.

Semakan ini berjalan melalui WP-Cron. Jadi, laman web anda mesti boleh diakses oleh umum dan WP-Cron mesti berjalan. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/).

## Tips

Dua habit ini membantu anda dengan Easy Digital Downloads:

- **Sentiasa buat satu ujian dengan keys live anda.** Test mode menggunakan keys plugin itu sendiri, jadi ujian itu tidak membuktikan keys anda betul.
- **On-kan Debug Mode semasa anda menyediakan plugin.** Debug Mode menulis baris `[Bayarcash]` dalam log EDD. Baris itu menunjukkan dengan tepat kenapa sesuatu bayaran gagal.

## Isu biasa

### Kenapa WordPress memaparkan "Bayarcash gateway is active but not fully configured."?

Salah satu daripada Token, Secret Key atau Portal Key masih kosong. Isi ketiga-tiganya di bahagian Bayarcash dalam tetapan bayaran EDD dan simpan. Lihat Cari API keys anda (/ms/api-keys/).

### Kenapa pembeli nampak "No payment methods available." semasa checkout?

Tiada kotak yang ditandakan dalam Payment Methods. Tandakan sekurang-kurangnya satu kaedah dan simpan.

### Kenapa pembeli nampak "Payment error:" diikuti mesej daripada Bayarcash?

Bayarcash menolak request bayaran itu. Punca biasa ialah key yang salah, atau kaedah bayaran yang belum di-on-kan untuk portal anda. On-kan Debug Mode, cuba sekali lagi dan baca baris [Bayarcash] dalam log EDD. Lihat Kenapa bayaran gagal (/ms/payment-failed/).

### Kenapa pesanan masih pending walaupun pembeli sudah membayar?

Plugin ini mengesahkan bayaran dengan menyemak status di Bayarcash setiap minit melalui WP-Cron. Jika laman web anda kurang trafik atau WP-Cron di-off-kan, sediakan cron job sebenar supaya semakan itu berjalan tepat pada masanya.