Panduan iPaymu Payment Gateway

Pelajari cara mengintegrasikan payment gateway iPaymu dengan Yualan POS. Terima pembayaran dari berbagai metode dengan mudah dan aman.

Daftar iPaymu

🎯 Mengapa Menggunakan iPaymu?

iPaymu adalah payment gateway terpercaya di Indonesia yang mendukung berbagai metode pembayaran seperti Virtual Account, E-Wallet, QRIS, dan Kartu Kredit. Integrasi dengan Yualan POS memungkinkan bisnis Anda menerima pembayaran digital dengan mudah.

1. 🔐 Daftar Akun iPaymu

Langkah pertama adalah mendaftar akun iPaymu untuk mendapatkan akses ke dashboard merchant.

📝 Panduan Pendaftaran:

Production: Kunjungi https://my.ipaymu.com untuk akun live yang akan digunakan untuk transaksi sesungguhnya.

Testing/Sandbox: Kunjungi https://sandbox.ipaymu.com untuk akun testing yang digunakan untuk percobaan integrasi.

Verifikasi Data: Lengkapi data bisnis dan dokumen yang diperlukan untuk proses verifikasi akun merchant.

Disarankan untuk membuat akun sandbox terlebih dahulu untuk testing sebelum menggunakan akun production.

2. 🌐 Daftarkan Domain Yualan POS

Daftarkan domain aplikasi Anda ke iPaymu untuk keamanan dan whitelist akses API.

📝 Panduan Pendaftaran Domain:

Akses URL: Kunjungi https://my.ipaymu.com/domain atau https://sandbox.ipaymu.com/domain untuk testing.

Domain Aplikasi: Daftarkan domain https://hosted.yualan.web.id sebagai domain yang diizinkan mengakses API iPaymu.

Proses Verifikasi: Tunggu tim iPaymu melakukan verifikasi domain. Proses ini biasanya membutuhkan waktu 1-2 hari kerja.

Syarat Domain: Pastikan domain aktif dan memiliki halaman Terms of Service, FAQ, dan Refund Policy.

3. 🖥️ Daftarkan IP Address Yualan POS

Whitelist IP address server aplikasi Anda untuk keamanan tambahan dalam akses API.

📝 Panduan Pendaftaran IP Address:

Akses URL: Kunjungi https://my.ipaymu.com/ip atau https://sandbox.ipaymu.com/ip untuk testing.

IP Address Server: Daftarkan IP address 103.123.19.29 sebagai IP yang diizinkan mengakses API iPaymu.

Proses Verifikasi: Tunggu tim iPaymu melakukan verifikasi IP address. Proses ini biasanya lebih cepat dari verifikasi domain.

Whitelist IP address membantu meningkatkan keamanan transaksi dan mencegah akses tidak sah ke API Anda.

4. 🔑 Dapatkan API Key

Ambil kredensial API Key yang diperlukan untuk integrasi dengan Yualan POS.

📝 Panduan Mendapatkan API Key:

Akses Dashboard: Login ke dashboard iPaymu di https://my.ipaymu.com atau https://sandbox.ipaymu.com untuk testing.

VA ID / Merchant Code: Catat VA ID atau Merchant Code yang akan digunakan sebagai identitas merchant Anda.

API Key: Salin API Key yang berfungsi sebagai secret key untuk autentikasi API requests.

Endpoint URL: Pilih endpoint yang sesuai:

Sandbox: https://sandbox.ipaymu.com/api/
Production: https://my.ipaymu.com/api/

Keamanan: Jangan pernah membagikan API Key kepada pihak lain dan simpan dengan aman.

5. ⚙️ Pasang API Key ke Yualan POS

Konfigurasikan API Key iPaymu di dalam aplikasi Yualan POS untuk mengaktifkan payment gateway.

📝 Panduan Konfigurasi di Yualan POS:

Akses Menu: Buka menu Settings → Tenant Info di dashboard Yualan POS.

iPaymu API Key (VA): Isikan dengan VA ID / Merchant Code yang telah didapatkan dari dashboard iPaymu.

iPaymu Secret Key: Isikan dengan API Key yang telah didapatkan dari dashboard iPaymu.

Mode iPaymu: Pilih mode endpoint yang sesuai:

Sandbox: Untuk testing dan pengembangan
Production: Untuk transaksi live/sesungguhnya

Setelah konfigurasi selesai, lakukan test transaksi untuk memastikan integrasi berjalan dengan baik.

💡 Tips & Best Practices

✅ Yang Harus Dilakukan

Gunakan sandbox untuk testing sebelum production
Simpan API Key dengan aman dan jangan dibagikan
Pastikan halaman legal (ToS, Privacy) tersedia di website
Test berbagai metode pembayaran yang tersedia
Monitor transaksi secara berkala di dashboard
Backup konfigurasi API Key secara berkala

⚠️ Yang Harus Dihindari

Menggunakan API Key production untuk testing
Hardcode API Key di dalam source code
Mengabaikan proses verifikasi domain dan IP
Tidak mengecek status verifikasi akun merchant
Melakukan transaksi tanpa testing terlebih dahulu
Tidak memantau log transaksi error

🎯 Siap Menggunakan iPaymu Payment Gateway?

Ikuti panduan di atas untuk mengintegrasikan iPaymu dengan Yualan POS. Mulai terima pembayaran digital dari berbagai metode dengan mudah dan aman!

Daftar iPaymu