# Sambungkan akaun Bayarcash anda

> Sambungkan BCL kepada akaun merchant Bayarcash anda dengan Personal Access Token dan API Secret Key supaya payment form anda menerima bayaran sebenar.
>
> Source: https://docs.bcl.my/ms/connect-bayarcash/

BCL menerima bayaran melalui Bayarcash. Untuk menerima bayaran sebenar, paste **Personal Access Token (PAT)** dan **API Secret Key** Bayarcash anda ke dalam BCL. Ini langkah 1 daripada 4 untuk jualan pertama anda.

Selagi anda belum menyambungkan Bayarcash atau on-kan **Test Mode**, BCL navigate ke page Payment Settings setiap kali anda log masuk.

## Sebelum anda mula

Anda memerlukan dua perkara sebelum menyambungkan akaun:

- Akaun merchant Bayarcash yang sudah diluluskan. Jika anda belum ada, [daftar sebagai merchant Bayarcash](https://console.bayar.cash/register-merchant) dahulu.
- Anda mesti account owner BCL. Hanya account owner yang boleh menukar tetapan bayaran.

> **Tip**
> Masih menunggu kelulusan Bayarcash? On-kan **Test Mode** dan mula membina payment form anda. Test payment dihantar ke sandbox Bayarcash, dan tiada transaksi sebenar yang berlaku. Anda tidak perlu edit payment form itu selepas anda menyambungkan akaun.

## Dapatkan token & secret key anda

Kedua-dua keys ini datang dari Bayarcash Console:

1. Log masuk ke [Bayarcash Console](https://console.bayar.cash/).
2. Buka [page Integration](https://console.bayar.cash/token-secret-key).
3. Copy **Personal Access Token (PAT)** dan **API Secret Key** anda.

## Sambungkan BCL kepada Bayarcash

Selepas anda copy kedua-dua keys, sambungkan akaun anda dalam BCL:

1. Di sidebar, pergi ke **Platform Setup** → **Payment**.

   *(Screenshot: Menu Platform Setup di sidebar BCL, dengan Payment ditanda)*

2. Page **Payment Settings** dibuka pada tab **Bayarcash Setup**. Off-kan **Test Mode**.

   *(Screenshot: Tab Bayarcash Setup dengan suis Test Mode ditanda)*

3. Paste token anda ke dalam **Personal Access Token (PAT)** dan key anda ke dalam **API Secret Key**. BCL menyemak kedua-dua keys apabila anda klik di luar setiap ruangan. Jika keys itu sah, kotak hijau **Token Verified** memaparkan nama merchant dan e-mel Bayarcash anda.

   *(Screenshot: Ruangan Personal Access Token (PAT) dan API Secret Key ditanda)*

   *(Screenshot: Kotak hijau Token Verified, yang mengesahkan keys anda sah dan sedia untuk menerima bayaran)*

4. Selepas keys disahkan, ruangan **Default Portal** dipaparkan. Pilih portal Bayarcash yang menerima bayaran apabila sesuatu payment form tidak memilih portal sendiri. Jika anda hanya ada satu portal, BCL memilihnya untuk anda. Lihat [Pilih portal key Bayarcash](/ms/bayarcash-portal-key/).

   *(Screenshot: Ruangan Default Portal yang sudah ditetapkan kepada satu portal, ditanda di bawah API Secret Key)*

5. Klik **Save Configuration**.

   *(Screenshot: Butang Save Configuration ditanda)*

Kali pertama anda menyimpan, BCL juga copy butiran syarikat anda dari Bayarcash Console jika profil syarikat anda belum ada nombor pendaftaran.

## Tukar tetapan kemudian

Apabila anda menukar token, secret key atau portal default selepas simpanan pertama, BCL meminta kod sekali guna untuk mengesahkan bahawa itu memang anda:

1. Buat perubahan anda dan klik **Save Configuration**.
2. Dalam **Send code via**, pilih **Email** atau **SMS**, kemudian klik **Send code**. SMS hanya ditawarkan jika nombor telefon account owner ialah nombor Malaysia (+60).
3. Masukkan kod itu dalam **One-time code** dan klik **Verify & Save**.

Langkah seterusnya: [Tetapkan caj gateway anda](/ms/gateway-fees/).

## Isu biasa

### Akaun Bayarcash saya baru diluluskan. Adakah saya perlu edit payment form yang saya bina dalam Test Mode?

Tidak perlu. Di Platform Setup → Payment, masukkan token dan secret key anda, pilih Default Portal dan off-kan Test Mode. Payment form yang tidak memilih portal sendiri akan menggunakan portal default.

### Kenapa BCL asyik navigate saya kembali ke page Payment Settings?

BCL memerlukan akaun Bayarcash yang sudah disambungkan, atau Test Mode yang di-on-kan. Simpan Personal Access Token (PAT) dan API Secret Key anda, atau on-kan Test Mode untuk mencuba BCL dahulu.

### Kenapa saya tidak nampak ruangan token?

Hanya account owner yang boleh menukar tetapan bayaran. Admin lain nampak notis dengan nama dan e-mel account owner. Minta account owner membuat perubahan itu.