Sambungkan Gravity Forms kepada Bayarcash

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.

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.

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.
• 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. Untuk install plugin ini:

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

Nota

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.

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-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?.

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.

Artikel berkaitan

• Cari API keys & portal key anda
• Saluran bayaran yang boleh anda terima melalui Bayarcash
• Sahkan callback dan checksum
• Kenapa bayaran saya gagal?