Buat Payout
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
- 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.
- Batasan dari tautan payout adalah 3 hari. Apabila tidak ada transaksi pada link payout dalam kurun waktu 3 hari maka tautan payout akan kedaluwarsa.
- 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 Payout | Keuntungan | Kekurangan |
---|---|---|
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:
- Login ke Xendit Dasbor
- Pilih Pengiriman dana > Payout
- Pilih “Buat Payout“ untuk membuat payout dan gunakan informasi di bawah ini sebagai panduan:
Kolom | Deskripsi |
---|---|
External ID | Kode 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 |
Jumlah | Total yang yang ingin dikiramkan dalam bentuk Rupiah |
Alamat 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:
- Ikuti instruksi pada Xendit API Reference pada bagian Buat Payout untuk mular membuat payout melalui API
- Siapkan Callback URL Disbursement pada Xendit Dasbor untuk “Pengiriman Dana”
Contoh membuat payout melalui API
- PHP
- Node.js
- Java
- Go
- Python
<?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:
- Membuat payout dengan nominal sebesar IDR 90,000 (melalui dasbor atau API)
- Klaim payout Anda melalui tautan payout dengan memasukkan kata sandi
- Pergi menuju Payouts tab pada Xendit dashboard
- 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:
Status | Deskripsi |
---|---|
Pending | Payout sudah berhasil dibuat dan tautan payout sudah dikirim ke penerima email. Pada status ini, pengiriman dana belum terinisiasi |
Claimed | Penerima sudah berhasil klaim payout dan pengiriman dana diinisasi |
Completed | Dana sudah berhasil dikirim pada akun bank penerima |
Failed | Payout gagal. Alasannya bisa terjadi karena kadalauarsa sebelum diklaim, kesalahan input kata sandi, atau masalah pada bank |
Voided | Payout sudah dibatalkan. Status ini bisa terjadi karena payout kadaluarsa atau dibatalkan manual melalui Dasbor atau API pembatalan payout |