Model Data - Merchant

Ikhtisar Merchant

Model data Merchant mendefinisikan struktur untuk identifikasi merchant dan informasi hierarki dalam transaksi pembayaran. Model ini mengkapsulasi kredensial merchant, hubungan hierarki, dan informasi entitas bisnis.

Struktur Model Data

Parameter	Tipe	Deskripsi
merchantId	String	Identifier merchant utama yang ditugaskan oleh platform Format: String alfanumerik Penggunaan: Identifier unik untuk autentikasi merchant dan routing transaksi Contoh: "20001", "20011"
merchantName	String	Nama bisnis merchant utama Format: String yang dienkripsi UTF-8 Penggunaan: Nama tampilan untuk identifikasi merchant dan pelaporan Contoh: "Betty", "ABC Corporation"
subMerchantId	String	Identifier sub-merchant untuk struktur hierarkis Format: String alfanumerik Penggunaan: Mengidentifikasi sub-merchant dalam hierarki merchant utama Contoh: "2000101", "2000102"
subMerchantName	String	Nama bisnis sub-merchant Format: String yang dienkripsi UTF-8 Penggunaan: Nama tampilan untuk identifikasi sub-merchant dan pelaporan Contoh: "Devin", "XYZ Subsidiary"

Struktur Hierarki Merchant

Merchant Utama

• Peran: Entitas bisnis utama yang terdaftar dengan platform
• Tanggung Jawab: Pemegang akun utama, penerima settlement, manajemen kepatuhan
• Identifikasi: merchantId unik yang ditugaskan oleh platform

Sub-Merchant

• Peran: Anak perusahaan atau cabang di bawah merchant utama
• Tanggung Jawab: Pemrosesan transaksi, operasi lokal, layanan pelanggan
• Identifikasi: subMerchantId yang terkait dengan merchantId utama

Contoh Implementasi

{
  "merchantId": "20001",
  "merchantName": "Betty"
}

{
  "merchantId": "20001",
  "merchantName": "Betty",
  "subMerchantId": "2000101",
  "subMerchantName": "Devin"
}

{
  "merchantId": "20001",
  "merchantName": "ABC Corporation",
  "subMerchantId": "2000102",
  "subMerchantName": "XYZ Subsidiary"
}

Kasus Penggunaan Bisnis

Operasi Merchant Tunggal

• Bisnis Kecil: Registrasi dan operasi merchant langsung
• Struktur Sederhana: Titik kontak dan settlement tunggal
• Implementasi: Gunakan hanya merchantId dan merchantName

Operasi Merchant Multi-Tier

• Operasi Franchise: Beberapa lokasi di bawah perusahaan induk tunggal
• Jaringan Agen: Agen independen yang beroperasi di bawah merchant utama
• Implementasi: Gunakan struktur sub-merchant untuk manajemen hierarkis

Integrasi Platform

• Autentikasi API: merchantId digunakan untuk autentikasi request
• Routing Transaksi: subMerchantId untuk routing unit bisnis spesifik
• Manajemen Settlement: Dukungan struktur settlement hierarkis

Keamanan dan Kepatuhan

Autentikasi Merchant

• Validasi ID: Semua ID merchant harus terdaftar dan divalidasi sebelumnya
• Kontrol Akses: Sub-merchant mewarisi izin dari merchant utama
• Audit Trail: Pelacakan lengkap perubahan hierarki merchant

Manajemen Data

• Integritas Hierarki: Pertahankan hubungan parent-child yang tepat
• Konsistensi Nama: Pastikan nama merchant sesuai dengan registrasi resmi
• Prosedur Pembaruan: Prosedur yang tepat untuk pembaruan informasi merchant

Kepatuhan Regulasi

• Registrasi Bisnis: Semua merchant harus memiliki registrasi bisnis yang valid
• Persyaratan KYC: Kepatuhan know-your-customer untuk semua tingkat merchant
• Persyaratan Pelaporan: Pelaporan hierarkis untuk kepatuhan regulasi