Overview
Fulfill the payment processing requirements of Platform businesses and Marketplace businesses
KOMOJU Platform Model aims to serve both Platform Businesses and Marketplace Businesses to process the payments between you and your sellers/users.
Alpha version
KOMOJU Platform Model is currently in alpha stage, so please expect that further fixes, improvements, changes, and adjustments will happen in the near future.
Business Use Case
Before adopting KOMOJU Platform Model, identifying which business use case applies to your business is essential. Platform Model supports two kinds of businesses - Platform Business and Marketplace Business. Here're the concise definitions of them:
- Platform Business: If your business connects buyers and sellers and empowers the sellers to accept payments online from customers directly, you’re likely an e-commerce platform that should adopt our Platform Use Case. (examples of Platform Business: Shopify, WooCommerce...etc)
- Marketplace Business: If your business manages the entire checkout journey and accepts payments online from customers directly on behalf of your sellers, you’re likely operating a marketplace that should adopt our Marketplace Use Case. (examples of Marketplace Business: Etsy, Airbnb, Uber...etc)
Besides, you can learn more about how to distinguish which use case applies to you on Business Use Case page.
Learn more details:
Onboard Accounts
Platform Use Case
You have to register a "Platform Merchant (Platform Business)" account in KOMOJU for your business entity via KOMOJU's dashboard. Overview of the procedure:
- Contact our Account Manager or send an inquiry via inquiry form to ask for a credential to log in KOMOJU's dashboard and access the "Test" environment.
- Integrate our APIs and create mock Seller Merchant accounts under your Platform Merchant (Platform Business) account via our APIs. After that, create mock payments to ensure the processing works well. Ultimately, it's better to execute further tests to ensure your overall API integration works well.
- Once you're ready to go live, please start the Live Application for your Platform Merchant (Platform Business) account on KOMOJU's dashboard.
- After your Live Application passes our review, you'll be able to register a Seller Merchant account for each seller via our APIs in the "Live" environment.
- After the application of the Seller Merchant account passes KOMOJU's review, you'll be able to start processing payments between you and your seller.
Learn more details:
Marketplace Use Case
You have to register a "Platform Merchant (Marketplace Business)" account in KOMOJU for your business entity via KOMOJU's dashboard. Overview of the procedure:
- Contact our Account Manager or send an inquiry via inquiry form to ask for a credential to log in KOMOJU's dashboard and access the "Test" environment.
- Integrate our APIs and create mock Payout Merchant accounts under your Platform Merchant (Marketplace Business) account via our APIs. After that, create mock payments to ensure the processing works well. Ultimately, it's better to execute further tests to ensure your overall API integration works well.
- Once you're ready to go live, please start the Live Application for your Platform Merchant (Marketplace Business) account on KOMOJU's dashboard.
- After your Live Application passes our review, you'll be able to register a Payout Merchant account for each seller via our APIs in the "Live" environment.
- After the application of the Payout Merchant account passes KOMOJU's review, you'll be able to start processing payments between you and your seller.
Learn more details:
Process Payments
Once you onboard yourself and your sub-merchant (either Seller Merchant or Payout Merchant) successfully, you'll be able to start processing payments between you two.
Within Payment function, several kinds of actions can be executed by Platform Merchant via KOMOJU API or dashboard:
| Action | KOMOJU API | KOMOJU Dashboard |
|---|---|---|
| Create a Payment | O | X |
| Two-step Capture | O | X |
| Cancel a Payment | O | O |
| Create a Reverse Refund | O | O |
| Create a Reverse Refund Request | O | O |
| Create a Non-Reverse Refund | O | X |
| Create a Non-Reverse Refund Request | O | X |
(1) If Platform Use Case applies to you, you should adopt "Seller Processing Model" to process payments while Seller Merchant is the Processing Merchant.
Learn more details:
(2) If Marketplace Use Case applies to you, you should adopt "Platform Processing Model" to process payments while Platform Merchant is the Processing Merchant.
Learn more details:
Balance Transfer
Within Balance function, two kinds of actions can be triggered by Platform Merchant via KOMOJU API only:
- Transfer balance from Platform Merchant to a sub-merchant
- Transfer balance from a sub-merchant to Platform Merchant
Learn more details:
Payouts
As a Platform Merchant, you can specify the Payout Frequency and Minimum Settlement Amount of your account and your sub-merchant's account respectively. Regarding Payout Frequency, we provide two options: weekly and monthly.
Based on the settings above, KOMOJU will pay the outstanding balance out to your bank account and your sub-merchant's bank account respectively. Therefore, you don't need to build a payout system by yourself, our product can handle this task for you automatically.
Learn more details:
Manage Accounts
As a Platform Merchant, you can access and manage all kinds of information about your account and your sub-merchants via our API or KOMOKJU Dashboard. In contrast, your sub-merchant can not access our API or Dashboard. Therefore, we provide significant flexibility to you so that you can fully control what kind of information you'd like to display to your sub-merchants on your application interfaces.
Learn more details:
Webhooks
As a Platform Merchant, you can subscribe to various events in Platform Model via Webhook for better management.
Learn more details:
Updated 24 days ago