Contoh Penggunaan

Menentukan pendekatan terbaik untuk bisnis Anda

Gunakan xenPlatform untuk mengelola pembayaran Partner dalam Platform Anda dengan 4 langkah sederhana:

Buat sebuah akun
Kelola pembayaran untuk partner
Memantau transaksi partner
Melakukan pembayaran untuk partner

Kami menyediakan beberapa pilihan pengalaman pembayaran yang dapat Anda pilih sesuai dengan kebutuhan Partner Anda. Kami juga memberikan beberapa solusi yang dapat dipelajari berdasarkan bisnis model Platform secara umum, yaitu:

Platform SaaS (contoh: untuk UMKM, pengelolaan properti, dll)
Platform Point of sales
Reseller layanan pembayaran

Tanyakan pada kami untuk rekomendasi pilihan lainnya jika bisnis Anda tidak masuk dalam kategori di atas atau Anda memiliki kebutuhan lain.

Platform SaaS

Sebelum menerima pembayaran untuk partner Anda, Platform harus memastikan bahwa beberapa pengaturan telah di konfigurasi pada level akun partner.

Metode Pembayaran harus aktif pada level akun partner

Platform harus memastikan terlebih dahulu bahwa seluruh metode pembayaran yang ingin digunakan telah aktif pada level akun partner.

Jika akun partner Anda adalah:

Akun Owned

Ketika Platform sudah mengaktifkan sebuah metode pembayaran pada level akun platform maka metode pembayaran tersebut juga akan aktif secara otomatis pada level akun partner Anda*.

* Lihat bagian batasan pengaturan dapat selaras untuk akun Owned yang sudah terbuat sebelumnya

Akun Managed

Partner Anda harus melakukan aktivasi metode pembayarannya masing-masing melalui dasbor yang dimilikinya. Arahkan mereka untuk melakukan aktivasi dengan menuju halaman Metode pembayaran dan klik “Aktifkan” pada setiap metode pembayaran.

Metode pembayaran yang tersedia untuk akun partner Anda

Negara yang telah tersedia saat ini:

Indonesia
Filipina

Indonesia

Metode Pembayaran	Owned	Managed
Virtual Account - BCA (Aggregator dan Switcher)	✅ **	✅ *
Virtual Account - Aggregator	✅	✅
Virtual Account - Switcher	✅	✅ *
Kartu Kredit / Debit	✅	✅ *
Retail Outlet	✅	✅ *
Direct Debit	✅	✅
Ewallet	✅	✅
Ewallet - ShopeePay	✅ **	✅
QR Code - Dynamic	✅	✅
QR Code - Static	✅ **	✅
Paylater	❌	✅

Filipina

Metode Pembayaran	Owned	Managed
Kartu Kredit / Debit	✅ **	✅
Retail Outlet	✅	✅
Direct Debit	✅	✅
Ewallet	✅	✅
Ewallet - GCash	✅ **	✅
Paylater	❌	✅

* Tidak tersedia apabila partner register sebagai bisnis individu

** Channel ini memerlukan aktivasi yang berbeda untuk Owned Sub-Accounts, silahkan hubungi kami untuk mempelajari lebih lanjut

Alur Proses dan Implementasi

Gunakan API key milik akun Platform Anda dan lakukan permintaan pembuatan pembayaran untuk partner Anda melalui API seperti pembuatan Invoice dengan menambahkan parameter for-user-id pada header permintaan. Masukkan id dari akun partner yang ingin Anda buatkan pembayarannya sebagai nilai dari parameter tersebut for-user-id.

Berikut adalah beberapa contoh alur penerimaan pembayaran untuk partner Anda:

Pembuatan xenInvoice untuk partner Anda

Pembuatan Fixed Virtual Account untuk partner Anda

Nama yang Ditampilkan ke Pengguna

Dengan menggunakan xenPlatform, kita dapat menerima pembayaran atas nama partner kita untuk berbagai jenis channel pembayaran. Ketika pengguna membayar transaksi, mereka akan melihat nama Partner di beberapa aplikasi. Ada beberapa pedoman untuk penampilan nama merchant berdasarkan jenis akun sebagai berikut:

Managed Sub Account: Seluruh metode pembayaran akan menampilkan nama partner (untuk VA dan Retail Outlet yang dibuat menggunakan API, dapat disesuaikan melalui parameter name pada API Reference)
Owned Sub Account: Nama yang ditampilkan akan mengikuti jenis metode pembayaran sebagai berikut:

🇮🇩 Indonesia (ID)

Metode Pembayaran	Pada xenInvoice	Pada tampilan pengguna (contoh: aplikasi eWallet, mobile banking, otentikasi kartu)
Virtual Account	Nama Partner	Nama Partner pada nama VA di mobile banking (dapat disesuaikan dengan parameter name)
Retail Outlet	Nama Partner	Nama Partner pada retail outlet (dapat disesuaikan dengan parameter name)
Kartu Kredit / Debit	Nama Partner	Nama Partner pada saat otentikasi dan bank statement
Direct Debit	Nama Partner	Nama Platform di aplikasi mobile banking
eWallet	Nama Partner	Nama Platform di aplikasi eWallet
QRIS	Nama Partner	Nama Platform di aplikasi yang mendukung QRIS

🇵🇭 Philippines (PH)

Metode Pembayaran	Pada xenInvoice	Pada tampilan pengguna (contoh: aplikasi eWallet, mobile banking, otentikasi kartu)
Retail Outlet	Nama Partner	Nama Partner pada retail outlet (dapat disesuaikan dengan parameter customer_name)
Kartu Kredit / Debit	Nama Partner	Nama Partner pada saat otentikasi dan bank statement
Direct Debit	Nama Partner	Nama Platform di aplikasi mobile banking
eWallet	Nama Partner	Nama Platform di aplikasi eWallet

Menerima event callback yang terjadi pada akun partner Anda

Platform harus memastikan bahwa Callback URL sudah berhasil terpasang pada level akun partner Anda. Contohnya, jika ingin menerima callback invoice yang berhasil terbayarkan dari akun partner maka Anda harus memastikan bahwa Callback URL untuk Invoice yang berhasil terbayarkan telah terpasang pada level akun partner tersebut.

Jika akun partner Anda adalah:

Akun Owned

Ketika Platform sudah melakukan pemasangan Callback URL pada level akun platform maka Callback URL yang sama juga akan terpasang secara otomatis pada level akun partner Anda. Contohnya, pada akun platform dipasang Callback URL untuk Invoice yang berhasil terbayarkan maka Callback URL yang sama juga akan terpasang pada level akun partner untuk Invoice yang terbayarkan tersebut.

* Lihat bagian batasan pengaturan dapat selaras untuk akun Owned yang sudah terbuat sebelumnya

Akun Managed

Partner Anda perlu melakukan pemasangan Callback URL melalui dasbor masing-masing. Terdapat 2 cara untuk melakukan pemasangan Callback URL untuk akun Managed:

Pemasangan melalui halaman pengaturan Callback URL pada dasbor akun Managed
Atau pemasangan Callback URL melalui API dengan hit POST /callback_urls/:type

Batasan pengaturan dapat selaras untuk akun Owned yang sudah terbuat sebelumnya

Terdapat batasan yang telah diketahui dimana ketika Platform melakukan pengaturan baru/perubahan maka pengaturan tersebut tidak dapat selaras secara otomatis bagi akun Owned yang sudah dibuat sebelum adanya pengaturan baru/perubahan. Batasan ini berlaku untuk pengaturan seperti berikut ini:

Metode pembayaran yang aktif

Jika Platform sudah membuat akun Owned terlebih dahulu sebelum metode pembayaran seperti OVO, Alfamart, dll aktif pada level akun Platform maka metode pembayaran tersebut hanya akan aktif secara otomatis untuk akun Owned yang dibuat setelahnya dan bukan yang sudah berhasil terbuat sebelumnya.

Pemasangan baru/perubahan pada Callback URL

Jika Platform sudah membuat akun Owned terlebih dahulu sebelum melakukan pemasangan Callback URL baru atau perubahan pada level akun Platform maka Callback URL tersebut hanya akan terpasang secara otomatis untuk akun Owned yang dibuat setelahnya dan bukan yang sudah berhasil terbuat sebelumnya.

Perubahan pengaturan invoice

Jika Platform sudah membuat akun Owned terlebih dahulu sebelum melakukan perubahan pengaturan invoice, contoh: melakukan perubahan opsi metode pembayaran yang ingin ditampilkan di invoice, pada level akun Platform maka perubahan tersebut hanya akan terlihat secara otomatis untuk akun Owned yang dibuat setelahnya dan bukan yang sudah berhasil terbuat sebelumnya.

Jika Anda sebagai Platform menemukan ketidakselarasan pengaturan terjadi pada akun Owned Anda maka berikut beberapa saran yang dapat Anda lakukan yaitu:

Kami menyarankan agar Platform melakukan pengaturan baru/perubahan terlebih dahulu sebelum melakukan pembuatan akun Owned dalam proses integrasi pertama kali
Untuk Callback URL yang tidak selaras, Platform dapat melakukan pemasangan Callback URL bagi akun Owned melalui API
Untuk metode pembayaran yang aktif dan pengaturan invoice yang tidak selaras, silakan hubungi kami untuk melakukan penyelarasan pengaturan

FAQ

1. Bagaimana cara akun Managed menerima pembayaran?

Akun Managed dapat menerima pembayaran melalui 2 cara:

Platform melakukan permintaan pembuatan pembayaran untuk akun Managed
Atau akun Managed dapat membuat permintaan pembayaran menggunakan API key akun Managed sendiri

2. Bagaimana cara akun Platform menerima pembayaran untuk akunnya sendiri?

Akun Platform dapat melakukan permintaan pembuatan pembayaran (contoh: pembuatan Invoice) dengan menggunakan API key akun Platform sendiri dan tidak perlu menambahkan parameter for-user-id.

Sistem PoS

Platform Point of Sales seperti ESB, Raptor POS dan lainnya menggunakan xenPlatform untuk menerima pembayaran, mengenakan biaya dan melakukan pembayaran secara mudah untuk partnernya.

Secara tipikal, pilihan integrasi untuk bisnis seperti ini adalah:

Pembuatan sebuah akun

Gunakan akun tipe MANAGED agar identitas partner Anda dapat terlihat oleh end customer dalam alur pembayaran seperti nama dan logo partner muncul pada OVO apps saat end customer melakukan pembayaran OVO

Mengelola pembayaran untuk partner

Menerima pembayaran atas nama partner Anda dengan menggunakan: i) Invoice dengan UI yang disediakan Xendit (xenInvoice), atau ii) Halaman pembayaran dengan UI yang di bangun sendiri oleh Anda dengan metode pembayaran yang tersedia pada kami
Automasi pengenaan biaya komisi per transaksi menggunakan fitur Platform fee kami

Memantau transaksi partner

Melihat transaksi milik partner Anda pada dasbor
Unduh laporan transaksi melalui dasbor untuk rekonsiliasi

Melakukan pembayaran untuk partner

Anda memiliki kendali penuh dalam menentukan kapan dan berapa besar nominal yang harus dibayarkan kepada partner
Gunakan produk pengiriman dana kami untuk melakukan pembayaran ke akun bank atau eWallet milik partner
Untuk akun MANAGED, Partner Anda dapat melakukan pencairan dana saldo Xendit ke rekening tujuan yang diinginkan secara langsung dari dasbor Xendit yang dimilikinya

Silakan hubungi kami jika Anda membutuhkan bantuan dalam proses integrasi

Reseller Layanan Pembayaran

Reseller layanan pembayaran seperti beberapa pemain regional dan global menggunakan xenPlatform untuk menerima pembayaran, mengenakan biaya dan melakukan pembayaran secara mulus untuk partnernya.