Panduan Integrasi Payment Gateway untuk Developer

Integrasi payment gateway sebenarnya sederhana: buat order → tampilkan QR → terima callback. Panduan ini merangkum langkahnya.

1. Autentikasi & signature

Setiap permintaan ditandatangani dengan secret_key Anda. Urutkan parameter (kecuali sign), tambahkan kunci, lalu hash. Jangan pernah simpan secret_key di kode front-end.

2. Buat order

curl -s -X POST https://idragonpay.com/pay/api/create.php \
  -d "merchant_id=MCH-xxxx" -d "merchant_no=INV-2001" \
  -d "amount=25000" -d "channel=QRIS" -d "sign=SIGN_ANDA"

3. Uji di sandbox dulu

Tambahkan sandbox=1 untuk memastikan signature dan parsing respons benar tanpa uang nyata. Respons akan memuat "sandbox": true.

4. Terima callback (penting!)

• Balas HTTP 200 secepatnya; proses berat jalankan di belakang.
• Buat penanganan idempotent — callback bisa dikirim ulang.
• Verifikasi ulang status order lewat API query sebagai pengaman.

5. Checklist sebelum go-live

• Sandbox lolos, signature benar
• Callback tervalidasi & tahan kirim-ulang
• Logging aktif untuk audit
• Whitelist IP server Anda (opsional, lebih aman)

Pertanyaan Umum