Lewati ke isi

Integrasi SATUSEHAT dan BPJS

Menghubungkan akun payment gateway klinik (QRIS dan Virtual Account)

Diperbarui 2 Nov 2026

Di artikel ini

Klinik menerima pembayaran QRIS dan Virtual Account (VA) pasien lewat akun merchant payment gateway milik klinik sendiri, sehingga dana langsung masuk ke rekening klinik.

Yang disiapkan

  1. Akun merchant payment gateway atas nama klinik (dokumen KYB diurus langsung dengan penyedia payment gateway). Nama penyedia yang didukung tertera di kartu payment gateway pada menu Integrasi → Kredensial; tim Medivana dapat membantu bila ragu.
  2. Dari dashboard payment gateway: API Key, Client ID, Client Secret, dan Account ID akun penerima dana.
  3. IP server Medivana didaftarkan di menu whitelist IP dashboard payment gateway (minta alamat IP ke tim Medivana).

Langkah

  1. Buka Integrasi → Kredensial, pilih kartu payment gateway (VA, QRIS, payment link), lalu Atur.
  2. Isi API Key, Client ID, Client Secret, dan Account ID. Pilih lingkungan sandbox untuk uji coba atau production untuk transaksi nyata.
  3. Opsional: batasi Metode aktif (mis. qris,va_bri,va_mandiri), pilih Mode checkout (native menampilkan QR/nomor VA langsung di Medivana; payment_link membuka halaman pembayaran payment gateway), dan isi Akun COA penerimaan settlement bila dana settlement masuk ke rekening selain 1111 Bank Operasional.
  4. Simpan, lalu tekan Uji koneksi. Hasil berhasil menampilkan daftar metode pembayaran yang aktif di akun merchant.
  5. Salin URL notifikasi transaksi yang tampil di kartu payment gateway dan daftarkan di dashboard payment gateway sebagai URL notifikasi transaksi, kedaluwarsa produk, dan settlement.

Rahasia (API Key, Client Secret) disimpan terenkripsi dan tidak pernah ditampilkan ulang; kosongkan isian bila tidak ingin mengubahnya.

Masalah umum

Gejala / pesan Penyebab Yang perlu dilakukan
Uji koneksi: kredensial ditolak API Key, Client ID, atau Client Secret salah, atau lingkungan sandbox/production tertukar Salin ulang dari dashboard payment gateway sesuai lingkungannya
"IP server Medivana belum didaftarkan" / akses ditolak IP belum di-whitelist Tambahkan IP server Medivana di dashboard payment gateway
Uji koneksi: Account ID tidak ditemukan Account ID bukan milik merchant tersebut Periksa ULID account di dashboard payment gateway
Pembayaran lunas di dashboard payment gateway tetapi tidak berubah di Medivana URL notifikasi belum didaftarkan Daftarkan URL notifikasi; sementara itu Medivana mengecek status otomatis tiap beberapa menit

Read in English