Skip to content

Direct Disbursement

Apa Itu Direct Disbursement?

Direct Disbursement (XenDisburse) digunakan untuk mengirim dana ke satu bank tujuan dari saldo anda di akun Cash. Kami menerapkan waktu standar selama 15 menit untuk transaksi Disbursement, selama server bank tidak bermasalah. Jika ini terjadi, kami akan menempatkan transaksinya pada antrian dan memprosesnya segera setelah server bank kembali berjalan normal. Pelajari lebih lanjut tentang Direct Disbursement di Xendit Docs and the Xendit API Reference.


Menggunakan Direct Disbursement

Direct Disbursement dilakukan menggunakan RESTful API kami, yang menjadikan integrasi sederhana tanpa tersambung dengan bank yang mengenakan biaya tambahan untuk transfer antar bank. Anda akan diberikan authorization key unik (API Key rahasia yang dienkripsi) yang memudahkan kami untuk mendeteksi pengirim request disbursement. Penting untuk menjaga key ini tetap rahasia, sehingga hanya klien kami tertentu yang memiliki akses ke sistem Xendit.

Jika request untuk disbursement dilakukan, Xendit akan langsung melakukan pengiriman dana dari saldo positif anda. Sistem kami akan memberikan notifikasi melalui API Callback ketika Disbursement tersebut sudah selesai.

Terlebih lagi, anda selalu bisa mengecek status disbursement kapan saja melalui API atau monitor melalui dasbor, dimana anda juga bisa unduh bukti transaksi dengan nomor referensi bank untuk penerima dana. Berikut adalah contoh bukti transaksi untuk disbursement yang akan muncul pada dasbor anda:

alt text


Error yang Biasanya Terjadi pada Direct Disbursement

Biasanya, direct disbursement akan gagal jika mengalami hal berikut ini:

alt text

Kami mengembalikan kode eror ketika transaksi disbursement gagal dengan alasan apapun. Penting untuk memahami setiap kode eror secara detil untuk menentukan langkah yang diambil. Untuk daftar kemungkinan eror yang anda akan terima secara komprehensif, beserta komentar tentang definisi dan rekomendasi langkah yang dapatdilakukan, silahkan melihat Eror yang Biasa Terjadi di Disbursement..

Saya melihat bahwa ada rekomendasi tentang waktu untuk mencoba kembali transaksi disbursement yang telah gagal namun bisa dicoba kembali - haruskah saya mengikutinya?

Ya, kami sangat merekomendasikan anda untuk mengikuti setiap waktu yang kami rekomendasikan untuk mencoba transaksinya kembali. Selain untuk transaksi yang gagal karena saldo anda tidak cukup, anda cukup mencoba kembali untuk request disbursement satu jam setelah menerima callback transaksi disbursement tersebut. Mencoba kembali transaksi terlalu cepat bisa mengakibatkan banyaknya transaksi yang gagal dan hanya akan memberi waktu delay lebih lama.

Saya pernah melakukan disbursement yang sukses kepada akun tujuan tertentu sebelumnya, namun sekarang saya diberi tahu bahwa disbursement telah gagal. Apa yang harus saya lakukan?

Ini tergantung dari kode eror yang anda terima pada callback.

Pertama, anda bisa melihat petunjuk kami untuk kode eror yang biasanya diterima di Eror yang Biasa Terjadi di Disbursement.

Jika anda telah menerima kode eror dengan kode centang hijau ✅ selain “Apakah saya harus mencoba kembali?” di kolom Rekomendasi untuk mencoba lagi, anda bisa mencoba kembali request disbursement tersebut dalam waktu yang direkomendasikan. Request disbursement tersebut memiliki kemungkinan untuk berhasil setelah mencoba kembali.

Jika anda telah menerima keterangan “UNKNOWN_BANK_NETWORK_ERROR” atau “REJECTED_BY_BANK”, sayang sekali kami tidak dapat memprediksi jika disbursement akan sukses, atau jika anda harus mencoba kembali request disbursement yang sama. Berikut adalah kode umum atau eror yang dikembalikan baik oleh bank penerima ataupun bank pengirim. Anda bisa mencoba kembali untuk melakukan transaksinya paling tidak satu jam setelah menerima callback kami sesuai dengan kebijakan anda.

Jika anda telah menerima keterangan “INVALID_DESTINATION”, maka salah satu dari kemungkinan ini yang terjadi:

1) Akun tujuan yang pada request anda mungkin telah diblokir oleh bank penerima karena beberapa alasan tertentu, atau

2) Bank telah memberi informasi bahwa akun tujuan tidak ada

Anda bisa memilih untuk mencoba kembali transaksi disbursement yang sama setidaknya satu jam setelah callback dari kami diterima, atau anda bisa menghubungi bank penerima langsung untuk informasi lebih lanjut.

Jika anda menerima “TRANSFER_ERROR”, ini berarti kami telah mengalami eror yang fatal dalam memproses disbursement anda. Seringkali ini disebabkan oleh kolom API yang tidak valid pada request anda. Mohon hubungi Customer Support untuk menerima bantuan jika anda mengalami error ini. Request Disbursement yang sama kemungkinan tidak akan berhasil setelah beberapa kali mencoba.


Proses Direct Disbursement

Anda harus memiliki saldo positif pada Akun Cash di dasbor Xendit anda untuk bisa melakukan pengiriman dana, silahkan melihat artikeltop up kami untuk informasi lebih lanjut. Anda harus melakukan request POST melalui API untuk melakukan pengiriman dana. Dana tersebut akan terlebih dahulu masuk ke Akun Escrow anda. Jika telah sukses, dana maka akan langsung dikirimkan, jika gagal, dana akan kembali lagi ke Akun Cash anda.

alt text

alt text


Bagaimana Saya Membuat Direct Disbursement?

Anda bisa membuat Direct Disbursement dengan menggunakan API. Silahkan ikuti direct disbursement guide kami untuk implementasi API.

Jika anda melakukan transaksi di Mode Development, mohon perhatikan bahwa hanya Direct Disbursement dengan nominal 90.000 yang akan menjadi transaksi sukses.


FAQs

  1. Apakah Xendit terkoneksi langsung dengan bank?

    Ya. Kami memiliki koneksi langsung dengan beberapa bank yang memungkinkan kami untuk mengirim dana ke lebih dari 140 bank di Indonesia.

  2. Apakah saya akan menerima notifikasi setelah saya melakukan request Disbursement?

    Ya. Ketika transaksi Disbursement dilakukan, kami akan mengirimkan anda callback untuk memberikan notifikasi status Disbursementnya. Mohon pastikan bahwa anda sudah mengatur callback URL pada Dasbor > Settings > Configuration > Disbursement > Callback URL.

  3. Apa itu callback pada Direct Disbursement?

    Callback pada direct disbursement adalah notifikasi yang kami kirimkan ke server anda untuk memberi notifikasi jika transaksinya sukses atau gagal.

  4. Bagaimana saya tahu jika transaksinya sukses atau gagal?

    Dalam callback yang kami kirim, akan disertakan keterangan apakah transaksinya berhasil atau gagal. Anda juga akan memiliki akses untuk dasbor dimana anda bisa melakukan monitor status dan detil transaksi yang telah dibuat. Atau, anda juga bisa mengecek transaksi dengan membuat request “GET”. Temukan caranya disini.

  5. Bagaimana sistem disbursement anda bekerja?

    Disbursement kami bergantung kepada sistem isi ulang saldo. Ini artinya anda harus menjaga saldo positif di sistem kami. Kami akan menyimpan dana ini dengan aman sampai anda memberikan instruksi kepada kami untuk mengirimkannya. Ketika anda melakukan transaksi disbursement, Xendit akan langsung mengirimkan dana tersebut (selama saldo anda cukup).

  6. Bisakah saya membatalkan transaksi disbursement?

    Ketika request Disbursement anda telah direspon oleh Xendit, maka artinya dana sedang dalam proses pengiriman, maka tidak bisa dibatalkan.

  7. Bisakah saya melakukan transaksi disbursement 24/7? Apakah server anda memiliki waktu down?

    Sistem kami bergantung pada koneksi dengan bank. Sistem kami bekerja 24/7, namun, jika server bank sedang tidak bekerja, maka transaksi bisa saja gagal (contoh, waktu settlement di malam hari atau isu koneksi dengan bank).

  8. Bisakah saya menggunakan ATM Bersama” sebagai kode bank dalam transaksi disbursement?

    Untuk saat ini tidak bisa, kami memiliki kode bank sendiri yang bisa dilihat disini.

  9. Mengapa status disbursement saya PENDING?

    Status pending artinya adalah transaksi anda sedang dalam proses, anda hanya tinggal menunggu callback dari kami setelahnya untuk menerima notifikasi status disbursement.

  10. Saya secara tidak sengaja mengikutsertakan tanda strip “-” di nomor akun bank, apakah ini akan mempengaruhi transaksi disbursement saya?

    Tidak, simbol pada nomor akun bank tidak akan menghalangi Disbursement, karena sistem kami secara otomatis akan menghapus simbol tersebut.

  11. Apa yang harus saya lakukan jika Name Validator request saya berhasil namun transaksi disbursement saya gagal? Mengapa ini terjadi?

    Silahkan cek dengan customer anda atau pemilik akun bank untuk memastikan bahwa tidak ada isu dengan akun tersebut. Alasan yang biasanya terjadi adalah rekening tersebut dibekukan. Yang artinya, akun tersebut aktif dan tervalidasi, namun tidak bisa menerima dana. Atau, jika rekening tujuan anda adalah BCA dan anda mendapatkan kode eror tersebut, mohon coba lagi dengan mengawali angka “0” di depan nomor rekening tujuan. Untuk BCA, Name Validator tersebut mengembalikan sukses karena nomor rekening tujuan dikondisikan sama dengan atau tanpa angka “0” di depan. Namun, di dalam sistem Disbursement kami, nomor rekening tujuan (dengan angka “0”) dibutuhkan agar dapat berhasil melakukan Disbursement.

    {"error_code":"RECIPIENT_ACCOUNT_NUMBER_ERROR",
    "message":"BCA account numbers must be 10 digits long"}
    
  12. Apakah disbursement bisa dilakukan menuju Virtual Account?

    Ya, kami mendukung disbursement menuju virtual account bank-bank besar di Indonesia (BRI, BNI, Mandiri, CIMB Niaga, Permata, BTN, dan NOBU). Kami selalu menambahkan pilihan virtual account bank yang kami dukung. Silahkan hubungi kami jika ada virtual account bank yang anda perlukan

  13. Bisakan disbursement dilakukan ke e-wallet?

    Ya, kami mendukung disbursement menuju e-wallet besar (GoPay, OVO, dan Mandiri e-Cash). Anda bisa langsung mengirimkan dananya ke e-wallet dari pelanggan anda. Cukup dengan menggunakan format berikut di request disbursement:

    "Bank Code" = kode bank dari e-wallet tujuan (Contoh: GOPAY / OVO / MANDIRI_ECASH)

    "Account Holder Name" = nama dari pelanggan, sesuai simpanan database e-wallet

    "Account Number" = nomor handphone pelanggan yang terdaftar di e-wallet (contohnya: 0812XXXXXXXXX)

    Karena kami akan melakukan transfer menuju e-wallet yang dikaitkan dengan nomor handphone spesifik, harap memastikan bahwa anda telah memasukkan nomor telepon yang benar ketika request dikirimkan. Disbursementnya akan muncul sebagai top up di e-wallet customer anda. Kami selalu menambahkan pilihan tujuan disbursement yang bisa dilakukan. Silahkan hubungi kami jika ada tujuan yang anda inginkan segera!