Gateway Pembayaran
Gateway Pembayaran menyimpan kredensial penyedia pembayaran online: PayPal, Stripe, Midtrans, Xendit, dan DOKU. Satu baris per penyedia, lengkap dengan sakelar aktif dan urutan tampilnya di layar pembayaran.
Dipakai Oleh
admin atau pemilik sesuai hak akses menu
Jenis Data
master
Kunci Pencarian
Gateway
Kapan Form Ini Dipakai
- Saat perusahaan mulai menerima pembayaran online dari pelanggan.
- Saat kredensial merchant berganti, misalnya karena rotasi key atau pindah akun.
- Saat berpindah dari mode uji coba ke produksi.
- Saat satu penyedia perlu dimatikan sementara tanpa menghapus kredensialnya.
Sebelum Mengisi
- Siapkan kredensial dari dashboard merchant penyedia. Nama fieldnya berbeda-beda: PayPal memakai Client ID dan Secret, Stripe memakai API Key dan Secret, Midtrans memakai Server Key dan Client Key, Xendit memakai Secret Key, DOKU memakai Client ID dan Secret Key.
- Xendit tidak punya sakelar sandbox. Mode uji coba atau produksi ditentukan oleh prefiks Secret Key-nya sendiri:
xnd_development_untuk uji coba,xnd_production_untuk produksi. - Untuk Xendit dan DOKU, daftarkan dulu URL notifikasi di dashboard penyedia. Tanpa itu pembayaran yang berhasil tidak pernah tercatat lunas, dan pesanan menggantung tanpa satu pun pesan galat.
- Uji dengan kredensial mode sandbox lebih dulu sebelum menyalakan Aktif.
Alur Kerja
- Buka menu Pengaturan / Parameter Bisnis / Gateway Pembayaran.
- Tambah baris, lalu pilih penyedia pada field Gateway Pembayaran.
- Isi kredensialnya. Field yang tampil menyesuaikan penyedia yang dipilih, jadi yang tidak relevan tidak akan mengganggu.
- Isi Urutan bila lebih dari satu penyedia aktif; angka lebih kecil tampil lebih dulu.
- Nyalakan Aktif hanya setelah kredensialnya diuji.
- Simpan, lalu uji dari transaksi yang benar-benar memakai pembayaran online.
Field yang Perlu Diperhatikan
| Field | Penjelasan Untuk Pengguna | Status |
|---|---|---|
Gateway Pembayaran
gatewaykey |
Penyedia pembayaran yang disetel di baris ini. Pilihannya mengikuti penyedia yang terpasang di server. | Wajib |
Aktif
isactive |
Menentukan penyedia ini ditawarkan ke pembeli atau tidak. Mematikannya tidak menghapus kredensial. | Opsional |
Urutan
priority |
Urutan tampil di layar pembayaran ketika lebih dari satu penyedia aktif. Angka lebih kecil tampil lebih dulu. | Opsional |
Dampak Setelah Simpan
- Penyedia yang aktif langsung muncul sebagai pilihan di layar pembayaran online.
- Penyedia yang dimatikan hilang dari pilihan, tetapi kredensialnya tetap tersimpan - menyalakannya kembali tidak perlu mengetik ulang.
- Kredensial di sini tidak pernah ikut dikirim ke browser selain kunci yang memang publik, dan tidak muncul di layar mana pun selain form ini.
- Transaksi yang sudah berjalan dengan penyedia lama tidak terpengaruh; statusnya tetap ditentukan notifikasi dari penyedia itu.
Masalah Umum
- Penyedia tidak muncul di layar pembayaran: periksa sakelar Aktif, lalu pastikan kredensialnya benar-benar terisi.
- Pembayaran berhasil di sisi penyedia tetapi pesanan tetap menggantung: hampir selalu URL notifikasi yang belum didaftarkan atau salah alamat di dashboard penyedia.
- Xendit menolak transaksi: periksa prefiks Secret Key. Kunci produksi di lingkungan uji coba, atau sebaliknya, ditolak tanpa penjelasan yang jelas.
- Logo penyedia tidak tampil: berkas ikonnya belum ada di server. Nama penyedianya tetap terbaca, jadi ini tidak menghalangi pemakaian.
Field Tersedia
Daftar berikut merangkum field yang tersedia di form. Field kredensial hanya tampil untuk penyedia yang sedang dipilih, jadi tidak semuanya terlihat sekaligus.
| Field | Penjelasan Untuk Pengguna | Status |
|---|---|---|
Gateway Pembayaran
gatewaykey |
Penyedia pembayaran yang disetel di baris ini. Pilihannya mengikuti penyedia yang terpasang di server. | Wajib |
Aktif
isactive |
Menentukan penyedia ini ditawarkan ke pembeli atau tidak. Mematikannya tidak menghapus kredensial. | Opsional |
Urutan
priority |
Urutan tampil di layar pembayaran ketika lebih dari satu penyedia aktif. Angka lebih kecil tampil lebih dulu. | Opsional |
PayPal Client ID
paypal__client_id |
Client ID dari dashboard merchant PayPal. | Opsional |
PayPal Secret
paypal__secret |
Secret PayPal. Jangan dibagikan; ia setara kunci akun merchant. | Opsional |
PayPal Sandbox Mode
paypal__sandbox |
Menyalakan mode uji coba PayPal. | Opsional |
Stripe API Key
stripe__api_key |
API key Stripe untuk akun merchant perusahaan. | Opsional |
Stripe Secret
stripe__secret |
Secret key Stripe. Pastikan sesuai dengan mode yang dipilih. | Opsional |
Stripe Sandbox Mode
stripe__sandbox |
Menyalakan mode uji coba Stripe. | Opsional |
Midtrans Server Key
midtrans__server_key |
Server Key Midtrans dari Settings / Access Keys di dashboard merchant. | Opsional |
Midtrans Client Key
midtrans__client_key |
Client Key Midtrans. Kunci ini memang dipakai di sisi browser. | Opsional |
Midtrans Sandbox Mode
midtrans__sandbox |
Menyalakan mode uji coba Midtrans. | Opsional |
Xendit Secret Key
xendit__secret_key |
Secret Key Xendit. Prefiksnya yang menentukan mode uji coba atau produksi, jadi tidak ada sakelar sandbox terpisah. | Opsional |
Xendit Callback Token
xendit__callback_token |
Token verifikasi notifikasi, disalin dari Settings / Webhooks di dashboard Xendit. | Opsional |
DOKU Client ID
doku__client_id |
Client ID dari DOKU Back Office. | Opsional |
DOKU Secret Key
doku__secret_key |
Secret Key DOKU, dipakai menandatangani setiap permintaan. | Opsional |
DOKU Sandbox Mode
doku__sandbox |
Menyalakan mode uji coba DOKU. | Opsional |
Checklist Pengguna
Lokasi Menu
- Pengaturan / Parameter Bisnis / Gateway Pembayaran
/form/paymentgateway