Untuk menyambungkan HitPay, pergi ke Tetapan › Integrasi dalam Konsol EasyBiz, klik Sambung pada HitPay, buka baris negara anda dalam tetingkap Akaun HitPay, dan tampal kunci API HitPay dan garam webhook anda. Kemudian hidupkan kaedah HitPay untuk kaunter dan Kedai Dalam Talian anda.

Apa Yang Anda Perlukan Sebelum Mula

  • Satu akaun HitPay untuk setiap negara yang anda jual (arahan di bawah). Contohnya, perniagaan dengan cawangan di Singapura dan Malaysia menyambungkan satu akaun HitPay Singapura dan satu akaun HitPay Malaysia.

  • Akses ke Konsol EasyBiz anda


Langkah 1 — Buat Akaun HitPay

Jika anda sudah ada akaun HitPay, langkau ke Langkah 2.

  1. Pergi ke HitPay dan klik Daftar / Mula secara percuma
  1. Masukkan alamat e-mel anda dan buat kata laluan

  2. Semak e-mel anda untuk kod pengesahan dan masukkan kod tersebut

  3. Isi butiran perniagaan anda — pilih kategori yang paling sesuai dengan perniagaan anda (contohnya Runcit, Dobi, atau guna Lain-lain jika tiada yang sesuai betul-betul)

  4. Lengkapkan langkah pendaftaran sehingga anda sampai ke papan pemuka HitPay anda


Langkah 2 — Buka Akaun HitPay Anda dalam EasyBiz

Mulakan dalam EasyBiz supaya tetingkap HitPay sudah terbuka. Anda akan menyalin nilai ke dalamnya daripada HitPay dalam dua langkah seterusnya.

  1. Dalam Konsol EasyBiz anda, klik Tetapan. Di bawah Pentadbiran, klik Integrasi

  2. Cari HitPay dalam senarai dan klik Sambung

  3. Tetingkap bertajuk Akaun HitPay dibuka. Ia mempunyai satu baris untuk setiap negara yang anda jual, seperti Singapura. Negara yang belum anda sambungkan tertulis Belum disambung

  4. Jika anda jual di lebih daripada satu negara, klik baris negara yang sedang anda sambungkan. Jika anda hanya jual di satu negara, barisnya sudah terbuka

  5. Baris itu menunjukkan medan Kunci API, kotak Persediaan Webhook dengan URL webhook anda, dan medan Garam Webhook

  6. Dalam kotak Persediaan Webhook, klik Salin di sebelah URL webhook. Anda akan menampalnya ke dalam HitPay dalam Langkah 4

Biarkan tetingkap ini terbuka semasa anda melalui Langkah 3 dan 4 dalam papan pemuka HitPay anda.


Langkah 3 — Dapatkan Kunci API HitPay Anda

Kunci API ialah apa yang membolehkan EasyBiz berkomunikasi dengan selamat dengan akaun HitPay anda.

  1. Dalam papan pemuka HitPay anda, klik Pembangun di menu sebelah kiri

  2. Klik tab Kunci API

  3. Klik Salin di sebelah kunci API anda

  4. Kembali ke tetingkap EasyBiz dan tampalkan ke dalam medan Kunci API. Di bawah medan, EasyBiz memberitahu anda sama ada ia kunci langsung atau kunci sandbox (test_). Guna webhook dan Garam daripada persekitaran HitPay yang sama dengan kunci tersebut


Langkah 4 — Sediakan Webhook dalam HitPay

Webhook ialah cara HitPay memberitahu EasyBiz apabila bayaran selesai atau gagal. Anda perlu menyediakannya supaya EasyBiz tahu bila pelanggan sudah membayar.

  1. Dalam papan pemuka HitPay anda, klik Pembangun → tab Titik Akhir Webhook

  2. Klik + Webhook Baru

  3. Isi maklumat berikut:

  • Nama Webhook — masukkan apa-apa nama, contohnya: EasyBiz

  • URL Webhook — tampal URL webhook yang anda salin daripada tetingkap EasyBiz dalam Langkah 2

  • Di bawah Permintaan Bayaran, tandakan kedua-dua Selesai dan Gagal

  1. Klik Simpan

  2. Webhook baru anda kini muncul dalam senarai dengan nilai Garam di sebelahnya. Salin Garam ini


Langkah 5 — Simpan Sambungan dalam EasyBiz

Kembali ke tetingkap EasyBiz yang anda biarkan terbuka dalam Langkah 2. Jika anda sudah menutupnya, pergi semula ke Tetapan → Integrasi, klik Sambung pada HitPay (tulisannya Urus apabila negara lain sudah disambungkan), dan klik baris negara anda.

  1. Semak medan Kunci API mengandungi kunci yang anda salin dalam Langkah 3

  2. Tampal Garam yang anda salin dalam Langkah 4 ke dalam medan Garam Webhook

  3. Pilihan: guna suis Hantar resit e-mel HitPay kepada pelanggan untuk mengawal sama ada HitPay menghantar resit bayarannya sendiri melalui e-mel kepada pelanggan anda

  4. Klik Simpan


Semuanya Sudah Siap

Apabila anda klik Simpan, akaun HitPay bagi negara itu disambungkan. Barisnya dalam tetingkap Akaun HitPay menunjukkan kunci yang anda simpan dan status webhook, contohnya Kunci langsung · webhook belum disahkan, dengan label Semak webhook. Selepas HitPay menghantar kemas kini bayaran pertamanya ke EasyBiz, baris itu tertulis webhook disahkan dan label bertukar kepada Terima bayaran.

Kad HitPay pada halaman Integrasi menunjukkan status yang sama, seperti Kunci langsung · webhook disahkan. Jika anda menyambungkan lebih daripada satu negara, ia menyenaraikan setiap satu, contohnya Singapura: Kunci langsung · Malaysia: Kunci sandbox. Butang kad itu kini tertulis Urus.

Untuk menyambungkan negara lain kemudian, klik Urus pada kad HitPay, klik baris negara itu, dan ulangi Langkah 3 hingga 5 dengan akaun HitPay negara tersebut. Setiap akaun HitPay mempunyai webhook sendiri, jadi setiap negara mendapat Garam sendiri.

Menyambungkan HitPay tidak menghidupkan mana-mana kaedah secara sendiri. Pilih di mana pelanggan boleh menggunakannya:


Guna HitPay di Kedai Dalam Talian Anda

  1. Pergi ke Tetapan › Saluran Jualan › Kedai Dalam Talian & Aplikasi Mudah Alih.

  2. Pada kad kedai, klik Sunting Kedai Dalam Talian. Butang itu tertulis Sunting Aplikasi Mudah Alih atau Sunting Kedai Dalam Talian & Aplikasi Mudah Alih apabila ia dihidupkan.

  3. Di bawah Halaman, klik Pembayaran.

  4. Di bawah Pihak Ketiga, hidupkan setiap kaedah yang anda mahu pelanggan gunakan, seperti PayNow atau Kad, dan pilih HitPay sebagai pembekalnya. Seret baris ke dalam susunan yang pelanggan patut lihat.

  5. Pratonton kedai anda, kemudian terbitkannya. Lihat Sunting, Pratonton dan Terbitkan Kedai Dalam Talian Anda.

Halaman Pembayaran editor kedai dengan PayNow dan Kad dihidupkan melalui HitPay

Memerlukan kad yang disimpan

Pelanggan boleh menyimpan kad dengan HitPay semasa membuat tempahan. Kad itu dicaj secara automatik apabila pesanan sudah siap. Untuk menjadikan kad yang disimpan sebagai syarat tempahan bagi unit perniagaan, tetapkan baris Pembayaran pada halaman Daftar Keluar editor kedai kepada Kad disimpan diperlukan.

Ini memerlukan akaun HitPay yang boleh menyimpan kad. Jika baris Pembayaran memintanya, klik Semak HitPay. Jika ia kata akaun anda tidak boleh menyimpan kad (GIRO sahaja), pelanggan tidak boleh menambah kad semasa membuat tempahan: minta HitPay hidupkan kad untuk bilingan berulang, kemudian semak semula.

Jika anda kemudian menyimpan kunci API yang berbeza, klik Semak HitPay sekali lagi sebelum anda terbitkan.

HitPay menyimpan setiap kad di bawah e-mel pelanggan. Pelanggan yang tiada e-mel pada akaunnya akan melihat mesej "Tambah e-mel anda dalam Butiran hubungan untuk menyimpan kad."

Untuk persediaan pembayaran Kedai Dalam Talian yang lengkap, lihat Menerima Bayaran di Kedai Dalam Talian Anda.


Jika Ia Tidak Berfungsi

Bayaran telah dibuat, tetapi pesanan dalam EasyBiz tidak menunjukkannya sebagai sudah dibayar.

Ini hampir selalu bermakna HitPay tidak dapat memberitahu EasyBiz. Semak tiga perkara:

  1. URL webhook betul. Dalam papan pemuka HitPay anda, pergi ke Pembangun → Titik Akhir Webhook dan bandingkan URL itu huruf demi huruf dengan yang ditunjukkan dalam kotak Persediaan Webhook EasyBiz. Guna butang Salin di kedua-dua belah — jangan taip semula.

  2. Kedua-dua peristiwa ditandakan. Webhook mesti mempunyai Selesai dan Gagal ditandakan di bawah Permintaan Bayaran.

  3. Garam sepadan. Jika anda mencipta lebih daripada satu webhook, setiap satu mempunyai Garamnya sendiri. Salin Garam daripada webhook tepat yang membawa URL EasyBiz, tampalkannya ke dalam medan Garam Webhook bagi baris negara yang betul dalam EasyBiz, dan klik Simpan semula.

Kad HitPay atau baris sesebuah negara menulis "tandatangan webhook gagal".

Garam yang disimpan dalam EasyBiz tidak sepadan dengan webhook yang dipanggil HitPay. Salin semula Garam daripada persekitaran HitPay yang sama dengan Kunci API anda (langsung atau sandbox), tampalkannya ke dalam Garam Webhook, dan klik Simpan. Selagi Garam tidak sepadan, bayaran PayNow masih selesai, tetapi 15 hingga 35 minit kemudian.

EasyBiz menunjukkan ralat apabila menerima bayaran HitPay.

Buka Tetapan → Integrasi, klik Urus pada kad HitPay, klik baris negara anda dan tampal semula kunci API daripada halaman Pembangun → Kunci API HitPay. Kunci yang terpotong atau mempunyai ruang tambahan di depan atau belakang akan gagal. Jika anda menjana semula kunci API dalam HitPay, kunci lama yang disimpan dalam EasyBiz tidak lagi berfungsi — tampal yang baharu dan simpan.

Masih tersekat?

Dalam papan pemuka HitPay anda, semak status penghantaran webhook pada halaman Titik Akhir Webhook — jika HitPay menunjukkan penghantaran gagal, padam webhook, buat semula dengan URL EasyBiz yang disalin, dan kemas kini Garam baharu dalam EasyBiz. Jika bayaran masih tidak disahkan, hubungi sokongan EasyBiz dengan nombor pesanan anda dan anggaran masa bayaran.


Apa Seterusnya?

Sekarang HitPay sudah disambungkan, anda boleh mula menerima bayaran di kaunter dan di Kedai Dalam Talian anda. Untuk menjadikan HitPay tersedia sebagai kaedah pembayaran di kaunter anda, lihat Menyediakan Kaedah Pembayaran Anda di POS. Untuk mengetahui cara pelanggan membayar melalui HitPay, lihat Gambaran Keseluruhan HitPay.