Xendit logo

xendit docs

Pengiriman Dana (Disbursements )

Deskripsi

Pengiriman dana digunakan untuk mengirim uang ke rekening berbagai bank besar di Indonesia. Perusahaan Anda mungkin termasuk platform fintech yang menyalurkan pinjaman kepada peminjam, perusahaan besar yang mengirimkan gaji untuk ratusan karyawan di berbagai rekening bank, platform yang memberikan potongan harga kepada pengguna akhir atau bisnis eCommerce yang membayar pedagang Anda - pengiriman dana adalah cara terbaik untuk mengirimkan uang Anda kepada pengguna Anda.

Semua pembayaran kami dilakukan secara instan, tanpa memperhitungkan jumlah atau rekening bank. Transfer instan dapat dilakukan dari jam 8 pagi hingga jam 10 malam selama 1 minggu penuh. Akan tetapi, kami tidak dapat mengirimkan dana ketika server sedang tidak menyala atau mengalami gangguan. Untuk transaksi T + 1, transaksi akan dilakukan dari jam 8 pagi hingga 3 sore di hari Senin sampai Jumat. Jika Anda mengirim uang di luar waktu yang disebutkan sebelumnya, kami akan mengeksekusinya segera setelah server bank menyala kembali.

Fitur pengiriman dana kami bergantung pada sistem top up - Anda perlu menjaga saldo dana dalam sistem kami. Kami menyimpan dana ini dengan aman atas nama Anda sampai Anda memberi kami instruksi untuk mengirimnya ke tempat lain atau biaya akan dibebankan pada anda. Ketika Anda memulai pengiriman dana baru, Xendit akan langsung mengirimkan dana yang kami simpan sebelumnya (selama saldo Anda positif, kami akan tetap bisa untuk mengirimkan dana tersebut). Sistem kemudian akan memberitahukan apakah proses pengiriman telah diselesaikan melalui callback . Anda juga dapat menanyakan status transaksi kapan saja melalui API.

Coba Sekarang

Cobalah Xendit API di bawah ini. Buat pengiriman dana pertama Anda dan lihat bagaimana Anda dapat dengan mudah membayar karyawan Anda

todoDISBURSEMENT
todo

Membuat Pengiriman Dana (Create Disbursement )

Kami akan membuat pengiriman dana yang kemudian akan kami bayar sehingga Anda dapat melihat bagaimana alur kerja pengiriman dana kami.

Mari mulai dengan menjalankan curl request di terminal Anda. Jangan ragu untuk merubah salah satu parameter.

We will create an disbursement which we will then pay out so you can see how our disbursement flow works.

Let’s start by running the curl request in your terminal. Feel free to edit any of the parameters.


curl https://api.xendit.co/disbursements -X POST \
  -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \
  -d external_id=demo_1475459775872 \
  -d bank_code=BCA \
  -d account_holder_name='Bob Jones' \
  -d account_number='1231241231' \
  -d description='Reimbursement for shoes' \
  -d amount=17000
                    

Proses Pengiriman Dana

todo

Bagaimana penerima dana mengenali pengiriman dana yang dikirim melalui Xendit?

Kami mengirim dana atas nama Anda dari rekening bank kami. Untuk membantu penerima dana mengenali dana dari Anda,

  • Sertakan nama perusahaan anda di deskripsi pengiriman dana - jika bank penerima mendukung masukan ini, penerima dapat melihat ini di laporan rekening mereka.
  • Minta penerima untuk mencari "PT SINAR DIGITAL TERDEPAN" atau “PT SYAFTRACO” di laporan rekening mereka.

Implementasi Pengiriman Dana

Ikuti langkah-langkah di bawah ini untuk mengimplementasi API pengiriman dana kami

todo

Anda harus melakukanPOST request untuk tahap ini. Ini akan membuat request pengiriman dana yang akan dieksekusi segera setelah tersambung dengan server kami.

  • Curl
  • PHP

curl https://api.xendit.co/disbursements -X POST \
  -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \
  -d external_id=demo_1475459775872 \
  -d bank_code=BCA \
  -d account_holder_name='Bob Jones' \
  -d account_number='1231241231' \
  -d description='Reimbursement for shoes' \
  -d amount=17000
                    

<?php 
    require 'vendor/autoload.php'; 

    $options['secret_api_key'] = 'xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg=='; 

    $xenditPHPClient = new XenditClient\XenditPHPClient($options); 

    $external_id = 'demo_1475459775872';
    $amount = 17000;
    $bank_code = 'BCA';
    $account_holder_name = 'Bob Jones';
    $account_number = '1231241231';

    $response = $xenditPHPClient->createDisbursement($external_id, $amount, $bank_code, $account_holder_name, $account_number);
    print_r($response);
?>
                    

Kami telah mengisi contoh di atas dengan sampel API key . Jika Anda sudah login , Anda akan melihat test key yang anda punya. Hanya Anda yang dapat melihat kunci ini.

todo

Setelah request Anda tersambung dengan server kami, API kami akan memberikan respons. Penjelasan mengenari parameter dalam respons yang berhasil dapat dilihat di bawah. Jika Anda mendapatkan eror, silakan lihat dokumen untuk bagian eror .

Respons: 200


{
  "id":"57f1ca56bb1a631a65eee65e",
  "updated":"2016-10-03T03:02:46.239Z",
  "created":"2016-10-03T03:02:46.239Z",
  "user_id":"57b4e5181473eeb61c11f9b9",
  "external_id":"demo_1475459775872",
  "amount":17000,
  "bank_code":"BCA",
  "account_holder_name":"Bob Jones",
  "disbursement_description":"Reimbursement for shoes",
  "status":"PENDING"
}
                
PARAMETERDESKRIPSI
user_id

ID Xendit Anda, untuk keperluan internal

external_id

ID pilihan Anda (biasanya pengenal yang unik untuk invoice di dalam sistem Anda)

amount

Jumlah yang harus kami kirim ke penerima

bank_code

Kode untuk bank yang relevan. Anda dapat melihat semua kode bank di sini

account_holder_name

Nama akun sesuai dengan data dari bank. Digunakan untuk skenario verifikasi dan eror /customer support

account_number

Nomor rekening bank yang harus sesuai dan tepat. Kami akan mengirim ke akun ini dan kami tidak bertanggung jawab jika Anda yang mengirimkan nomor rekening yang salah kepada kami. Skenario eror dapat dilihat di sini

disbursement_description

Deskripsi dari Anda. Deskripsi secara bawaan dapat diatur di dasbor

status

PENDING - berarti kami telah melakukan transfer tetapi bank belum mengembalikan respons yang sukses

COMPLETED - bank telah mengatakan kepada kami bahwa mereka telah mengirim dana (Catatan: terkadang beberapa bank masih memiliki proses yang agak lambat saat eksekusi)

FAILED - berarti pengiriman kami gagal. Penjelasan mengenai skenario eror dapat dilihat di sini

todo

Setelah pembayaran selesai, kami mengirimkan callback untuk memberi tahu Anda tentang keberhasilan pembayaran. Anda harus memberikan kami Callback URL . Di bawah ini kami menyertakan contoh implementasi dari callback client .

  • PHP

<?php
if ($_SERVER["REQUEST_METHOD"] === "POST") {
    $data = file_get_contents("php://input");

    print_r("\n
$data contains the updated disbursement data \n\n");
    print_r($data);
    print_r("\n\nUpdate your database with the disbursement status \n\n");
} else {
    print_r("Cannot ".$_SERVER["REQUEST_METHOD"]." ".$_SERVER["SCRIPT_NAME"]);
}
?>
                  

Selamat! Itu saja - Anda sekarang siap untuk mengirimkan dana dengan Xendit.

Langkah Selanjutnya

  • Siap melakukan beberapa pengujian? Anda dapat mengujinya di halaman pengujian kami untuk mengetahui alur implementasi yang benar
  • Pelajari lebih lanjut mengenai skenario eror dan apa yang kita lakukan

Pertanyaan?

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