Bahasa Indonesia
API ReferenceLogin

Terima Pembayaran untuk Partner

Last updated 01/12/2022

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 - Aggregator
Virtual Account - Switcher*
Kartu*
Retail Outlet*
Direct Debit
Ewallet
QR Code
Paylater

*Tidak tersedia apabila partner register sebagai bisnis individu

Filipina

Metode PembayaranOwnedManaged
Kartu
Retail Outlet
Direct Debit
Ewallet
Paylater

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

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.