Apabila Anda tertarik untuk menarik biaya komisi secara otomatis setiap kali transaksi terjadi pada Platform Anda atau sub akun Anda, Anda dapat menggunakan fitur Split Payment.

Batasan

1. Penerapan Split Rule belum bisa dilakukan via Dashboard dan harus melalui API.
2. Untuk saat ini, Split Rule yang sudah dibuat belum bisa dihapus.
   • Jika sudah tidak digunakan, Anda dapat menghapus split rule ID dari header "with-split-rule" Request API Anda.
3. Pastikan API Key akun master Anda memiliki permission "Write" untuk xenPlatform > Split Payments
   • Klik di sini untuk mempleajari lebih jauh mengenai pembuatan API key.

Tutorial

Anda dapat melakukan routing dan split payment secara otomatis dengan 2 langkah berikut:

1. Split Rule Creation via API

Split Rule adalah fitur dari xenPlatform yang memungkinkan Anda menarik komisi (Splits) secara otomatis setiap kali transaksi terjadi pada platform Anda, ataupun sub akun mitra Anda.

Ikuti tutorial pada tautan berikut untuk membuat Fee Rule:

https://developers.xendit.co/api-reference/id/#buat-split-rule

1. The endpoint that will be used is as follows:
   

   • POST https://api.xendit.co/split_rules

2. Pastikan API Key Master Account yang dimasukkan sudah benar;
3. Masukkan nama split rule yang akan Anda buat pada body request pada parameter "name";
4. Konfigurasikan Split Payment Anda pada body request di bawah "routes".
   • Nominal Splits
     • Masukkan “percent_amount” jika komisi yang ingin Anda terapkan berbasis sekian persen dari nominal transaksi yang dilakukan;
       • “percent_amount” harus berada pada rentang 0 sampai 100
       • Nominal splits akan dibulatkan ke bilangan bulat terdekat (contohnya Rp. 0.5 akan dibulatkan ke Rp. 1; Rp. 0.49 akan dibulatkan ke Rp. 0)
       • contoh: "10" untuk splits sebesar 10% dari nominal transaksi.
     • Masukkan “flat_amount” jika komisi yang ingin Anda terapkan nominalnya tetap berapapun nominal transaksinya.
       • contoh: "10000" untuk splits sebesar Rp. 10,000 per transaksi.
     • Anda harus memasukkan salah satu (“percent_amount” atau “flat_amount”) dalam setiap "route" dan tidak bisa keduanya;
     • Anda dapat memiliki kedua “percent_amount” atau “flat_amount” di "route" yang berbeda
   • Mata Uang
     • Masukkan “IDR” pada body request pada parameter "currency"
   • Akun Tujuan
     • Masukkan BID tujuan splits pada body request di parameter "destination_account_id"
     • Jika parameter ini tidak dimasukkan, maka platform fee akan diarahkan untuk masuk ke akun master Anda secara otomatis;
   • Reference ID
     • Masukkan "reference_id" yang unik supaya sistem dapat mengidentifikasi route yang dituju.
   • Anda dapat memasukkan hingga 5 "routes" berbeda untuk melakukan Split Payment ke 5 akun berbeda;
5. Klik Send;
   
6. Lihat detail dari Split Rule Anda pada laman Tab xenPlatform > Split Payment > Split Rules pada Dashboard

Berikut adalah video tutorial pembuatan Fee Rule untuk penerapan biaya komisi per transaksi yang terjadi pada sub akun, untuk diteruskan ke tiga akun berbeda, dengan penerapan “percent_amount” atau “flat_amount” di "route" yang berbeda:

2.  Penerapan Split Rule via API untuk Menagih Splits

Ikuti tutorial pada tautan berikut untuk membuat transaksi yang diinginkan via API;

https://developers.xendit.co/api-reference/id/

1. Carilah transaksi pada API Reference yang bisa menggunakan parameter “with-split-rule” pada Header Request;
   
   
2. Pastikan API Key Akun Master yang dimasukkan sudah benar;
3. Masukkan Business ID sub akun di header pada parameter "for-user-id";
   • Jika parameter ini tidak dimasukkan, maka splits akan ditagih dari transaksi yang terjadi pada akun master Anda secara otomatis;
4. Salin ID dari split rule yang sudah dibuat pada langkah 1;
   • Anda dapat menemukan ID Split Rule Anda dari Response API yang Anda dapatkan dari Step 1, maupun Dashboard Akun Master Anda, pada menu xenPlatform > Split Payment > Split Rules
     
     
5. Masukkan Split Rule ID yang ingin diterapkan di header pada parameter "with-split-rule";
   
   
6. Lakukan transaksi pada API seperti biasa sesuai dengan tutorial pada API Reference masing-masing;
7. Setelah transaksi melewati waktu penyelesaian dana (settlement time), Anda dapat melihat Platform Fee pada Dashboard Akun Master Anda, pada channel "SPLIT" di:
   • Tab Saldo;
   • Tab Transaksi;
   • Tab xenPlatform > Split Payment > Splits

Berikut adalah video tutorial penarikan biaya komisi untuk transaksi yang terjadi pada sub akun, untuk diteruskan ke tiga akun berbeda: