Bahasa Indonesia
API ReferenceLogin

Buat Payout

Last updated 01/12/2022

Membuat payout sangatlah mudah. Anda dapat memilih untuk membuatnya melalui dasbor, atau melalui integrasi API. Seluruh payout Anda akan ditampilkan pada dashboard Xendit bersama dengan detilnya.

Aturan Payout

Sebelum Anda membuat payout, ada beberapa hal yang harus Anda pahami

  1. Ketika pembuatan payout berhasil, Anda tidak bisa mengubah detil dari payout. Apabila Anda ingin membatalkan payout, Anda dapat memilih tombol “Void” pada dasbor Xendit Anda atau melalui API Void Payout.
  2. Batasan dari tautan payout adalah 24 jam. Apabila tidak ada transaksi pada link payout dalam kurun waktu 24 jam maka tautan payout akan kedaluwarsa.
  3. Payout akan gagal apabila terdapat lebih dari 3 kali kesalahan dalam memasukkan kata sandi pada proses klaim payout.

Membuat Payout

Anda dapat membuat payout melalui dasbor Xendit atau API tergantung pada kebutuhan bisnis Anda. Berikut adalah beberapa hal yang perlu diperhatikan sebelum memilih opsi pembuatan payout:

Platform Pembuatan PayoutKeuntunganKekurangan
Dasbor- Tidak membutuhkan integrasi teknis
- Pembuatan payout dimanapun dan kapanpun selama memiliki akses ke dasbor Xendit
- Langkah-langkah pembuatan mudah dipahami
Pembuatan secara manual dan tidak bisa otomatis
API- Pembuatan payout otomatis melalui API
- Pembuatan cepat
- Tampilan depat disesuaikan sesuai kebutuhan bisnis
Membutuhkan pengembang (developer) untuk melakukan integrasi secara teknis

Buat Payout melalui Dasbor

Untuk membuat payout melalui Dasbor, akun Anda harus memiliki akses EDIT. Ikuti langkah berikut untuk membuat payout melalui Xendit Dasbor:

  1. Login ke Xendit Dasbor
  2. Pilih Pengiriman dana > Payout
  3. Pilih “Buat Payout“ untuk membuat payout dan gunakan informasi di bawah ini sebagai panduan:
KolomDeskripsi
External IDKode unik referensi pada bisnis anda. Tidak ada aturan karakter untuk External ID. Buat kode referensi sesuai kebutuhan Anda dengan memastikan kode tersebut sangat unik
Contoh: HOUSE.AP/INV/XXV/341293TPR0004XJEDBDIEFDJIAGDY
JumlahTotal yang yang ingin dikiramkan dalam bentuk Rupiah
EmailAlamat email penerima payout. Kami akan mengirimkan Merdeka email dental kata sandi untuk mereka klaim payout.

Setelah Anda membuat payout, email akan dikirimkan kepada penerima payout. Email berisikan instruksi, kode sandi, dan tautan menuju halaman payout.

Buat Payout melalui API

Ikuti langkah berikut untuk membuat payout melalui API:

  1. Ikuti instruksi pada Xendit API Reference pada bagian Buat Payout untuk mular membuat payout melalui API
  2. Siapkan Callback URL Disbursement pada Xendit Dasbor untuk “Pengiriman Dana”

Contoh membuat payout melalui API

<?php

  use Xendit\Xendit;
  require 'vendor/autoload.php';

  Xendit::setApiKey('xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==');

  $params = [
    'external_id' => 'demo_2392329329',
    'amount' => 23000
  ];

  $createPayout = \Xendit\Payouts::create($params);
  var_dump($createPayout);

?>
const x = new require('xendit-node')({ secretKey: 'xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==' });

const { Payout } = x;
const payoutSpecificOptions = {};
const p = new Payout(payoutSpecificOptions);

const resp = await p.createPayout({
  externalID: 'demo_2392329329',
  amount: 23000,
  email: 'demo@xendit.co'
});
console.log(resp);
Xendit.apiKey = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw==";
try {
  Map<String, Object> params = new HashMap<>();
  params.put("external_id", "demo_2392329329");
  params.put("amount", 23000);
  params.put("email", "demo@xendit.co");

  Payout payout = Payout.createPayout(params);
} catch (XenditException e) {
  e.printStackTrace();
}
xendit.Opt.SecretKey = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw=="

createData := payout.CreateParams{
  ExternalID: "demo_2392329329",
  Amount:     23000,
  Email: "test@email.com",
}

resp, err := payout.Create(&createData)
if err != nil {
  log.Fatal(err)
}

fmt.Printf("created payout: %+v\n", resp)
from xendit import Xendit

api_key = "xnd_development_P4qDfOss0OCpl8RtKrROHjaQYNCk9dN5lSfk+R1l9Wbe+rSiCwZ3jw=="
xendit_instance = Xendit(api_key=api_key)
Payout = xendit_instance.Payout

payout = Payout.create(
    external_id="payout-1595405117",
    amount=50000,
    email="test@email.co",
)
print(payout)

Pengetesan Payout

Pengetesan payout dapat dilakukan menggunakan nominal dengan mengikuti langkah berikut:

  1. Membuat payout dengan nominal sebesar IDR 90,000 (melalui dasbor atau API)
  2. Klaim payout Anda melalui tautan payout dengan memasukkan kata sandi
  3. Pergi menuju Payouts tab pada Xendit dashboard
  4. Tunggu 10 menit and status payout akan berganti menjadi “Completed”

Mohon diperhatikan bahwa terselesainya pengetesan tersebut hanya terjadi setelah Anda memasukkan kata sandi dari email Anda pada tautan payout. Anda juga dapat melihat skenario pengetesan pada simulasi Disbursements Testing.

Status Payout

Untuk meningkatkan pengalaman Anda, Xendit Payouts memiliki status yang dapat membantu Anda mengenali payout yang sudah komplit, berhasil diklaim, gagal/batal. Berikut adalah status payout yang dapat Anda miliki:

StatusDeskripsi
PendingPayout sudah berhasil dibuat dan tautan payout sudah dikirim ke penerima email. Pada status ini, pengiriman dana belum terinisiasi
ClaimedPenerima sudah berhasil klaim payout dan pengiriman dana diinisasi
CompletedDana sudah berhasil dikirim pada akun bank penerima
FailedPayout gagal. Alasannya bisa terjadi karena kadalauarsa sebelum diklaim, kesalahan input kata sandi, atau masalah pada bank
VoidedPayout sudah dibatalkan. Status ini bisa terjadi karena payout kadaluarsa atau dibatalkan manual melalui Dasbor atau API pembatalan payout