# Sambungkan Gravity Forms kepada Bayarcash

> Install Bayarcash for Gravity Forms, masukkan keys anda dan tambah feed Bayarcash supaya form anda terima bayaran FPX, DuitNow dan lain-lain.
>
> Source: https://docs.bayarcash.com/ms/gravity-forms/

**Bayarcash for Gravity Forms** menambah Bayarcash pada payment form Gravity Forms anda. Pelanggan anda mengisi form, memilih kaedah bayaran dan membayar di page Bayarcash. Kemudian pelanggan kembali ke page pengesahan form anda.

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

## Saluran yang disokong

Anda pilih saluran yang pelanggan anda nampak. Pilihan dalam **Payment Channels** ialah:

| Saluran | Cara pelanggan anda membayar |
|---|---|
| FPX Online Banking | Perbankan online FPX |
| Credit/Debit Card | Akaun kad kredit melalui FPX |
| DuitNow Online Banking | DuitNow Online Banking/Wallets |
| DuitNow QR | Mana-mana aplikasi bank atau e-wallet yang menyokong DuitNow QR |
| ShopeePayLater | SPayLater by Shopee |
| Boost PayFlex | Boost PayFlex |
| Indonesia Online Banking | Perbankan online Indonesia (QRIS) |
| Indonesia E-Wallet | E-wallet Indonesia (QRIS) |
| NETS Singapore | NETS (Singapura) |

Plugin ini hanya menerima bayaran sekali sahaja, dalam MYR. Plugin ini tidak menyokong langganan dan Direct Debit. Sesuatu saluran hanya berfungsi jika saluran itu juga di-on-kan untuk portal Bayarcash anda. Lihat [Saluran bayaran](/ms/payment-channels/).

## Sebelum anda mula

Anda memerlukan perkara ini sebelum anda sediakan 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/).
- Gravity Forms yang sudah di-install dan aktif. Mata wang mesti ringgit Malaysia (MYR).

## Install plugin

Plugin ini tersenarai di WordPress.org dengan nama [Bayarcash for Gravity Forms](https://wordpress.org/plugins/bayarcash-for-gravity-forms/). Untuk install plugin ini:

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

> **Note**
> Panduan ini mengikut versi 2 plugin. Jika page tetapan Bayarcash anda hanya ada **Personal Access Token (PAT)** dan **Portal Key**, tanpa **API Secret Key** atau **Payment Channels**, anda menggunakan versi lama. Minta versi terkini daripada team Bayarcash.

## Masukkan keys anda

Setiap form yang tidak menetapkan keys sendiri akan menggunakan keys pada page tetapan global:

1. Pergi ke **Forms** → **Settings** → **Bayarcash**.
   
2. Paste token anda ke dalam **Personal Access Token (PAT)** dan klik **Verify Token**. Plugin memaparkan "Token verified successfully!" apabila token itu berfungsi.
3. Klik **View Portal** dan pilih portal anda dari **Available Portals**. Plugin mengisi **Portal Key** untuk anda.
4. Paste key anda ke dalam **API Secret Key**.
5. Dalam **Payment Channels**, buang tanda pada saluran yang anda tidak mahu. Semua saluran ditandakan pada mulanya.
6. Untuk bayaran sebenar, jangan tandakan **Enable Sandbox Mode**.
7. Simpan.

## Tambah Bayarcash pada form

Setiap form yang menerima bayaran memerlukan feed Bayarcash. Form itu juga memerlukan ruangan produk atau jumlah, serta ruangan untuk nama dan e-mel pelanggan.

1. Buka form itu dan pergi ke **Settings** → **Bayarcash**, kemudian tambah feed baru.
2. Beri nama untuk feed itu.
3. Dalam **Configuration Type**, pilih **Global Configuration** untuk menggunakan keys dari page tetapan. Untuk menggunakan akaun atau portal lain bagi form ini sahaja, pilih **Form Configuration**. Kemudian isi keys, saluran dan tetapan sandbox yang dipaparkan.
4. Pilih jenis transaksi dan amaun bayaran.
5. Di bawah **Client Information.**, padankan **Email** dan **Full Name** dengan ruangan form anda. **Phone Number** tidak wajib.
6. Pilihan: padankan **Purhase Description** (ejaan ini memang begitu dalam plugin) dengan ruangan yang teksnya dihantar bersama bayaran.
7. Pilihan: tetapkan **Cancel URL**, iaitu page yang pelanggan pergi jika mereka batalkan bayaran. Jika kosong, pelanggan kembali ke form.
8. Simpan feed itu.

Apabila form dibuka, pelanggan anda nampak **Select Payment Method** dengan saluran yang anda tandakan. Anda boleh hantar e-mel pada notification event **Payment Completed** dan **Payment Failed**.

## Uji dalam sandbox

Apabila **Enable Sandbox Mode** ditandakan, bayaran pergi ke sandbox Bayarcash dengan test keys yang sudah ada dalam plugin. Plugin tidak menggunakan keys yang anda masukkan untuk bayaran itu.

1. Tandakan **Enable Sandbox Mode** dan simpan.
2. Hantar form anda dan bayar di page sandbox.
3. Apabila semuanya berfungsi, buang tanda **Enable Sandbox Mode** dan simpan. Kemudian buat satu bayaran sebenar yang kecil untuk menyemak keys anda sendiri.

Feed yang ditetapkan kepada **Form Configuration** ada kotak **Enable Sandbox Mode** sendiri. Semak kotak itu juga.

## Cara keputusan bayaran sampai ke laman web anda

Anda tidak perlu paste URL callback ke dalam merchant dashboard. Plugin ini menghantar alamat sendiri bersama setiap bayaran, iaitu `/?callback=bayarcash-for-gravity-forms` pada laman web anda, dan Bayarcash menghantar keputusan ke alamat itu. Plugin menandakan entry itu sebagai paid, pending atau failed, dan menambah nota pada entry itu.

Jika entry kekal pending selepas bayaran berjaya, pastikan laman web anda terbuka kepada umum dan menggunakan HTTPS. Pastikan juga tiada firewall atau plugin keselamatan yang menyekat alamat itu. Lihat [Callback dan checksum](/ms/callbacks-and-checksum/).

## Tips

Dua habit ini membantu anda dengan Gravity Forms:

- **Sentiasa uji sekali dengan keys live anda.** Sandbox mode menggunakan keys plugin itu sendiri, jadi ujian sandbox tidak membuktikan keys anda betul.
- **Guna Form Configuration untuk kempen yang berasingan.** Portal yang berbeza bagi setiap form memisahkan bayaran setiap kempen dalam laporan Bayarcash anda.

## Isu biasa

### Kenapa form saya memaparkan "Required fields (email and name) must be mapped in the feed settings."?

Buka feed Bayarcash form itu. Di bawah Client Information., padankan Email dan Full Name dengan ruangan pada form anda. Kedua-duanya wajib.

### Kenapa form saya memaparkan "Global Bayarcash settings are not properly configured."?

Feed itu menggunakan Global Configuration, tetapi satu key tiada pada page tetapan global. Pergi ke Forms → Settings → Bayarcash dan isi Personal Access Token (PAT), Portal Key dan API Secret Key. Jika mesej itu menyebut "Form-specific", isi keys pada feed itu.

### Kenapa pelanggan nampak "Payment gateway error. Please try again later."?

Bayarcash menolak request bayaran itu, dan entry itu tidak disimpan. Semak keys anda. Pastikan juga saluran yang anda tandakan sudah di-on-kan untuk portal anda. Lihat Kenapa bayaran saya gagal? (/ms/payment-failed/).

### WordPress menyatakan ada dependencies yang tiada dan meminta saya run composer install. Apa yang saya perlu buat?

Fail plugin itu tidak lengkap. Delete plugin itu dan install semula dari salinan lengkap yang Bayarcash berikan.