๐ณ Pengaturan Pembayaran
Pengaturan pembayaran memungkinkan Anda mengkonfigurasi gateway pembayaran yang didukung oleh aplikasi Anda. Pengguna menggunakan gateway ini untuk membeli koin dan diamond dalam aplikasi, yang kemudian mereka gunakan untuk mengirim hadiah, mengakses fitur premium, dan lainnya.
Cara Mengakses
Pengaturan โ Pembayaran
โ๏ธ Buka Pengaturan Pembayaran
Gateway Pembayaran yang Didukung
Sistem mendukung gateway pembayaran berikut. Setiap gateway dapat diaktifkan atau dinonaktifkan secara independen:
1. Stripe
Stripe adalah platform pembayaran global yang mendukung kartu kredit/debit dan berbagai metode pembayaran di sebagian besar negara.
| Kolom | Deskripsi | Wajib |
|---|---|---|
| Secret Test Key | Kunci rahasia Stripe Anda (dimulai dengan sk_test_ untuk pengujian atau sk_live_ untuk produksi) |
โ Ya |
| Success URL | URL tujuan pengalihan pengguna setelah pembayaran berhasil | โ Ya |
| Cancel URL | URL tujuan pengalihan pengguna jika mereka membatalkan pembayaran | โ Ya |
| Currency | Mata uang untuk transaksi (misalnya, usd, eur, sar) |
โ Ya |
| Webhook Secret Key | Kunci rahasia webhook signing dari Stripe (dimulai dengan whsec_) untuk memverifikasi event webhook |
โ Ya |
| Webhook URL | Endpoint server Anda yang menerima event pembayaran Stripe: BASE_URL/api/stripe-callback |
โ Ya |
Cara Mendapatkan Kredensial Stripe
- Kunjungi https://dashboard.stripe.com dan buat akun atau masuk.
- Navigasi ke Developers โ API Keys untuk menemukan Secret Key Anda.
- Navigasi ke Developers โ Webhooks untuk mengatur endpoint webhook Anda dan mendapatkan Webhook Secret Key.
- Gunakan test keys (
sk_test_...) selama pengembangan dan beralih ke live keys (sk_live_...) untuk produksi.
2. Fawry
Fawry adalah gateway pembayaran populer di Mesir dan Timur Tengah, mendukung berbagai metode pembayaran lokal termasuk nomor referensi Fawry, kartu kredit, dan dompet seluler.
| Kolom | Deskripsi | Wajib |
|---|---|---|
| Server Secret | Kunci rahasia server Fawry Anda untuk mengautentikasi permintaan API | โ Ya |
| Merchant Code | Pengenal unik merchant Anda yang disediakan oleh Fawry | โ Ya |
| URL | Endpoint API Fawry untuk memulai pembayaran (misalnya, https://atfawry.fawrypay.com/fawrypay-api/api/payments/init) |
โ Ya |
| Return URL | URL tujuan pengalihan pengguna setelah pembayaran selesai: BASE_URL/api/utd-fawry-callback |
โ Ya |
| Webhook URL | Endpoint server Anda untuk notifikasi pembayaran Fawry: BASE_URL/api/fawry-callback |
โ Ya |
Cara Mendapatkan Kredensial Fawry
- Daftar akun merchant Fawry di https://atfawry.fawrypay.com.
- Setelah disetujui, Anda akan menerima Merchant Code dan Server Secret Anda.
- Gunakan URL staging untuk pengujian dan URL produksi untuk pembayaran langsung.
Mengaktifkan Gateway Pembayaran
- Buka tab Pembayaran di Pengaturan.
- Temukan gateway pembayaran yang ingin Anda aktifkan.
- Alihkan sakelar ke ON (hijau) untuk mengaktifkannya.
- Isi semua kredensial dan URL yang diperlukan untuk gateway tersebut.
- Klik "Save" untuk menerapkan konfigurasi.
Menonaktifkan Gateway Pembayaran
- Alihkan sakelar ke OFF untuk gateway yang ingin Anda nonaktifkan.
- Klik "Save".
Peringatan
Menonaktifkan gateway pembayaran akan segera mencegah pengguna melakukan pembayaran melalui gateway tersebut. Pastikan setidaknya satu gateway tetap aktif.
Pengujian Setelah Konfigurasi
Setelah mengkonfigurasi gateway pembayaran, disarankan untuk:
- Melakukan pembayaran percobaan kecil melalui aplikasi untuk memverifikasi bahwa gateway berfungsi dengan benar.
- Memeriksa bahwa pembayaran muncul di dashboard gateway Anda (Stripe Dashboard atau Fawry Dashboard).
- Memverifikasi bahwa koin/diamond dikreditkan dengan benar ke akun pengguna percobaan.
- Memeriksa bahwa endpoint webhook menerima konfirmasi pembayaran.
Tips
- Selalu gunakan kredensial test/staging selama pengaturan awal, kemudian beralih ke kredensial produksi saat siap untuk meluncurkan.
- Jaga kerahasiaan kunci rahasia dan webhook secret Anda โ jangan pernah membagikannya secara publik.
- Pastikan URL webhook Anda dapat diakses dari internet (tidak di balik firewall atau VPN).
- Pantau dashboard gateway pembayaran Anda secara teratur untuk melacak transaksi dan mendeteksi masalah.