# Hantar payment link BCL dari pesanan WooCommerce

> Install BCL Payment Link, buat payment link BCL bagi pesanan WooCommerce yang belum dibayar, dan pesanan dikemas kini apabila pelanggan bayar.
>
> Source: https://docs.bayarcash.com/ms/bcl-payment-link/

**BCL Payment Link** menambah lajur **BCL Payment Link** pada senarai pesanan WooCommerce anda. Untuk pesanan yang belum dibayar, anda boleh buat payment link BCL dengan satu klik. Kemudian, hantar link itu kepada pelanggan anda, contohnya melalui WhatsApp atau e-mel. Apabila pelanggan membayar, plugin ini menandakan pesanan itu sebagai sudah dibayar. Guna plugin ini untuk mendapatkan semula pesanan yang pelanggan tidak selesaikan.

Plugin ini menggunakan [BCL](https://bcl.my), yang menerima bayaran melalui Bayarcash. Lihat [Apa itu Bayarcash & apa bezanya dengan BCL?](/ms/what-is-bayarcash/)

## Kaedah bayaran yang disokong

Semua link dari laman web anda menggunakan satu kaedah bayaran. Anda pilih kaedah itu dalam **Payment Method**:

| Pilihan | Cara pelanggan anda membayar |
|---|---|
| **FPX (Current & Saving Account)** | Online banking FPX |
| **Line of Credit** | Akaun kad kredit melalui FPX |
| **DuitNow OBW** | Online banking atau e-wallet DuitNow |

## Sebelum anda mula

Sediakan perkara ini sebelum anda menyediakan plugin itu:

- WooCommerce yang sudah di-install dan aktif. Plugin ini memerlukannya.
- Akaun BCL yang sudah disambungkan kepada Bayarcash. Untuk mendaftar, pergi ke [bcl.my/register](https://bcl.my/register).
- API token BCL dengan **API Read** dan **API Write**. Lihat [Cipta API token](https://docs.bcl.my/ms/api-tokens/) dalam Help Centre BCL.
- **Portal Key** Bayarcash anda. Lihat [Cari API keys anda](/ms/api-keys/).

## Install plugin

Plugin ini percuma di WordPress.org sebagai [BCL Payment Link](https://wordpress.org/plugins/bcl-payment-link/). Untuk install plugin ini:

1. Dalam WordPress, pergi ke **Plugins** → **Add New**.
2. Cari **BCL Payment Link** dan klik **Install**.
3. Klik **Activate**.

## Sediakan plugin

Tetapan plugin ini ada pada satu tab dalam tetapan WooCommerce:

1. Pergi ke **WooCommerce** → **Settings** dan buka tab **BCL Payment Link**. Link **Settings** di bawah plugin ini pada page **Plugins** juga membuka tab yang sama.
2. Isi ruangan ini:

   | Ruangan | Apa yang perlu dimasukkan |
   |---|---|
   | **API Token** | API token BCL anda. Wajib. |
   | **Portal Key** | Portal key Bayarcash anda. Wajib. |
   | **Order Prefix** | Kod pendek untuk laman web ini, contohnya `SITEA`. Wajib. BCL menerima nombor pesanan sebagai prefix, tanda sempang dan nombor pesanan, contohnya `SITEA-116`. |
   | **Payment Method** | Kaedah bayaran untuk semua link. Nilainya **FPX (Current & Saving Account)** sehingga anda menukarnya. |

3. Simpan perubahan.

## Hantar payment link

Buat langkah ini untuk setiap pesanan yang belum dibayar:

1. Pergi ke **WooCommerce** → **Orders**.
2. Dalam lajur **BCL Payment Link** bagi pesanan itu, klik **Generate Payment Link**. Plugin ini memaparkan "Payment link generated successfully. Refreshing page..." dan memuatkan semula page itu.
3. Klik **Copy Link**. Butang itu memaparkan "Copied!".
4. Hantar link itu kepada pelanggan anda.

Plugin ini juga menambah nota pesanan peribadi dengan link itu: "BCL payment link generated: ...". Link itu menggunakan amaun, nama, e-mel dan nombor telefon pada pesanan itu.

## Cara pesanan dikemas kini

Plugin ini menyemak status setiap link lebih kurang sekali seminit. Plugin ini menyemak 50 pesanan terbaru yang ada link dan berstatus Pending payment, On hold, Cancelled atau Failed. Kemudian, plugin ini menukar pesanan itu:

| Keputusan bayaran dalam BCL | Status pesanan | Nota pesanan |
|---|---|---|
| Paid | Processing | "Payment received via BCL Payment Link" |
| Cancelled | Cancelled | "Payment cancelled" |
| Failed | Failed | "Payment failed" |

Selagi bayaran itu baru atau pending, pesanan itu kekal seperti biasa.

## Tips

- **Guna Order Prefix yang berbeza pada setiap laman web.** Plugin ini mencari setiap bayaran mengikut nombor pesanannya. Jika dua laman web menggunakan prefix yang sama, bayaran kedua-duanya boleh bercampur.
- **Jalankan WP-Cron dari server.** Jika laman web anda kurang trafik, sediakan cron job pada server untuk WP-Cron. Dengan cara ini, status pesanan yang sudah dibayar bertukar tepat pada masanya.

## Isu biasa

### Kenapa Generate Payment Link memaparkan "Error: Failed to generate payment link"?

Semak API Token dan Portal Key dalam WooCommerce → Settings → BCL Payment Link. Token itu mesti ada API Write. Log WooCommerce, dengan sumber bcl-payment-link, menunjukkan jawapan daripada BCL.

### Kenapa pesanan masih Pending payment walaupun pelanggan saya sudah bayar?

Plugin ini menyemak bayaran lebih kurang sekali seminit melalui WP-Cron, dan WP-Cron hanya berjalan apabila seseorang membuka laman web anda. Jika laman web anda kurang trafik, semakan itu boleh lambat. Jangan tukar Order Prefix selepas anda menghantar link: semakan itu mencari nombor pesanan dengan prefix yang sedang digunakan.

### Kenapa sesetengah pesanan tiada butang Generate Payment Link?

Plugin ini memaparkan butang itu untuk pesanan yang belum dibayar sahaja. Pesanan yang sudah dibayar memaparkan "Order Paid", atau "Order Paid via BCL" jika pesanan itu dibayar melalui payment link BCL.