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, clarifying which business use case applies to your business is essential. Platform Model supports two kinds of businesses - Platform Business and Marketplace Business. Here's a concise definition of them:

  1. 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 Payments, WooPayments...etc)
  2. 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 Platform 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:

  1. Business Use Case
  2. Platform User Case
  3. Marketplace User Case

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:

  1. Contact our Account Manager or inquiry form to ask for a credential to log in KOMOJU's dashboard and access the "Test" environment.
  2. Integrate our APIs and create mock Seller Merchant accounts under your Platform Merchant (Platform Business) account via our APIs, and execute further tests to ensure the integration goes well.
  3. Once you're ready to go live, please start the Live Application for your Platform Merchant (Platform Business) account on KOMOJU's dashboard.
  4. After your Live Application passes our review, you're ready to register a Seller Merchant account for each seller via our APIs in the "Live" environment.
  5. After the application of the Seller Merchant account passes KOMOJU's review, you're 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:

  1. Contact our Account Manager or inquiry form to ask for a credential to log in KOMOJU's dashboard and access the "Test" environment.
  2. Integrate our APIs and create mock Payout Merchant accounts under your Platform Merchant (Marketplace Business) account via our APIs, and execute further tests to ensure the integration goes well.
  3. Once you're ready to go live, please start the Live Application for your Platform Merchant (Marketplace Business) account on KOMOJU's dashboard.
  4. After your Live Application passes our review, you're ready to register a Payout Merchant account for each seller via our APIs in the "Live" environment.
  5. Once the application of the Payout Merchant account passes KOMOJU's review, you're 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.

From a Payment perspective, several kinds of actions can be executed by Platform Merchant via KOMOJU APIs or dashboard:

  • Create a Payment
  • Two-step Capture (for Credit Card type payments)
  • Create a Reverse Refund
  • Create a Reverse Refund Request
  • Create a Non-Reverse Refund
  • Create a Non-Reverse Refund Request

(1) If Platform Use Case applies to you, you'll have to adopt "Seller Processing Model" to process payments because Seller Merchant is the Processing Merchant.

Learn more details:

(2) If Marketplace Use Case applies to you, you'll have to adopt "Platform Processing Model" to process payments since Platform Merchant is the Processing Merchant.

Learn more details:

Balance Transfer

From a Balance perspective, two kinds of actions can be triggered by Platform Merchant via KOMOJU APIs:

  • 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're able to specify the Payout Frequency and Minimum Settlement Amount of your account and your sub-merchant's account independently. 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 system to execute payouts, we can handle this task for you.

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, so you can fully control what kinds of information you'd like to display to your sub-merchants on your interfaces.

Learn more details: