Panduan integrasi bayaran
Bagaimana saya menambah bayaran FPX dan DuitNow pada laman web atau aplikasi?
Oleh Pali (Wan Muhamad Fadzli), pembina produk, Pulau Pinang.
Kali terakhir dikemas kini
Untuk menambah bayaran FPX dan DuitNow, sambungkan laman web atau aplikasi anda kepada gerbang pembayaran Malaysia yang menyokong kaedah tersebut, kemudian bina checkout, pengesahan pelayan dan rekod bayaran. Kadar integrasi bayaran Pali yang diterbitkan ialah RM 450. Caj gerbang, bayaran balik, keperluan settlement, langganan dan perubahan sistem sedia ada diberi harga atau dibayar berasingan.
Bagaimana integrasi bayaran FPX dan DuitNow berfungsi?
Integrasi berada di antara checkout anda, gerbang pembayaran dan sistem yang menyimpan pesanan atau invois. Gerbang mengendalikan kaedah bayaran. Laman web atau aplikasi anda mencipta permintaan bayaran, membawa pelanggan melalui aliran diluluskan dan menunggu keputusan yang disahkan sebelum merekodkan bayaran.
| Bahagian integrasi | Fungsinya | Keputusan yang perlu dibuat |
|---|---|---|
| Checkout | Mengumpul butiran pesanan, invois dan pelanggan yang diperlukan | Medan dan kaedah bayaran yang dilihat pelanggan |
| Gerbang pembayaran | Menyediakan FPX, DuitNow QR atau kaedah lain yang diaktifkan | Penyedia yang sesuai dengan akaun dan operasi anda |
| Rujukan bayaran | Memadankan transaksi gerbang dengan pesanan atau invois | Rekod dalaman yang menjadi sumber utama |
| Pengesahan pelayan | Melaporkan dan mengesahkan keputusan bayaran | Status yang boleh mengemas kini pesanan atau invois |
| Rekod staf | Menunjukkan bayaran berjaya, belum selesai, gagal dan dibayar balik | Pasukan yang menyemak pengecualian dan settlement |
Pelanggan mungkin kembali ke halaman berjaya atau gagal selepas membayar. Secara berasingan, gerbang menghantar kemas kini bayaran kepada pelayan anda. Sistem mengesahkan kemas kini itu, memadankannya dengan rekod betul dan hanya menukar status apabila pengesahan sah.
Aliran bayaran mana yang patut saya tambah dahulu?
Pilih satu aliran dengan jumlah, rujukan dan pemilik yang jelas. Aliran pertama yang praktikal termasuk:
- membayar jumlah pesanan tetap semasa checkout;
- membayar invois melalui pautan bayaran unik;
- mengutip deposit tempahan atau bayaran penuh;
- menandakan pesanan sebagai sudah dibayar selepas pengesahan gerbang;
- menghantar resit atau makluman staf selepas bayaran;
- menunjukkan kepada staf apabila bayaran masih belum selesai atau gagal.
Mulakan dengan bayaran sekali jika ia memenuhi keperluan bisnes. Kaedah bayaran tersimpan, caj berulang, bayaran berpecah dan settlement marketplace mempunyai keperluan akaun, data serta pengecualian berbeza.
Apakah yang perlu ditetapkan sebelum menyambungkan gerbang pembayaran?
Petakan keseluruhan perjalanan bayaran sebelum pembangunan:
- Pilih akaun gerbang yang akan dimiliki oleh bisnes anda.
- Sahkan bahawa akaun menawarkan FPX, DuitNow QR dan kaedah lain yang diperlukan.
- Tetapkan rekod pesanan atau invois yang memiliki setiap rujukan bayaran.
- Senaraikan status yang boleh dihantar oleh gerbang dan perubahan bagi setiap status.
- Tentukan cara bayaran belum selesai, gagal, berganda dan dibayar balik dipaparkan kepada staf.
- Tetapkan mesej pelanggan, resit dan langkah seterusnya untuk setiap keputusan.
- Simpan kelayakan akses ujian dan sebenar di luar repositori kod.
Jika bayaran sebahagian daripada kedai dalam talian, bandingkan panduan kos laman web e-dagang. Untuk binaan sistem lebih luas, baca panduan kos pembangunan aplikasi.
Apakah yang mempengaruhi skop integrasi gerbang pembayaran?
- Platform sedia ada. Plugin yang disokong, checkout hos, laman web khas dan aplikasi mudah alih memerlukan kerja berbeza.
- Aliran bayaran. Pesanan, pautan invois, deposit, bayaran penuh dan caj berulang menggunakan peraturan berbeza.
- Rekod bisnes. Integrasi mesti memadankan setiap transaksi gerbang dengan pesanan, tempahan atau invois betul.
- Status bayaran. Keputusan belum selesai, berjaya, gagal, tamat tempoh, berganda dan dibayar balik perlu dikendalikan dengan jelas.
- Sistem bersambung. Resit, perakaunan, e-invois, inventori dan makluman staf menambah aliran kerja.
- Ujian. Akaun ujian, kelayakan akses sebenar, halaman kembali dan pengesahan pelayan mesti diperiksa sebelum pelancaran.
- Operasi. Staf perlukan proses jelas untuk pengecualian, bayaran balik, carian transaksi dan semakan settlement.
Sambungan teknikal gerbang pembayaran menggunakan RM 450. Caj gerbang dan pihak ketiga lain kekal pada akaun milik anda serta dibayar oleh anda pada kos sebenar jika boleh. Peraturan checkout, migrasi, papan pemuka dan sistem bersambung tambahan diberi harga mengikut skop.
Bagaimana status bayaran dan pemilikan akaun patut diurus?
Pesanan atau invois dalaman anda patut menyimpan rekod bisnes, manakala gerbang menyimpan transaksi bayaran. Simpan rujukan yang diperlukan untuk memadankan kedua-duanya tanpa menganggap halaman kembali dalam pelayar sebagai pengesahan akhir. Staf patut melihat status semasa, rujukan gerbang dan sebarang pengecualian yang perlu disemak.
Pastikan akaun gerbang, butiran settlement dan kelayakan akses sebenar di bawah kawalan bisnes anda. Hadkan akses mengikut peranan, asingkan tetapan ujian dan sebenar, serta buang akses apabila tanggungjawab berubah. Kelayakan akses perlu disimpan dalam tetapan persekitaran terlindung, bukan dalam kod sumber atau halaman awam.
Bagaimana saya merancang integrasi gerbang pembayaran?
- Terangkan perjalanan bayaran pertama dalam kalkulator projek, termasuk checkout, kaedah bayaran, rekod, pengesahan dan pemilik staf.
- Gunakan Sprint Penemuan untuk memeriksa akaun penyedia, dokumentasi API, status bayaran, keselamatan, aliran ujian dan pengecualian sebelum menyetujui skop tetap.
- Uji cubaan berjaya, belum selesai, gagal dan berganda sebelum pelancaran, kemudian pantau transaksi sebenar pertama serta serahan kepada staf.
Lihat cara pembangunan aplikasi skop tetap berjalan sebelum menyambungkan bayaran FPX dan DuitNow kepada laman web atau aplikasi anda.

