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
❓Apa perbedaan status Success, Failed, Suspect, dan In Process?
Success (S)
Pembayaran berhasil dilakukan dan notifikasi pembayaran (Payment) telah berhasil dikirim oleh Espay serta diterima dan diproses dengan baik oleh sistem merchant.

Failed (F)
Pembayaran gagal dilakukan, biasanya karena nomor Virtual Account sudah expired, inactive, atau terjadi kegagalan saat proses pembayaran.

Suspect (SP)
Pembayaran berhasil dilakukan oleh customer, namun notifikasi pembayaran (Payment) gagal diterima atau diproses oleh sistem merchant.

In Process (IP)
Transaksi telah dibuat namun pembayaran dari customer belum dilakukan.
❓Mengapa saya menerima error "Rejected, Error Komunikasi dengan Mitra"?
Error ini terjadi karena Espay tidak dapat berkomunikasi dengan sistem Anda saat memproses transaksi, khususnya ketika melakukan pemanggilan callback Inquiry. Akibatnya, Espay tidak dapat mengambil atau memproses data transaksi sehingga transaksi berstatus Rejected.

Penyebab umum terjadi:
  • URL callback tidak dapat diakses (timeout, DNS error, atau server down).
  • URL callback mengembalikan response error (HTTP 4xx/5xx).
  • Format response tidak sesuai dengan dokumentasi Espay.
  • Terdapat kendala jaringan antara Espay dan server Anda.

Solusi:
  • Pastikan endpoint callback dapat diakses secara publik.
  • Pastikan server tidak mengembalikan error saat dipanggil oleh Espay.
  • Periksa format response agar sesuai dengan dokumentasi teknis Espay.
  • Periksa log server untuk memastikan Anda menerima dan merespons permintaan Espay.
❓Mengapa status pembayaran transkasi menjadi suspect?
Status Suspect (SP) terjadi ketika pembayaran oleh customer berhasil, namun Espay tidak berhasil mengirimkan notifikasi pembayaran (Payment Notification) ke sistem merchant. Akibatnya, Espay belum menerima konfirmasi bahwa notifikasi pembayaran telah diterima dengan baik.

Penyebab umum terjadi:
  • URL callback Payment tidak dapat diakses (timeout, DNS error, atau server down).
  • URL callback Payment mengembalikan response error (HTTP 4xx/5xx).
  • Format response tidak sesuai dengan spesifikasi dokumentasi Espay
  • Terdapat kendala jaringan antara Espay dan server merchant.

Solusi:
Pastikan endpoint callback Payment dapat diakses secara publik dan mengembalikan response sesuai dengan dokumentasi Espay. Jika notifikasi pembayaran belum diterima, Anda dapat melakukan resend Payment Notification dengan beberapa cara berikut:
  • Menghubungi Tim Support Espay untuk meminta pengiriman ulang notifikasi pembayaran.
  • Menggunakan layanan Inquiry Status dengan mengatur parameter isPayment: Y untuk memicu pengiriman ulang notifikasi.
  • Melalui Portal Espay (sandbox atau production) dengan menggunakan tombol “update to success with notification”.
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