Payment Gateway

Tanya Jawab Umum

Temukan jawaban atas pertanyaan umum seputar layanan kami di halaman ini.

Integrasi
❓Berapa lama waktu yang dibutuhkan mulai dari proses kerja sama hingga bisa go-live transaksi?
Rata-rata, proses kerja sama dan aktivasi hingga go-live memerlukan waktu sekitar 7 hari kerja, tergantung kelengkapan dokumen dan kesiapan integrasi dari pihak merchant.
❓Apa saja yang perlu saya siapkan sebelum memulai integrasi?
Sebelum memulai integrasi, pastikan Anda sudah:
  • Mengetahui metode integrasi yang akan digunakan.
  • Mendapatkan kredensial untuk development seperti merchant code, merchant name, API Key, signature, dan password.
  • Mendapatkan akses ke Portal Sandbox untuk monitoring dan simulasi.
  • Mengakses dokumentasi teknis sesuai dengan metode integrasi yang digunakan.
  • Menyediakan URL callback yang dapat diakses publik melalui jaringan internet.
❓Apa itu callback endpoint?
Callback endpoint merupakan URL API yang harus Anda sediakan agar Espay dapat:
  • Melakukan permintaan inquiry ke sistem Anda untuk mendapatkan detail transaksi.
  • Mengirimkan notifikasi pembayaran saat status transaksi berubah.
Agar transaksi berjalan lancar, pastikan endpoint Anda:
  • Dapat menerima permintan HTTPS dengan metode POST, atau GET/DELETE sesuai layanan yang digunakan.
  • Dapat mengembalikan respons sesuai dengan format yang ditentukan dalam dokumentasi teknis.
  • Dapat diakses secara online, stabil, dan publik.
Lihat detail layanan:
❓Bagaimana cara memastikan integrasi saya berfungsi dengan benar?
Pastikan Anda sudah mengikuti langkah berikut:
  • Mengikuti dokumentasi teknis yang disediakan secara lengkap dan sesuai.
  • Lakukan end-to-end testing untuk memastikan seluruh alur berjalan keseluruhan.
  • Gunakan Portal Sandbox Espay untuk simulasi pembayaran.
  • Pastikan setiap transaksi tercatat di log sistem Anda untuk keperluan pelacakan.
❓Apa yang harus saya lakukan setelah proses integrasi selesai?
Setelah integrasi selesai, Anda harus melalui dua langkah terakhir sebelum go-live:
  • Melakukan UAT (User Acceptance Test) Espay
    Pengujian berdasarkan skenario yang sudah ditentukan oleh tim Espay.
  • Melengkapi Dokumen SNAP BI (Standar Nasional Open API Pembayaran – Bank Indonesia)
    Ada 3 jenis dokumen yang harus dilengkapi yaitu:
    1. Dev Site BI
    2. Uji Fungsional
    3. Panduan SOP dan Matriks Penjelasan
    Tujuannya untuk memastikan bahwa merchant sudah mematuhi dan memahami terkait SNAP.
❓Apakah saya bisa menggunakan callback endpoint lokal (localhost) saat integrasi?
Tidak bisa. Espay mengirimkan callback dari internet, sehingga endpoint Anda harus:
  • Dapat menerima permintaan melalui HTTPS POST (sesuai dengan layanan yang digunakan).
  • Dapat diakses secara online, stabil, dan publik.
  • Mengembalikan respons sesuai dengan format yang dijelaskan di dokumentasi.
Simulasi Pembayaran
❓Bagaimana cara simulasi pembayaran Virtual Account atau QRIS di sandbox?
Anda dapat melakukan simulasi transaksi virtual account atau QRIS di sandbox melalui Portal Sandbox Espay. Langkah simulasi dapat Anda temukan di halaman:
❓Bagaimana cara simulasi pembayaran kartu (kredit atau debit) di sandbox?
Anda dapat melakukan simulasi transaksi kartu di sandbox dengan menggunakan data dummy (seperti nomor kartu, CVV, dan expiry date). Detail kredensial dapat dilihat pada halaman:
❓Apakah saya dapat melakukan simulasi pembayaran e-wallet di sandbox?
Saat ini, simulasi pembayaran di sandbox hanya tersedia untuk metode pembayaran OVO.
❓Bagaimana cara simulasi pembayaran OVO di sandbox?
Simulasi pembayaran OVO di sandbox dapat dilakukan dengan:
  1. Memilih metode pembayaran OVO.
  2. Memasukkan nomor handphone acak pada halaman pembayaran.
Pembayaran dan Biaya
❓Bagaimana cara saya mengetahui channel pembayaran apa saja yang dapat saya gunakan?
Anda dapat mengeceknya melalui layanan Inquiry Merchant Info. Layanan ini akan mengembalikan daftar channel pembayaran yang telah aktif di akun Anda. Lihat detail layanan:
❓Apakah biaya channel bisa dibebankan ke nasabah?
Ya, Anda dapat membebankan biaya channel ke nasabah.
❓Apa perbedaan Virtual Account Statis dan Virtual Account Dinamis?​
Kategori Virtual Account Statis Virtual Account Dinamis
Nomor VA
Tetap (fixed)
Sekali pakai (berubah-ubah untuk setiap transaksi)
Metode Integrasi
Virtual Account (Send Invoice)
  • Virtual Account (Send Invoice)
  • Payment Host to Host
Layanan yang dibutuhkan
Payment
  • Inquiry
  • Payment
Lihat detail layanan:
❓Bagaimana cara mengirim ulang notifikasi pembayaran (payment notification)?
Anda dapat mengirim ulang (resend) notifikasi pembayaran dengan salah satu cara berikut:
  1. Melalui Tim Support Espay – mengajukan permintaan untuk resend notifikasi pembayaran.
  2. Menggunakan layanan Inquiry Status – mengatur parameter isPayment: Y untuk memicu notifikasi ulang.
  3. Portal Espay (sandbox atau production) – Gunakan tombol “update to success with notification” untuk mengirim ulang notifikasi pembayaran.
Lihat detail layanan:
Status Transaksi
❓Mengapa status pembayaran transkasi menjadi suspect?
Status “suspect” terjadi karena Espay belum menerima konfirmasi berhasil status pembayaran transaksi. Penyebab umumnya:
  • Gagal melakukan callback notifikasi (error saat mengakses endpoint).
  • Timeout dari pihak bank.
Solusi:
  • Pastikan URL Payment (callback) Anda benar dan dapat diakses secara publik.
  • Periksa apakah respons dari sistem Anda sudah sesuai format yang ditentukan dalam dokumentasi teknis.
  • Jika masalah masih berlanjut, silahkan hubungi Tim Support Espay dengan menyertakan nomor transaksi untuk mempercepat proses pengecekan.
Lihat detail layanan
Settlement
❓Kapan saya akan menerima dana (settlement)?
Waktu penerimaan dana tergantung dengan model yang Anda gunakan:
  • Model Aggregator
    Dana akan masuk pada H+3 hari kerja setelah transaksi sukses, antara pukul 14:00 – 17:00 WIB.
  • Model Direct
    Dana akan masuk secara real-time ke rekening Anda setelah transaksi berhasil.
Pengelolaan Channel Pembayaran
❓Bisakah saya menambahkan metode pembayaran melalui portal Espay?
Tidak, penambahan metode pembayaran tidak dapat dilakukan secara mandiri melalui portal Espay.
  • Sandbox
    Anda bisa mengajukan permintaan ke tim teknis Espay.
  • Production
    Anda melakukan pembaruan PKS.
Keamanan dan Akses
❓Bisakah saya mendaftarkan lebih dari satu alamat IP ke whitelist?
Ya, Anda bisa mendaftarkan lebih dari satu alamat IP.
  • Sandbox
    Gunakan tanda * untuk mengizinkan semua IP (untuk tujuan pengujian).
  • Production
    Kirim permintaan penambahan IP ke Tim Support Espay melalui Email.
Lihat detail cara menambahkan alamat IP di Portal Sandbox:
❓Apakah Espay mendukung IP Whitelisting?
Ya, Espay mendukung IP Whitelisting. Anda dapat membatasi akses agar hanya menerima permintaan dari alamat IP resmi Espay. Lihat daftar IP dan domain resmi Espay:
Scroll to Top