Tidak semua orang yang membaca ini adalah developer. Dan tidak semua developer perlu pakai API langsung. Artikel ini adalah decision tree ikuti pertanyaannya, dan di akhir Anda akan tahu persis metode integrasi mana yang paling sesuai untuk situasi Anda saat ini.

Tidak perlu membaca semuanya. Cukup ikuti jalur yang sesuai dengan jawaban Anda.

Mulai dari Sini: Pertanyaan 1

Apakah website Anda dibangun di atas WordPress + WooCommerce?

Jika TIDAK (website custom, Laravel, CodeIgniter, Next.js, dll.)

Langsung ke [Jalur A: Integrasi API] di bawah. Plugin WooCommerce tidak akan bekerja di luar ekosistem WordPress.

Jika YA (WordPress + WooCommerce)

Lanjut ke Pertanyaan 2.

Pertanyaan 2 (untuk pengguna WordPress + WooCommerce)

Apakah Anda atau tim Anda bisa menginstal plugin WordPress dan mengikuti panduan setup tanpa bantuan developer?

Jika YA

Lanjut ke Pertanyaan 3.

Jika TIDAK (tidak familiar dengan WordPress admin, tidak ada tim teknis)

→ Rekomendasi: Plugin WooCommerce + minta bantuan setup sekali

Cara termudah untuk Anda: install plugin iPaymu untuk WooCommerce, minta developer atau freelancer WordPress untuk setup sekali saja, dan setelah itu Anda bisa mengelola sendiri dari dashboard WooCommerce tanpa perlu sentuh kode apapun.

Biaya setup satu kali jauh lebih murah dan lebih cepat dari integrasi API penuh.

Pertanyaan 3 (untuk yang bisa install plugin sendiri)

Apakah Anda butuh kustomisasi alur pembayaran yang tidak tersedia di plugin standar?

Contoh kustomisasi yang biasanya butuh API langsung:

• Alur checkout multi-step yang dirancang sendiri di luar WooCommerce standard
• Integrasi dengan sistem ERP, CRM, atau inventory yang tidak kompatibel dengan plugin
• Logika pembayaran khusus (split otomatis ke beberapa pihak, aturan diskon yang kompleks)
• Kebutuhan mencatat data transaksi ke database internal yang terpisah dari WooCommerce

Jika TIDAK butuh kustomisasi khusus

→ Rekomendasi: Plugin WooCommerce

Ini pilihan terbaik untuk Anda. Setup bisa selesai dalam 30 menit, tidak perlu menulis kode, dan semua metode pembayaran iPaymu sudah tersedia langsung setelah aktivasi. Update plugin juga bisa dilakukan dari dashboard WordPress seperti plugin lainnya.

Jika YA butuh kustomisasi khusus

Lanjut ke Pertanyaan 4.

Pertanyaan 4 (untuk yang butuh kustomisasi)

Apakah Anda atau tim memiliki developer yang familiar dengan REST API dan bisa mengalokasikan waktu untuk integrasi?

Jika TIDAK (tidak ada developer in-house atau budget untuk development)

→ Rekomendasi: Plugin WooCommerce dulu, API belakangan

Mulai dengan plugin untuk bisa beroperasi secepatnya. Catat kebutuhan kustomisasi yang benar-benar kritis, dan rencanakan integrasi API sebagai fase berikutnya ketika sudah ada kapasitas teknis yang memadai. Jangan blokir operasional bisnis hanya karena menunggu integrasi yang “ideal.”

Jika YA (ada developer yang siap)

→ Rekomendasi: Integrasi API

Lanjut ke [Jalur A: Integrasi API] untuk memahami apa yang perlu disiapkan.

Jalur A: Integrasi API — Untuk Siapa dan Apa yang Perlu Disiapkan

Integrasi API memberikan fleksibilitas penuh atas cara payment gateway bekerja di dalam sistem Anda. Anda tidak terikat pada struktur yang sudah ditentukan plugin — semua alur, tampilan, dan logika bisa dirancang sesuai kebutuhan spesifik bisnis.

Cocok untuk:

• Website atau aplikasi custom di luar ekosistem WordPress
• Bisnis dengan kebutuhan integrasi ke sistem internal yang kompleks
• Platform dengan volume transaksi tinggi yang membutuhkan optimasi performa spesifik
• Tim yang punya developer berpengalaman dan waktu untuk integrasi

Yang perlu disiapkan sebelum mulai:

API Key dan Credentials. Dapatkan API key dari dashboard iPaymu setelah akun merchant aktif. Ini adalah kunci akses yang menghubungkan sistem Anda ke ekosistem pembayaran iPaymu.

Dokumentasi API. iPaymu menyediakan dokumentasi lengkap yang mencakup semua endpoint, parameter yang dibutuhkan, format request dan response, serta contoh kode dalam beberapa bahasa pemrograman. Developer perlu membaca ini sebelum mulai coding.

Environment Testing. Selalu mulai di sandbox environment sebelum live. iPaymu menyediakan sandbox untuk developer menguji semua skenario transaksi — sukses, gagal, pending — tanpa uang nyata yang bergerak.

Webhook Setup. Konfigurasikan webhook untuk menerima notifikasi status pembayaran secara real-time. Ini penting agar sistem Anda tahu kapan pembayaran berhasil tanpa harus polling API terus-menerus.

Estimasi waktu integrasi: 3–14 hari kerja tergantung kompleksitas dan pengalaman developer.

Jalur B: Plugin WooCommerce — Setup dalam 30 Menit

Untuk yang memilih jalur ini, berikut langkah-langkahnya:

1. Install Plugin Masuk ke dashboard WordPress → Plugins → Add New → cari “iPaymu” → Install → Activate.
2. Masuk ke Pengaturan Plugin WooCommerce → Settings → Payments → iPaymu → Manage.
3. Masukkan Kredensial Isi API Key dan VA dari dashboard merchant iPaymu. Jika belum punya akun, daftar dulu di ipaymu.com.
4. Pilih Metode Pembayaran Aktifkan channel pembayaran yang ingin ditampilkan di checkout: QRIS, Virtual Account, e-wallet, Convenience Store, atau semua sekaligus.
5. Simpan dan Uji Coba Buat pesanan test dari halaman produk dan pastikan semua metode pembayaran muncul dan berfungsi sebelum toko dibuka untuk publik.

Estimasi waktu setup: 20–30 menit.

Satu Hal yang Sering Ditanyakan: Bisakah Pakai Keduanya?

Secara teknis, tidak perlu. Pilih salah satu berdasarkan kebutuhan.

Namun ada skenario di mana bisnis menggunakan plugin untuk toko WooCommerce utama, sekaligus integrasi API untuk sistem internal atau aplikasi mobile yang terpisah. Keduanya menggunakan akun merchant iPaymu yang sama jadi laporan transaksi tetap terpusat di satu dashboard.

Mulai dari Mana Pun, Langkah Pertamanya Sama

Baik integrasi API maupun plugin WooCommerce, keduanya dimulai dari satu langkah yang sama: daftar sebagai merchant iPaymu dan dapatkan API key dari dashboard.

Setelah akun aktif, Anda bisa memilih jalur yang paling sesuai dan mulai integrasi kapan saja. Daftar sebagai merchant iPaymu sekarang dan pasang payment gateway di website Anda hari ini.