Welcome to Xendit’s latest documentation. For legacy content, access the previous documentation here or the previous API reference here.

Rute & split pembayaran untuk sub-akun

Prev Next

Salah satu fitur yang dapat digunakan dengan xenPlatform adalah kemampuan untuk merutekan pembayaran untuk merchant Anda. Ada beberapa cara untuk merutekan pembayaran Anda berdasarkan kasus penggunaan Anda.

Split Payments memungkinkan Anda untuk mengatur pengurangan biaya otomatis atau pemisahan pembayaran antara beberapa pihak. Ini menawarkan opsi perutean pembayaran yang fleksibel untuk memenuhi berbagai kebutuhan bisnis. Setelah pelanggan menyelesaikan pembayaran, Anda dapat memutuskan bagaimana dana yang masuk akan dibagi setelah dana menyelesaikan.

Kasus Penggunaan

Dari merchant ke Akun Master

Contoh kasus penggunaan: Multi-Branch Business, Payment resellers, Bookkeeping

Pelanggan

Akun Master

Sub-akun

Pembayaran

-Rp 100.000

+Rp 100.000

Transfer

+Rp 30.000

-Rp 30.000

Saldo Akhir

Rp 30.000

Rp 70.000

Dari merchant ke merchant

Contoh kasus penggunaan:  Food delivery SaaS, Dropshipping

Pelanggan

Sub-akun 1

Sub-akun 2

Pembayaran

-Rp 100.000

+Rp 100.000

Transfer

-Rp 50.000

+Rp 50.000

Saldo Akhir

Rp 50.000

Rp 50.000

Dari Akun Master ke merchant

Contoh kasus penggunaan: Marketplace Online

Pelanggan

Akun Master

Sub-akun

Pembayaran

-Rp 100.000

+Rp 100.000

Transfer

-Rp 30.000

+Rp 30.000

Saldo Akhir

Rp 70.000

Rp 30.000

Kirim ke beberapa tujuan

Anda juga dapat mengatur beberapa tujuan untuk pemisahan (masing-masing dengan jumlah datar atau persentasenya sendiri), dengan mengatur destination_account_id yang berbeda dalam array routes.

Implementasi

Membuat Split Rule melalui API

Langkah pertama adalah membuat Split Rule Anda, yang merupakan objek yang dapat dibuat di sistem kami untuk menetapkan aturan untuk membagi pembayaran di platform Anda.

  • Kirim request POST ke https://api.xendit.co/split_rules

  • Split Rule memungkinkan Anda untuk mengatur jumlah flat atai percent dari setiap transaksi

  • Anda juga perlu menentukan salah satu mata uang yang kami dukung terlepas dari jumlah flat atau persentase: IDR, PHP, THB, VND, MYR

  • Tambahkan akun tujuan tempat jumlahnya akan dirutekan Jika akun tujuan null, itu akan default ke akun Master.

  • Xendit akan mentransfer jumlah Split Rule yang dihitung dari total jumlah transaksi dikurangi biaya transaksi.

    • Perhatikan bahwa pembagian jumlah harus menyisakan sisa untuk biaya transaksi, jika tidak, pembagian akan gagal setelah penyelesaian. Aturan pemisahan 100% akan gagal karena biaya tidak dapat dipotong setelah mentransfer seluruh jumlah.

Contoh bagaimana split dihitung:

Pelanggan

Akun Master

Sub-akun

Pembayaran

-Rp 100.000

+Rp 100.000

Split Rule - 50% ke akun master

+Rp 50.000

-Rp 50.000

Biaya & PPN

-Rp 700

Saldo Akhir

Rp 50.000

Rp 49.300

Anda juga dapat membuat beberapa Split Rule berdasarkan kebutuhan Anda. Misalnya: sebagai bisnis franchise, Anda ingin menerima biaya tetap IDR 5.000 untuk setiap transaksi yang dilakukan di toko Jakarta, dan 5% dari pendapatan yang dilakukan oleh toko di Bali. Anda dapat membuat dua aturan biaya yang dikenakan biaya persen IDR 5% dan biaya tetap IDR 5.000.

Anda juga dapat melihat API Reference di sini.

Kirim lewat beberapa rute

Anda dapat menentukan beberapa routes dalam satu transaksi. Misalnya: Untuk dana masuk ke Sub-akun A, transfer 5% ke Akun Master dan tambahan 3% ke Sub-akun B.

Buat transaksi melalui API dengan Split Rule

Anda dapat menerapkan aturan biaya untuk transaksi tertentu. Gunakan header with-split-rule pada panggilan API saat Anda membuat transaksi atas nama mitra Anda. Penyiapan requestAPI Anda akan tergantung pada bagaimana Anda menginginkan aliran uang

header for-user-id

header with-split-rule

Sub-akun ke akun Master

ID Bisnis sub-akun

Split Rule dengan tujuan yang ditetapkan ke platform

Sub-akun ke Sub-akun

ID Bisnis sub-akun

Split Rule dengan tujuan yang diatur ke sub-akun

Akun master ke sub-akun

Split Rule dengan tujuan yang diatur ke sub-akun

Cara membuat transaksi dengan Split Rule:

  1. Buat biaya dalam jenis apa pun (misalnya, Kartu Kredit, E-Wallets) menggunakan header with-split-rule, yang harus berisi ID Split Rule yang unik.

  2. Sertakan header for-user-id untuk bertransaksi atas nama sub-akun (berlaku untuk aliran Sub-akun ke Akun Master dan Sub-akun ke Sub-akun).

    • Anda dapat menemukan ID Split di Dasbor Split Payments Anda.

Header with-split-rule diatur pada tingkat transaksi, memungkinkan pembagian yang sangat dapat disesuaikan. Contoh umum meliputi:

  • Marketplace Online: Membebankan komisi 10% hanya pada transaksi pembelian pakaian dengan menerapkan aturan biaya tertentu untuk jenis transaksi tersebut.

  • Tarif Komisi Dinamis: Membebankan tarif komisi yang berbeda kepada merchant Anda berdasarkan metode pembayaran yang dipilih oleh pelanggan (misalnya, 5% untuk Kartu Kredit, dan 3% untuk E-Wallets).

Pantau dan lacak Split di Dasbor Anda

Anda juga dapat memantau semua pembayaran terpisah dan melacak aturan pemisahan yang telah dibuat di sistem Anda.

Lacak Split Rule yang dibuat

Anda dapat dengan mudah melacak daftar Split Rule yang telah dibuat di dasbor. Gunakan search bar untuk memfilter berdasarkan Split Rule ID. Halaman ini menampilkan detail penting untuk setiap rule, termasuk nama, ID, tanggal pembuatan, jumlah, dan referensi.

Pantau dan ekspor Split Paymnets

Halaman Split Payments memungkinkan Anda untuk melacak semua biaya split yang telah diproses. Daftar komprehensif ini menampilkan split yang berhasil, tertunda, dan gagal, yang dapat Anda filter atau cari. Setiap entri split menyediakan informasi terperinci seperti ID, referensi, tanggal pembuatan, ID Akun sumber dan tujuan, serta jumlah split.

Untuk setiap sub-akun, biaya split akan ditampilkan dengan mudah dalam laporan Transaksi atau Saldo konsolidasi mereka.


FAQ

Mengapa Split Payment saya gagal bahkan ketika pembayaran itu sendiri berhasil?

Ketika pembayaran berhasil, tetapi hanya biaya split yang gagal diproses, maka jumlah yang diselesaikan akan tetap berada di saldo rekening yang menerima dana. Ada beberapa kemungkinan mengapa hal ini terjadi:

  1. Jumlah yang dibagi melebihi sisa dana setelah dikurangi biaya dan PPN

  2. Akun tujuan tidak dapat menerima transfer

Untuk mengatasi masalah ini, Anda mungkin perlu merekoniliasi pembayaran dan secara manual melakukan Transfer.