1
Prerequisites
- Have a main account (Marketplace account type)
- Have at least one sub-account associated with the main account.
2
Context
It is common to see services offering a marketplace. A marketplace is a platform where multiple service providers are registered to sell their products or services. These marketplace platforms each operate differently, but the payment process is often quite similar. For a product sold on the platform, the platform receives a commission, and the remaining amount is transferred to the service provider.FedaPay provides everything you need to register service providers, manage your payments, send payouts, and much more.
3
Creating a Transaction with Commission Splitting
Here, we assume that the marketplace application knows the FedaPay reference of each service provider’s account. This is required to specify the commission to be distributed between the service providers and the main FedaPay account of the marketplace platform.
When a FedaPay transaction is created, the application must specify how much of the collected amount should be allocated to third parties, in this case, the service providers. Most often, a transaction involves a single service provider. However, it is possible to have several service providers.Here is an example of an HTTP request for creating a transaction with a commission split to a FedaPay sub-account belonging to a service provider:acc_xxxxxxxxx represents the FedaPay account reference of the service provider’s account.Therefore, once the transaction is approved, the amount of 1,500 F will be transferred to the service provider’s account, while the main account will keep the difference. It is important to note that the amount to be distributed must be less than the transaction amount minus FedaPay fees; otherwise, the commission split will fail.
When a FedaPay transaction is created, the application must specify how much of the collected amount should be allocated to third parties, in this case, the service providers. Most often, a transaction involves a single service provider. However, it is possible to have several service providers.Here is an example of an HTTP request for creating a transaction with a commission split to a FedaPay sub-account belonging to a service provider:
Curl
4
Use Case Example
5
Checking a Transaction and Its Commissions
From the FedaPay dashboard of the main account, you can check a transaction with a commission split by viewing the transaction details.
6
Inviting a Service Provider's Sub-Account to Your FedaPay Account from the Dashboard
You can invite a service provider to your FedaPay account. Simply click the Marketplace menu.
This menu is only available if you have a Marketplace account. Then, click Invite a business and fill in the company’s information.
Once the invitation is accepted, the company will join your FedaPay account, and you can send commissions to it.
7
Registering a Business Programmatically
It is possible to integrate new sub-accounts into your FedaPay account, meaning that you can automate the addition of new accounts. FedaPay helps you collect and verify identity information to comply with KYC and regulatory requirements.
Curl