FedaPay provides several types of accounts tailored to the specific needs of each user. Whether you are a company, an independent worker, an NGO, a government institution, operate a marketplace, or are a physical merchant, FedaPay offers a tailored solution to collect payments simply and securely. Below is an overview of the available options:
Who is it for?This account is specifically designed for marketplace platforms that connect sellers and buyers and wish to automate payment and commission management.Why choose this account?
Accepts all payment methods (Mobile Money, bank cards, etc.).
No limit on the number and amount of transactions.
Advanced feature: sub-account and commission management.
Required documents (KYC):
RCCM or company registration number.
Official RCCM document or proof of registration.
Name of the company manager.
ID document of the Founder / Manager / Director.
Copy of the ID document.
IFU number.
Supporting IFU document.
Sub-Account FeatureWith a Marketplace Account, you can integrate sub-accounts, allowing automatic payment distribution among multiple parties.Use Case Example :A marketplace connects multiple vendors. When a customer makes a purchase, a commission is deducted for the platform, and the remaining payment is automatically transferred to the relevant vendor.Conditions to activate sub-accounts :
A validated Marketplace Account.
At least one associated sub-account.
How Does Payment Distribution Work ?When you create a transaction on your marketplace, you can specify how the amount should be divided between the main account and service providers.Example of an API request for commission distribution :
//Replace YOUR_SECRET_API_KEY with the secret API key of your sandbox or live account. If you are using your live account, you must replace the link with https://api.fedapay.com/v1/transactionscurl -X POST \https://sandbox-api.fedapay.com/v1/transactions \-H 'Authorization: Bearer YOUR_SECRET_API_KEY' \-H 'Content-Type: application/json' \-d '{ "description" : "Transaction for john.doe@example.com", "amount" : 2000, "currency" : {"iso" : "XOF"}, "callback_url" : "https://maplateforme.com/callback", "customer" : { "firstname" : "John", "lastname" : "Doe", "email" : "john.doe@example.com", "phone_number" : { "number" : "+22997808080", "country" : "bj" } }, "sub_accounts_commisssions": [ { "reference": "acc_xxxxxxxxx", "amount": 1500 } ] }'
const { FedaPay, Transaction } = require('fedapay') /* Replace YOUR_API_KEY with your actual API key */ FedaPay.setApiKey("VOTRE_CLE_API_SECRETE"); /* Specify whether you want to run your query in test or live mode */ FedaPay.setEnvironment('sandbox'); //ou setEnvironment('live'); /* Create the transaction */ const transaction = await Transaction.create({ description: 'Description', amount: 2000, callback_url: 'https://maplateforme.com/callback', currency: { iso: 'XOF' }, customer: { firstname: 'John', lastname: 'Doe', email: 'john.doe@example.com', phone_number: { number: '97808080', country: 'BJ' } }, sub_accounts_commisssions: [ { reference: 'acc_xxxxxxxxx', amount: 1500 } ] });
/* Replace YOUR_API_KEY with your actual API key */ \FedaPay\FedaPay::setApiKey("YOUR_API_KEY"); /* Specify whether you want to run your query in test or live mode */ \FedaPay\FedaPay::setEnvironment('sandbox'); //ou setEnvironment('live'); /* Create the transaction */ \FedaPay\Transaction::create(array( "description" => "Transaction for john.doe@example.com", "amount" => 2000, "currency" => ["iso" => "XOF"], "callback_url" => "https://maplateforme.com/callback", "customer" => [ "firstname" => "John", "lastname" => "Doe", "email" => "john.doe@example.com", "phone_number" => [ "number" => "+22997808080", "country" => "bj" ] ], "sub_accounts_commisssions" => [ [ "reference" => "acc_xxxxxxxxx", "amount" => 1500 ] ] ));
In this example, 1,500 XOF will be transferred to the sub-account of the service provider (acc_xxxxxxxxx), while the main account retains the remaining amount after deducting FedaPay fees.
Note: The total distributed amount must be less than the transaction amount minus FedaPay commissions; otherwise, the transaction will fail.
Track Transactions & CommissionsFrom your FedaPay dashboard, you can monitor all transactions with commission distribution by viewing their details.
Invite a Provider to Join Your MarketplaceYou can invite a service provider to join your FedaPay Marketplace account directly from your dashboard.Steps to invite a business :
1
Go to the 'Marketplace' menu in your dashboard.
2
Click on 'Invite a Business' and fill in the necessary details.
3
Once the invitation is accepted, the provider can receive payments via your platform, and you can pay them commissions.
Automate Sub-Account Creation via APIFedaPay allows you to automate the onboarding of new providers by integrating the sub-account functionality directly into your system via API.Example code snippet for automating sub-account creation:
Curl
//Replace YOUR_SECRET_API_KEY with the secret API key of your sandbox or live account. If you are using your live account, you must replace the link with https://api.fedapay.com/v1/auth/sub_account_invitationscurl -X POST \ https://sandbox-api.fedapay.com/v1/auth/sub_account_invitations \ -H 'Authorization: Bearer YOUR_SECRET_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "email" : "john.doe@example.com", "full_name" : "Jonh Doe" }'
FedaPay ensures the verification and validation of the information to comply with KYC regulations.
When creating or updating a FedaPay account (Freelancer, Business, or Marketplace), it is essential to provide accurate tax information, based on your country of operation. This data is required for proper legal identification and regulatory compliance.Required Tax Identifiers by Country
🇧🇯 Benin
IFU (Unique Tax Identification Number)
🇸🇳 Senegal
IFU/NINEA (National Business and Association ID Number)
