Xendit logo

xendit docs

Eror

Kesalahan Umum pada Koleksi

Bagian ini akan menjelaskan kesalahan umum yang mungkin terjadi pada sistem koleksi kami:

Mengirimkan jumlah yang salah

Jika terjadi kesalahan pembayaran jumlah, ada dua kemungkinan skenario yang dapat terjadi:

Skenario A - jumlah yang tidak cocok

atau

Skenario B - jumlah yang cocok denganinvoice yang dihasilkan untuk pengguna yang berbeda karena jumlah yang dikirim dengan tidak sengaja cocok denganinvoice tertentu.

Bagian ini menjelaskan cara menangani Skenario A. Lihat bagian "MembayarInvoice yang Salah" untuk penjelasan tentang cara menangani Skenario B.

Skenario A adalah kejadian yang paling umum. Misalnya seorang pengguna yang seharusnya membayar 100.001 justru membayar 100.002 dan karena itu pembayaran tidak cocok denganinvoice manapun.

Berikut beberapa cara untuk menangani masalah ini:

  • Jika Anda menggunakannon-fixed virtual account , sistem kami akan secara otomatis memberi tahu Anda melalui email ketika sistem mendeteksi jumlah pembayaran yang tidak cocok kepada salah satu nomorvirtual account dalam rentang nomorvirtual account yang diberikan kepada Anda. Untuk menerima notifikasi melalui email ini, silahkan registrasi email Anda padaSettings > Configuration > Recipients of emails .

  • Jika Anda menggunakan antarmukainvoice kami, kami menemukan pengguna umumnya menghubungi kami melaluilive chat tentang status pengiriman mereka. Kemudian kami meminta bukti pembayaran dan masalah diselesaikan dengan mencocokkan jumlah yang dibayar denganinvoice yang sesuai.

  • Jika pengguna tidak menghubungi kami atau jika Anda menggunakan antarmukainvoice Anda sendiri maka yang terjadi adalah sebagai berikut: Ketika jumlah tidak cocok, akan terlihat pada dasbor internal Xendit. Kami menjalankan jumlah yang tidak cocok ini melalui berbagai aturan untuk menemukaninvoice yang paling mungkin dan akan menghubungi tim Anda ketika kami mengidentifikasiinvoice tersebut milik Anda.

  • Jika kami tidak dapat menemukan ke mana seharusnya uang tersebut dikirimkan, kami meminta bank untuk mengembalikan uang kepada pengirim.

Membayarinvoice yang salah

Situasi akan menjadi lebih rumit ketika pengguna mengirimkan jumlah uang yang salah yang cocok dengan sebuahinvoice yang dibuat untuk pengguna lain. Pada kasus ini, pengguna pada umumnya akan menghubungi timcustomer support kami dan kami akan bekerjasama untuk memindahkan uang keinvoice yang tepat. Kami menyarankan Anda untuk menyediakanchat box untuk mempermudah pengguna menghubungi tim kami ketika hal ini terjadi.

Nomorvirtual account tidak valid

Sebuah transaksi akan gagal jika nomorvirtual account tidak ada (sama seperti ketika nomor rekening bank yang asli tidak valid). Pada sebagian kasus, nomorvirtual account tersedia tapi nomor tersebut mengacu ke transaksi atau pengguna yang berbeda. Untuk skenario ini, kami bergantung kepada pengirim untuk menghubungicustomer support untuk memperbaiki pembayaran mereka yang salah. Kami bekerja erat dengan tim Anda untuk memastikan penanganan yang tepat waktu untuk masalah tersebut.

Invoice kedaluwarsa

Setiapinvoice yang dibuat memiliki masa berlaku yang Anda tetapkan pada konfigurasi awal. Jika pengguna mengirim uang ketikainvoice sudah kedaluwarsa maka kami dapat membantu pengembalian dana. Pengirim (atau timcustomer support Anda) harus menghubungi tim kami dan memberi kami nomor rekening bank untuk pengembalian dana.

Kesalahan Umum pada Fitur Pembayaran

Berikut adalah daftar eror umum yang Anda mungkin temui ketika menggunakan API Pembayaran kami. Untuk penjelasan yang singkat, kami membagi eror tersebut menjadi 2 kategori:

  • Response eror yang diterima dari APIgateway kami

  • Kode eror yang diterima padacallback kami tentang kegagalan pengiriman

ErorResponse (API)

Masukan API tidak valid

Kami akan mengembalikanresponse eror jika masukan ke dalam API tidak memenuhi Persyaratan validasi API kami.

Mengirim uang kurang dari jumlah minimum atau lebih dari jumlah maksimum

Setiap bank memiliki jumlah minimum dan maksimum transaksi. Kami akan mengembalikanresponse eror jika jumlah pengiriman yang diminta tidak memenuhi batas yang sudah ditentukan. Di bawah merupakan tabel yang berisi jumlah minimum dan maksimum pengiriman yang terbaru untuk setiap pengiriman untuk bank tujuan tertentu:

BANK TUJUANBCA, MANDIRI, BNI, BNI SYARIAH, BRI, SINARMAS, CIMB, PERMATABANK LAIN
Karakter

Angka bulat

Angka bulat

Jumlah maksimum pengiriman (tiap pengiriman)

Tidak ada batas***

Rp 25.000.000

Jumlah minimum pengiriman (tiap pengiriman)

Tidak ada batas

Rp 10.000

*** Meskipun secara teori tidak ada batas maksimum pengiriman untuk bank-bank tersebut, kami mungkin harus melaporkan semua transaksi dengan jumlah di atas Rp 100.000.000 kepada pihak yang berwenang di Indonesia dengan melampirkan dokumentasi pendukung terkait transaksi tersebut.

Server Error

Kami akan mengembalikan respon error SERVER_ERROR jika server kami mengalami gangguan dan tidak dapat memberi konfirmasi status dari pembayaran Anda.

Mohon cek status pembayaran terkait terlebih dahulu sebelum Anda mencoba ulang pembayaran yang sama. Anda dapat melakukan pengecekan melalui Dashboard atau menggunakan API Get disbursements by external_id. Apabila permintaan pembayaran Anda tidak diterima oleh sistem kami, kami rekomendasikan untuk mengirim ulang permintaan pembayaran dalam waktu 1-2 jam.

Kode Eror (Callbacks )

Kami mengembalikan kode eror dalamcallback kami di mana pembayaran gagal untuk alasan tertentu. Penting Anda ketahui setiap kode eror secara detail untuk menentukan aksi yang harus dilakukan. Berikut adalah daftar semua kemungkinan kode eror yang mungkin Anda terima, dengan sedikit penjelasan tentang arti dan aksi yang disarankan dan seusai untuk setiap kode eror.

S/NKODE ERORPENJELASAN DETAILREKOMENDASI PERCOBAAN ULANG
1.INSUFFICIENT_BALANCE

Saldo tidak mencukupi


Tidak terdapat cukup saldo di akun Anda untuk melakukan pembayaran dengan jumlah yang diinginkan.

Haruskah saya mencoba lagi ?


Iya, silakan lakukan pembayaran kembali setelah memastikan bahwa Anda memiliki saldo yang cukup pada akun Anda.

2.UNKNOWN_BANK_NETWORK_ERROR

Eror tidak diketahui bank


Kasus ini berarti bank menyampaikan eror yang mereka belum dokumentasikan, kami belum pernah menemukannya sebelumnya atau bank menentukan mereka tidak yakin apa yang harus dilakukan. Menurut definisi, eror ini berarti bank tidak mengetahui masalah tersebut.

Haruskah saya mencoba lagi ?


Sangat disayangkan kami tidak dapat memprediksi apakah pembayaran akan berhasil ketika Anda mencoba lagi dengan permintaan pembayaran yang sama. Akan tetapi, Anda dapat memilih untuk mencoba lagi permintaan pembayaran yang sama paling cepat satu jam setelah menerimacallback kami dengan kebijaksanaan Anda sendiri.

3.TEMPORARY_BANK_NETWORK_ERROR

Downtime tak terduga


Kami memiliki rutinitasdowntime bank pada sistem kami dan menyimpan permintaan yang diterima untuk sementara selama periode ini sehingga ketikaserver bank kembali bekerja, semua pembayaran dapat segera dilakukan. Akan tetapi, bank di Indonesia secara rutin mengalamidowntime tak terduga yang berdurasi 1-3 jam. Hal ini mungkin terjadi karena adanya pemeliharaan tak terduga atau pusat data yang berhenti bekerja.

Haruskah saya mencoba lagi ?


Iya, silakan lakukan pembayaran kembali dalam 1-3 jam.

4.SWITCHING_NETWORK_ERROR

Masalah perpindahan jaringan


Perpindahan jaringan membantu pembayaran yang bersangkutan untuk pengiriman instan. Dengan demikian, saat penyedia perpindahan jaringan memiliki masalah, pengiriman dana akan gagal.

Haruskah saya mencoba lagi ?


Iya, silakan lakukan pembayaran kembali dalam 1-3 jam.

5.INVALID_DESTINATION

Akun tujuan tidak valid


Eror ini terjadi ketikachannel perbankan memberi tahu kami bahwa akun tersebut tidak valid. Umumnya, hal ini berarti akun belum terdaftar pada bank tujuan atau bank memblokir akun tersebut. Hal ini juga terjadi untuk akun bank yang baru saja dibuat yang belum dimasukkan ke dalam basis data nasional.

Haruskah saya mencoba lagi ?


Sangat kecil kemungkinan Anda untuk berhasil jika mencoba lagi permintaan pembayaran yang sama.
Akan tetapi, ada kalanya bank dengan keliru memberitahu kami bahwa sebuah akun bank yang sudah ada sebenarnya tidak ada. Ini merupakan masalah integritas bank di Indonesia dan terkadang diselesaikan dengan mencoba kembali transaksi paling cepat satu jam setelah menerimacallback kami atau dengan menghubungi bank tujuan secara langsung untuk informasi lebih lanjut.

6.REJECTED_BY_BANK

Pengiriman ditolak oleh bank


Baik bank pengirim maupun bank tujuan dapat menolak pengiriman dana untuk berbagai alasan. Hal ini merupakan eror bank yang umum dan bank tidak harus memberi kami detail untuk kegagalan tersebut.

Haruskah saya mencoba lagi ?


Sangat disayangkan kami tidak dapat memprediksi apakah pembayaran akan berhasil ketika Anda mencoba lagi dengan permintaan pembayaran yang sama. Akan tetapi, Anda dapat memilih untuk mencoba lagi permintaan pembayaran yang sama paling cepat satu jam setelah menerimacallback kami dengan kebijaksanaan Anda sendiri.

7.TRANSFER_ERROR

Eror fatal


Kami menemukan kesalahan yang fatal saat memroses pembayaran tersebut. Umumnya, eror ini berarti adanya masukan API dalam permintaan yang tidak valid.

Haruskah saya mencoba lagi ?


Kecil kemungkinan permintaan pembayaran yang sama akan berhasil jika Anda mencoba lagi. Silahkan hubungi timcustomer support kami untuk informasi lebih lanjut.

8.TEMPORARY_TRANSFER_ERROR

Eror sementara


Kami menemukan sebuah masalah ketika mencoba memroses pembayaran tersebut. Umumnya masalah ini dapat diselesaikan dalam 1-2 jam setelahnya.

Haruskah saya mencoba lagi ?


Iya, silahkan mencoba lagi pembayaran dalam 1-2 jam.

Pertanyaan?

Masih memiliki pertanyaan? Dengan senang hati kami akan membantu Anda. Kirimkan email atau pesan melalui live chat .