Pertanyaan yang Sering Diajukan

Selamat datang di bagian FAQ SmilePayz. Di sini Anda akan menemukan jawaban untuk pertanyaan paling umum tentang layanan gateway pembayaran kami.

---

🔧 Manajemen Akun

Bagaimana cara mendapatkan nomor akun produksi?

Pengaturan Akun Produksi

Ikuti langkah-langkah ini untuk mendapatkan nomor akun produksi dari backend merchant.

1. Login ke backend merchant
2. Navigasi ke menu Finance → Balance
3. Beralih antara tabel Payin dan Payout untuk mendapatkan nomor akun yang berbeda
4. Akun Pay-in: Digunakan untuk mengumpulkan dana dari semua transaksi pay-in
5. Struktur Akun: Setiap merchant memiliki dua akun per mata uang (pay-in dan pay-out)
6. Transfer Akun: Anda dapat mentransfer uang antara akun pay-in dan pay-out
   • Lihat Panduan Transfer untuk instruksi detail

---

📋 Parameter API

Apa arti M, C, dan O dalam parameter request?

Simbol	Arti	Deskripsi
M	Mandatory	Parameter wajib untuk semua request
C	Condition	Hanya diperlukan dalam skenario tertentu
O	Optional	Parameter opsional

Apa itu minify(body)?

Minifikasi JSON

minify(requestBody) mengkonversi parameter request ke string JSON dan menghapus line break, spasi, dan karakter escape lainnya.

• Tujuan: Membuat string JSON kompak untuk generasi tanda tangan
• Implementasi: Kami menyediakan demo minify untuk berbagai bahasa pemrograman
• Referensi: Lihat Tools Tanda Tangan untuk contoh implementasi

---

🇧🇷 Metode Pembayaran Brasil

Apa itu PIX?

Sistem Pembayaran Instan

PIX adalah sistem pembayaran instan Brasil yang diluncurkan oleh Bank Sentral Brasil.

• Tipe: Metode pembayaran instan untuk Brasil
• Fitur:
  • Transfer dana waktu nyata 24/7
  • Penyelesaian pembayaran kode QR
  • Penyelesaian instan
• Ketersediaan: 24 jam sehari, termasuk akhir pekan dan hari libur

Apa itu CPF dan CNPJ?

Tipe Dokumen	Nama Lengkap	Deskripsi	Format
CPF	Cadastro de Pessoas Físicas	ID wajib pajak individu	11 digit
CNPJ	Cadastro Nacional da Pessoa Jurídica	ID wajib pajak perusahaan	14 digit

Referensi:

• CPF Wikipedia
• CNPJ Wikipedia

Format metode pembayaran di Brasil

Metode	Format	Contoh	Deskripsi
PHONE	+55 + 11 digit	+5511999999999	Nomor telepon mobile
CPF	11 digit	12345678909	Identifikasi pribadi
CNPJ	14 digit	12345678000199	Identifikasi perusahaan
EMAIL	Format email	[email protected]	Alamat email

---

🚀 Migrasi Lingkungan

Bagaimana cara bermigrasi dari sandbox ke produksi?

Prasyarat Migrasi

Pastikan integrasi sandbox Anda selesai dan callback berfungsi normal sebelum bermigrasi ke produksi.

Langkah Migrasi:

1. Perbarui Domain

   - https://sandbox-gateway.smilepayz.com
   + https://gateway.smilepayz.com
   

2. Perbarui Kredensial

   • Beralih merchant ID dari sandbox ke produksi
   • Beralih MerchantSecret dari sandbox ke produksi

3. Konfigurasi Keamanan

   • Konfigurasi ulang kunci RSA untuk produksi
   • Tambahkan IP server produksi ke allowlist

Praktik Terbaik

Uji secara menyeluruh di sandbox sebelum bermigrasi ke produksi untuk memastikan transisi yang lancar.

---

🛒 Pengembangan Halaman Checkout

Bagaimana cara membuat halaman checkout sendiri?

Implementasi Checkout Kustom

Buat pengalaman checkout yang dipersonalisasi sambil menggunakan pemrosesan pembayaran SmilePayz.

Langkah Implementasi:

1. Tujuan: Halaman checkout untuk transaksi pay-in
2. Abaikan URL Pembayaran: Jangan gunakan URL pembayaran yang dikembalikan oleh API
3. Ekstrak Data: Dapatkan qrString atau Va number dari respons API
4. Buat Antarmuka: Buat desain halaman checkout sendiri
5. Tampilkan Info Pembayaran: Tampilkan kode QR atau nomor VA dengan instruksi pembayaran
6. Selesai: Checkout kustom Anda siap!

---

🇮🇩 Kasus Khusus Indonesia

Penanganan khusus untuk VA Mandiri di Indonesia

Pemrosesan VA Mandiri

VA Mandiri memerlukan pemrosesan khusus untuk menghindari kegagalan pembayaran.

Implementasi Mode API

Jika Anda memilih mode API dan langsung mendapatkan VA untuk halaman checkout Anda, harap perhatikan:

Format VA Asli: 146156926294

Metode Pembayaran:

Metode Pembayaran	Format VA	Instruksi
M-Banking Mandiri	146156926294	Pilih Multipayment → "i+Pay atau 70017"
M-Banking Lainnya	88017146156926294	Tambahkan prefix 88017, pilih Transfer Bank → Bank Mandiri (008)

Catatan Penting

Hanya Bank Mandiri yang dapat memproses format VA asli. Bank lain memerlukan prefix 88017.