Terima Pembayaran untuk Sub-Akun

Terima Pembayaran untuk Partner

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:

  1. Indonesia
  2. Filipina

Indonesia

Metode PembayaranOwnedManaged
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 PembayaranOwnedManaged
Kartu Kredit / Debitℹ️
Retail Outlet
Direct Debit
Ewallet
Ewallet - GCashℹ️
Paylater

* Tidak tersedia apabila partner register sebagai bisnis individu

ℹ️ Channel ini memerlukan aktivasi terpisah untuk Owned Sub-Accounts. Berikut adalah panduan untuk proses aktivasi.

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 PembayaranPada xenInvoicePada tampilan pengguna (contoh: aplikasi eWallet, mobile banking, otentikasi kartu)
Virtual AccountNama PartnerNama Partner pada nama VA di mobile banking (dapat disesuaikan dengan parameter name)
Retail OutletNama PartnerNama Partner pada retail outlet (dapat disesuaikan dengan parameter name)
Kartu Kredit / DebitNama PartnerNama Partner pada saat otentikasi dan bank statement
Direct DebitNama PartnerNama Platform di aplikasi mobile banking
eWalletNama PartnerNama Platform di aplikasi eWallet
QRISNama PartnerNama Platform di aplikasi yang mendukung QRIS

🇵🇭 Philippines (PH)

Metode PembayaranPada xenInvoicePada tampilan pengguna (contoh: aplikasi eWallet, mobile banking, otentikasi kartu)
Retail OutletNama PartnerNama Partner pada retail outlet (dapat disesuaikan dengan parameter customer_name)
Kartu Kredit / DebitNama PartnerNama Partner pada saat otentikasi dan bank statement
Direct DebitNama PartnerNama Platform di aplikasi mobile banking
eWalletNama PartnerNama 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:

  1. Pemasangan melalui halaman pengaturan Callback URL pada dasbor akun Managed
  2. 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:

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.

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.

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:

  1. Kami menyarankan agar Platform melakukan pengaturan baru/perubahan terlebih dahulu sebelum melakukan pembuatan akun Owned dalam proses integrasi pertama kali
  2. Untuk Callback URL yang tidak selaras, Platform dapat melakukan pemasangan Callback URL bagi akun Owned melalui API
  3. 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:

  1. Platform melakukan permintaan pembuatan pembayaran untuk akun Managed
  2. 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.

Last Updated on 2024-05-30