Cara Integrasi Payment Gateway Midtrans - Panduan Lengkap

🎯 Apa itu Midtrans?

Midtrans adalah payment gateway terbesar di Indonesia yang memungkinkan toko online Anda menerima berbagai metode pembayaran digital secara otomatis.

💡 Metode Pembayaran yang Tersedia:

💳 Kartu Kredit/Debit:

Visa, Mastercard, JCB
Installment (cicilan 0%)

📱 E-Wallet:

GoPay, OVO, Dana, LinkAja
ShopeePay

🏦 Virtual Account:

BCA, BNI, BRI, Mandiri
Permata, CIMB Niaga, dll

🏪 Retail:

Alfamart, Indomaret
Direct Debit

💰 Biaya Midtrans (MDR - Merchant Discount Rate):

Kartu Kredit: 2.9% per transaksi
Virtual Account: Rp 4.000 per transaksi
E-Wallet: 2% per transaksi
QRIS: 0.7% per transaksi

*Biaya bisa berubah, cek website Midtrans untuk info terbaru

📋 Persiapan & Requirements

Sebelum integrasi, pastikan Anda sudah punya:

✅ WooCommerce Terinstall & Aktif

Website sudah running dengan WooCommerce

✅ SSL Certificate Aktif (HTTPS)

Wajib untuk keamanan transaksi payment

✅ Dokumen Bisnis

Untuk aktivasi production mode:

• NIK (untuk perorangan)
• NPWP (untuk perusahaan)
• Foto KTP
• Rekening bank aktif

📝 Registrasi Akun Midtrans

Buka website Midtrans
🔗 midtrans.com → Klik "Daftar Gratis"
Isi Form Registrasi
- Nama lengkap
- Email bisnis (aktif)
- Nomor HP
- Nama toko/bisnis
- Website URL
Verifikasi Email
Cek inbox dan klik link verifikasi
Login ke Dashboard Midtrans
🔗 dashboard.midtrans.com

💡 Tips: Akun baru otomatis dalam Sandbox Mode (testing). Untuk production, perlu submit dokumen dan approval dari Midtrans.

🔌 Install Plugin WooCommerce

Cara Install:

Login WordPress Dashboard
Plugins → Add New
Search "Midtrans WooCommerce"
Plugin official: Midtrans - WooCommerce Payment Gateway
Install Now → Activate
Cek Settings
WooCommerce → Settings → Payments → Midtrans

⚙️ Konfigurasi & Setup API

Step 1: Dapatkan API Keys dari Midtrans

Login ke Dashboard Midtrans
Settings → Access Keys
Copy kedua keys:
- Sandbox Server Key (untuk testing)
- Sandbox Client Key

Step 2: Konfigurasi Plugin WooCommerce

WooCommerce → Settings → Payments → Midtrans → Manage

Basic Settings:

Enable Midtrans:

✅ Centang checkbox

Title:

Isi: "Pembayaran Online" atau "Kartu Kredit / E-Wallet"

Description:

Isi: "Bayar dengan kartu kredit, GoPay, OVO, virtual account, dll"

Environment:

Pilih: Sandbox (untuk testing dulu)

Server Key (Sandbox):

Paste Server Key dari Midtrans Dashboard

Client Key (Sandbox):

Paste Client Key dari Midtrans Dashboard

Step 3: Konfigurasi Payment Methods

Pilih metode payment yang ingin diaktifkan:

✅ Credit/Debit Card
✅ GoPay
✅ ShopeePay
✅ Bank Transfer (Virtual Account)
✅ Installment (Cicilan)
✅ Alfamart/Indomaret

✅ Configuration Complete! Klik "Save Changes"

🧪 Testing Payment (Sandbox Mode)

Sebelum go-live, WAJIB test payment untuk memastikan semua berfungsi dengan baik.

Cara Testing:

Buka website toko Anda
Sebagai customer biasa (bisa incognito mode)
Add produk ke cart → Checkout
Pilih payment method Midtrans
Seharusnya ada opsi "Pembayaran Online" atau sesuai title yang Anda set
Place Order
Akan redirect ke Midtrans payment page
Pilih metode payment & test

🔑 Test Card Numbers (Sandbox):

✅ Success Payment:

4811 1111 1111 1114

❌ Failed Payment:

4911 1111 1111 1113

Other info:

• CVV: 123
• Exp Date: 01/30 (apapun yang masih valid)

✅ Checklist Testing:

✅ Redirect ke Midtrans payment page berhasil
✅ Payment sukses → order status berubah "Processing"
✅ Customer dapat email konfirmasi order
✅ Admin dapat notifikasi order baru
✅ Test minimal 3 metode payment berbeda

🚀 Aktivasi Production Mode

Setelah testing sukses, saatnya switch ke production mode untuk accept payment real!

Step 1: Request Production Access di Midtrans

Login Dashboard Midtrans
Settings → Account → Activate Production
Submit dokumen yang diminta:
- • Foto KTP/Passport
- • NPWP (jika ada)
- • Rekening bank untuk settlement
- • Screenshot website
Tunggu approval (biasanya 1-3 hari kerja)

Step 2: Ganti API Keys ke Production

Setelah approved, kembali ke Settings → Access Keys
Copy Production Server Key & Production Client Key
Kembali ke WordPress → WooCommerce → Settings → Payments → Midtrans
Ganti Environment ke Production
Paste Production Keys (ganti yang Sandbox)
Save Changes

⚠️ Perhatian Penting:

✅ Test sekali lagi dengan kartu kredit real (nominal kecil)
✅ Pastikan email notification berfungsi
✅ Cek order masuk ke dashboard
⚠️ Setelah production, setiap transaksi akan REAL dan kena fee!

🎉 Congratulations! Toko online Anda sekarang sudah bisa accept payment online! 🚀

🔧 Troubleshooting

Masalah: Payment page tidak muncul

Penyebab: API Keys salah atau SSL tidak aktif

Solusi: Cek kembali Server Key & Client Key, pastikan HTTPS aktif di website

Masalah: Order status tidak update setelah payment

Penyebab: Webhook notification tidak terkirim

Solusi: Cek Settings Midtrans → Webhooks, pastikan Notification URL sudah benar: https://yoursite.com/?wc-api=WC_Gateway_Midtrans

Masalah: Customer redirect ke 404 after payment

Penyebab: Finish URL setting salah

Solusi: Set Finish URL di Midtrans Dashboard ke: https://yoursite.com/checkout/order-received/

❓ FAQ

Berapa lama dana masuk ke rekening?

Settlement Midtrans: T+1 (besok kerja) untuk kartu kredit, T+0 (hari yang sama) untuk e-wallet & virtual account.

Apakah ada biaya bulanan?

Tidak ada! Midtrans hanya charge fee per transaksi yang sukses (MDR). Tidak ada setup fee atau monthly fee.

Apakah bisa untuk UMKM/usaha kecil?

Bisa! Midtrans friendly untuk UMKM. Cukup punya NIK/KTP dan rekening bank, tanpa perlu NPWP atau CV/PT.

Bagaimana jika ada chargeback/dispute?

Midtrans akan notifikasi via email. Anda perlu provide bukti transaksi (receipt, bukti kirim) untuk dispute resolution.

📑 Daftar Isi