Bayaran dalam talian dengan CHIP

CHIP ialah gerbang pembayaran Malaysia. Selepas akaun CHIP disambungkan dengan Invoa, laman pelanggan bagi setiap invois yang belum dibayar memaparkan Pay online. Pelanggan membayar melalui FPX, kad, e-dompet atau DuitNow QR. Wang disalurkan ke akaun CHIP syarikat, kemudian ke akaun bank. Invoa tidak memegang wang tersebut. Apabila bayaran berjaya, Invoa merekodkannya, menandakan invois sebagai telah dibayar dan menghantar resit melalui e-mel.

Panduan ini menggunakan label antara muka bahasa Inggeris. Untuk memadankan label dengan panduan, pilih bahasa Inggeris sebagai bahasa antara muka dalam Settings → Account.

#Keperluan sebelum bermula

• Akaun pedagang CHIP. Jika belum mempunyai akaun, klik Open a CHIP account dalam Settings → Payments (CHIP). CHIP mengesahkan perniagaan sebelum bayaran sebenar boleh diterima.
• Akses pemilik atau pentadbir dalam Invoa. Peranan lain boleh melihat laman tetapi tidak boleh mengubah tetapan.

#1. Kunci daripada CHIP

Dalam portal pedagang CHIP:

1. Semasa persediaan, aktifkan Test mode di bahagian atas portal. Kunci ujian hanya menghasilkan bayaran ujian. Tiada wang sebenar dipindahkan.
2. Buka Developers → API keys, wujudkan kunci dan salin Secret key.
3. Buka Developers → Brands dan salin Brand ID bagi jenama yang hendak dipaparkan kepada pelanggan semasa bayaran.

#2. Penyambungan CHIP dalam Invoa

1. Buka Settings → Payments (CHIP).
2. Tandakan Use our own CHIP account.
3. Tampal Brand ID dan Secret key.
4. Jika menggunakan kunci ujian, tandakan These are CHIP test-mode keys (no real money moves).
5. Biarkan Webhook public key (PEM) kosong buat sementara.
6. Klik Save.

Kunci rahsia disulitkan semasa disimpan dan tidak dipaparkan semula. Medan kemudian memaparkan "Stored … — enter a new key to replace it". Untuk menggantikan kunci, tampal kunci baharu dan simpan.

#3. Penambahan webhook Invoa dalam CHIP

Webhook membolehkan CHIP memaklumkan kejayaan bayaran kepada Invoa walaupun pelanggan menutup laman sebelum kembali.

1. Dalam Invoa, salin alamat di bawah Webhook URL to paste into CHIP.
2. Dalam portal CHIP, buka Developers → Webhooks → Add webhook.
3. Berikan tajuk Invoa. Tampal alamat sebagai URL panggil balik dan tandakan peristiwa purchase.paid. purchase.payment_failure dan payment.refunded juga boleh ditandakan.
4. Simpan webhook dalam CHIP dan salin kunci awamnya, iaitu teks yang bermula dengan -----BEGIN PUBLIC KEY-----.
5. Kembali ke Invoa. Tampal kunci dalam Webhook public key (PEM) dan klik Save.

#Semakan semasa penyimpanan

Setiap kali tetapan disimpan, Invoa menyemak kunci rahsia dengan CHIP. Keputusan dipaparkan di bahagian atas laman:

Lencana di penjuru kanan atas menunjukkan akaun yang menerima bayaran. Your CHIP account bermaksud akaun telah disambungkan. Online payments off bermaksud pelanggan hanya melihat butiran bank.

#Pengaktifan bayaran sebenar

Selepas bayaran ujian berjaya melalui keseluruhan proses:

1. Dalam portal CHIP, matikan Test mode dan wujudkan kunci rahsia sebenar. Kunci sebenar berasingan daripada kunci ujian.
2. Dalam Invoa, tampal kunci sebenar dalam Secret key. Buang tanda mod ujian dan klik Save.
3. Baca mesej di bahagian atas laman. Jika mesej menyatakan webhook CHIP tiada, tambah semula seperti dalam langkah 3.

#Kaedah bayaran

Di bawah Default payment methods, tandakan kaedah yang hendak ditawarkan pada invois:

Jika semua tanda dibuang, kelima-lima kaedah ditawarkan. CHIP hanya memaparkan kaedah yang aktif bagi akaun CHIP tersebut. Kaedah bertanda Not enabled on your CHIP account belum tersedia. Minta CHIP mengaktifkannya atau buang tanda pilihan tersebut.

CHIP mengenakan yuran bagi setiap transaksi mengikut kaedah bayaran. Rujuk harga CHIP di chip-in.asia.

#Penyahaktifan kad bagi invois bernilai tinggi

Yuran kad dikira sebagai peratusan jumlah bayaran. Oleh itu, FPX mungkin lebih sesuai bagi invois bernilai tinggi. Tetapkan jumlah dalam Switch cards off for invoices at or above (RM). Nilai lalai ialah RM 5,000.00. Kad tidak ditawarkan apabila jumlah yang dibayar mencapai atau melebihi nilai tersebut. Masukkan 0 untuk sentiasa membenarkan kad. Jika kad ialah satu-satunya kaedah yang ditawarkan, kad kekal tersedia.

#Paparan pelanggan

1. Pada laman pelanggan bagi invois, pelanggan mengklik Pay online di bawah Amount due.
2. Pelanggan dibawa ke laman bayaran selamat CHIP untuk menjelaskan keseluruhan baki. Pelanggan memilih kaedah dan membayar.
3. CHIP mengembalikan pelanggan ke laman pelanggan yang memaparkan salah satu mesej berikut:
   • "Payment received — thank you. Your receipt is on its way."
   • "Thanks — your payment is being confirmed. This page updates once CHIP notifies us (usually within a minute)."
   • "The payment was not completed. You can try again or pay by bank transfer."

Pay online hanya dipaparkan pada invois dalam ringgit yang masih mempunyai baki dan apabila bayaran dalam talian telah disediakan. Bayaran dalam talian sentiasa meliputi keseluruhan baki. Untuk bayaran sebahagian, pelanggan boleh membuat pindahan bank dan menggunakan I have paid by bank transfer.

#Perekodan bayaran

Apabila CHIP mengesahkan bayaran, Invoa:

1. Merekodkan bayaran dengan kaedah CHIP (online), rujukan yang bermula dengan CHIP dan tarikh pengesahan CHIP.
2. Menandakan invois Paid atau Partially paid.
3. Mengeluarkan resit dan menghantarnya berserta PDF ke e-mel dalam rekod pelanggan.

Jika CHIP menghantar pemberitahuan yang sama dua kali, Invoa hanya merekodkan bayaran sekali. Bayaran disenaraikan dalam Payments → Confirmed payments dengan webhook di sebelah kaedah bayaran.

#Penyelesaian masalah

#Rujukan berkaitan

• Bayaran dan resit
• Hantar melalui e-mel, WhatsApp atau pautan
• Persediaan syarikat
• Hubungi sokongan