Anda dapat membuat sub-akun menggunakan dua metode:
Melalui dasbor Anda: Direkomendasi jika Anda melakukan onboarding secara manual kepada setiap merchant.
Melalui API: Direkomendasi jika Anda ingin mengotomatiskan onboarding merchant Anda.
Cara membuat sub-akun melalui dasbor
Buka Accounts tab dan klik +Add an account, lalu pilih jenis sub-akun.
Jika Anda memilih akun Managed , ada dua opsi berbeda untuk mengundang merchant Anda mendaftar:
Kirim undangan: Kami akan mengirimkan link unik ke email yang dimasukkan untuk mengundang merchant Anda untuk mendaftar ke Xendit.
Salin link unik: Anda dapat menyalin dan membagikan link unik ini ke merchant Anda, yang akan mengarahkan mereka ke halaman pendaftaran yang sama. Setelah pendaftaran, akun mereka akan dibuat sebagai sub-akun di bawah akun Master Anda.
Membuat sub-akun melalui API
Anda dapat membuat sub-akun melalui API dan menentukan jenisnya di request body. Anda wajib memberikan parameter berikut:
business_name: Untuk mengidentifikasi sub-akun Anda. Nama bisnis yang Anda tetapkan akan menjadi nama yang ditampilkan kepada pelanggan yang membayar kepada merchant Anda menggunakan link pembayaran.business_email: Alamat email yang terkait dengan sub-akun.Anda dapat menggunakan kembali alamat email untuk sub-akun Owned
Xendit mengirimkan email undangan hanya untuk sub-akun Managed. Sub-akun Owned masih memerlukan alamat email tetapi tidak akan menerima email apa pun setelah pembuatan.
curl --request POST \ --url https://api.xendit.co/v2/accounts \ --data '{"account_email":"user@example.com","type":"OWNED","public_profile":{"business_name":"Merchant1"}}' Setelah akun Anda dibuat, Anda akan dapat melihatnya di halaman Akun xenPlatform.
Konfigurasi sub-akun kustom
Saat membuat akun melalui API, Anda dapat mengatur konfigurasi yang berbeda di bawah ini alih-alih memilih .type
Konfigurasi | Deskripsi |
|---|---|
has_dashboard | Menentukan apakah akses dasbor akan diaktifkan. Undangan akan dikirim ke alamat email sub-akun untuk mendaftar dan login. |
payment_settings_follow_platform | Menentukan apakah sub-akun akan menggunakan metode pembayaran yang diaktifkan akun Master. Jika "true", faktur dan webhook Xendit akan dikirim ke Platform, dan nama bisnis yang ditampilkan kepada publik akan menjadi milik Platform. |
has_withdrawal | Menentukan apakah penarikan akan diaktifkan untuk sub-akun. Ini akan mengharuskan akun untuk menyelesaikan aktivasi saat masuk. |
Di bawah ini adalah kemungkinan konfigurasi tergantung pada kebutuhan Anda:
Pengaturan yang diinginkan | Kasus penggunaan | Konfigurasi |
|---|---|---|
Sub-akun Owned + Penarikan | Merchant Anda dapat segera mulai menerima pembayaran. Verifikasi bisnis harus diselesaikan sebelum merchant dapat menarik dana. |
|
Sub-akun Owned + undangan akses Dasbor | Merchant Anda dapat segera mulai menerima pembayaran. Undangan dikirim ke email bisnis untuk masuk. |
|
Sub-akun Owned | Konfigurasi ini sama dengan sub-akun Owned default. |
|
Sub-akun Managed | Konfigurasi ini sama dengan sub-akun Managed default. |
|
Konfigurasi webhook
Peristiwa di sub-akun Anda dikirim ke URL webhook yang berbeda berdasarkan jenis sub-akun.
Owned: Dikirim ke konfigurasi webhook akun master. Namun, perhatikan bahwa pengaturan webhook hanya disinkronkan selama pembuatan akun. Setiap perubahan pada konfigurasi webhook akun master setelah sub-akun dibuat tidak akan secara otomatis berlaku untuk sub-akun yang Owned. Harap hubungi kami saat Anda memperbarui konfigurasi webhook sehingga kami dapat menyinkronkan konfigurasi untuk Anda.
Managed: Dikirim ke konfigurasi webhook sub-akun, yang dapat diatur di dasbor sub-akun atau menggunakan Webhook URL API.
Testing
Sub-akun dapat dibuat saat akun master Anda masih dalam Mode Tes. Sub-akun pengujian memungkinkan Anda membuat transaksi tiruan menggunakan API key tes dan melihat transaksi muncul di dasbor Anda dalam Mode Tes. Anda dapat menghapus sub-akun di dasbor Anda hanya dalam Mode Tes.