Bahasa Indonesia
API ReferenceLogin

Melakukan pemotongan biaya Platform

Last updated 12/01/2021

Apabila Anda tetarik untuk menarik biaya atau komisi saat partner Anda bertransaksi di platform anda, Anda dapat menarik komisi secara otomatis dengan fitur Platform Fee.

Fitur ini saat ini telah tersedia di Indonesia 🇲🇨

Pelajari contoh penggunaan Platform Fee

Model BisnisContoh Penggunaan Fitur
Online marketplaceMenarik biaya komisi untuk setiap transaksi penjualan dari seller.
Bisnis dengan banyak cabang (retailer, franchise)Menarik biaya manajemen untuk setiap transaksi dari setiap cabang.
Payment resellerTarik biaya komisi untuk sebagai profit dari servis Anda.
Platform SaaSBantu fasilitasi pembayaran untuk klien Anda, tarik biaya komisi untuk menambah keuntungan bisnis Anda.

Kontak kami jika Anda tertarik menggunakan fitur ini untuk contoh pemakaian lainnya.

Terima biaya Platform secara otomatis dengan 2 langkah

1. Buat sebuah Fee Rule via API

Fee Rule adalah objek yang dapat dibuat dalam sistem kami untuk menarik sebuah biaya komisi dalam platform Anda. Contoh: sebagai business franchise, Anda ingin mengambil biaya komisi 5000 IDR dari setiap transaksi cabang toko di Jakarta, dan 5% keuntungan dari cabang di Bali, Anda dapat membuat dua fee_rule dengan amount 5000 IDR dan 10%.

Langkah-langkah membuat Fee Rule:

  • POST ke https://api.xendit.co/fee_rules
    • Fee Rule dapat digunakan untuk menarik biaya Platform. Anda dapat memilih nilai percent atau flat.
    • Sistem Xendit akan mengkalkulasi jumlah biaya platform yang ditarik dari total transaksi apabila menggunakan nilai percent.
    • Fee Rule amount harus lebih kecil dari jumlah transaksi total
curl --request POST \
  --url POST https://api.xendit.co/fee_rules 

2. Buat transaksi (Invoice, OVO, dll) via API dengan menggunakan Fee Rule

Anda dapat mengaplikasikan fee rule untuk transaksi yang dibuat. Gunakan with-fee-rule header dalam pemanggilan API saat anda akan membuat transaksi untuk partner Anda. Contoh: sebagai bisnis marketplace online, Anda ingin menarik 10% komisi dari transaksi pakaian, Anda dapat mengaplikasikan with-fee-rule header untuk transaksi tipe pakaian saja.

Langkah-langkah membuat transaksi dengan Fee Rule:

  • Misalnya POST ke https://api.xendit.co/v2/invoices dan gunakan with-fee-rule dalam header API dengan fee ID yang telah dibuat dari Fee Rule.
  • Anda dapat mencari Fee ID pada Dasbor Fee Rule

Saat ini, Anda dapat menggunakan Fee Rule untuk tipe transaksi berikut:

Pelajari lebih lanjut di API reference.

Waktu proses pembayaran & rincian

Setelah transaksi pembayaran terproses ke akun Partner Anda, Xendit akan secara otomatis melakukan pemotongan komisi biaya platform dari akun Partner, dan melakukan transfer ke akun Platform Anda:

  • Fee Rule akan menampilkan jumlah debit dari biaya komisi di dasbor Platform
  • Fee Rule akan menampilkan jumlah kredit biaya komisi di dasbor Partner

Contohnya, apabila Anda membuat Fee Rule sebesar 30% biaya komisi untuk setiap transaksi, saat anda memfasilitasi transaksi sebesar Rp 100.000,00 untuk Partner anda dengan Fee Rule, Rp 30.000,00 akan secara otomatis ditransfer ke akun Platform Anda, sedangkan Rp 70.000,00 akan tersisa di akun Partner.

Catatan: Biaya komisi akan ditransfer dari Akun Partner ke Akun Platform setiap interval 15 menit setelah transaksi diproses, Maka dari itu, mohon beri sedikit waktu maksimal 15 menit setelah transaksi diproses untuk melihat pengambilan biaya Platform Fee di dasbor.

Pelajari lebih lanjut di API reference.

Monitor dan cek biaya melalui Dasbor

Anda juga dapat melakukan monitor dari segala transaksi Platform Fee, dan melihat Fee Rules yang telah terbuat di system Xendit.

1. Monitor Platform Fee

Cek status pembayaran, tanggal transaksi selesai diproses, filter biaya, dan informasi lainnya.

Di tab Platform Fee, anda akan melihat kolom berikut:

  • Fee ID: kolom ini menunjukkan fee rule ID unik yang telah diaplikasikan ke transaksi tersebut. ID ini dibuat oleh sistem Xendit pada saat Anda pertama kali membuat fee rule baru).
  • Referensi: referensi unik dari setiap transaksi baru yang dibuat dalam server anda, contohnya external_id parameter.
  • Tanggal dibuat: tanggal dimana transaksi yang diaplikasikan dengan fee rule telah dibuat.
  • Akun ID destinasi: akun ID unik dari si penerima biaya komisi Platform.
  • Jumlah transaksi: jumlah total transaksi yang dibayar oleh pembeli.
  • Total Platform Fee: jumlah total komisi yang diambil oleh Platform dari akun Partner.
  • Tanggal settlement: tanggal dimana pembayaran transaksi telah diproses dan sampai ke akun Xendit.
  • Status: status dari pemotongan biaya Platform.
StatusArtiCatatan
CompletedPlatform Fee telah diproses dan tertera di akun PlatformAnda dapat melihat transaksi Platform Fee di halaman Saldo Anda
PendingPlatform Fee masih diprosesAda dua kemungkinan:
1. Transaksi belum selesai diproses ke Xendit
2. Sistem sedang dalam proses melakukan pemotongan biaya Platform Fee
FailedGagal melakukan pemotongan biaya PlatformKemungkinan sistem gagal karena:
1. Akun Partner tidak punya saldo yang cukup
2. Pembeli gagal melakukan pembayaran
3. Transaksi sudah kadaluwarsa

2. Cek Fee Rules yang telah dibuat

Anda dapat mengecek semua Fee Rules yang telah dibuat melalui dasbor, dan melakukan pencarian menggunakan Fee Rule ID

Di halaman Fee Rules, Anda akan melihat kolom berikut:

  • Nama Aturan Biaya: kolom ini menunjukan nama yang dipilih untuk mengidentifikasi Fee Rule saat dibuat.
  • Fee ID: Fee Rule ID adalah ID yang digenerasi oleh sistem Xendit saat anda melakukan pembuatan Fee Rule via API.
  • Total Platform Fee: kolom ini adalah jumlah biaya Platform yang ditentukan saat melakukan pembuatan Fee Rule via API. Jumlah ini dapat berupa nilai percent atau flat.
  • Tanggal dibuat: kolom ini menunjukan tanggal dimana Anda membuat Fee Rule via API.

Pelajari lebih lanjut Anda dapat mendapatkan demo session gratis untuk mempelajari fitur ini, tanpa komitmen.