Merchant's onboarding Copy section link Copied!
You can onboard two types of Merchant in your marketplace platform, individual or business.
This page describes the onboarding process for each type.
How it works Copy section link Copied!
The onboarding process takes place in 3 main steps:
- Create a Merchant - The Merchant's required information is sent to AgoraPay by the Marketplace through the accountHolder/register API
- Manage account agreement - The Vendor digitally signs an account agreement sent directly by AgoraPay
- Validate a Merchant payment account - Required documentation is sent to AgoraPay by the Marketplace for KYC through the accountHolder/uploadDocument API
The Merchant's complete onboarding is validated or refused after KYC, screening and scoring by AgoraPay.
The following sections describe the complete process through the accountHolder API. However, you can also create a Merchant and validate a Vendor Payment Account through AgoraPay back-office. Check the detailed procedure here.
5 accountHolder API Copy section link Copied!
API
Description
Register
Creating a Merchant Enrollment Request
UploadDocument
Allows you to upload one document after another
RegistrationDetails
Allows you to know the progress of the enrollment request, for example to know which document is missing or refused
Update
Allows you to modify a current enrollment request (only while pending status)
Unregister
Cancel a Merchant request if it is considered to be obsolete
Merchant legal entity types Copy section link Copied!
AgoraPay supports the onboarding of many different legal entity types:
Business
- Individual entrepreneur and self-employed
- Non-profit organisation (Association)
- French company (SARL, SAS, SA, SNC, SCA, GIE, SCS, EURL)
- Foreign company
- Cooperative
Individual
- An individual
Required documentation and KYC Copy section link Copied!
Individual and Business Merchant need to provide valid identity documentation to go through the KYC process. The following documents are supported:
- Proof of Identity (i.e. National Identity Card or Passport)
- Company documentation
- Bank account information (i.e IBAN)
Check the complete guide to understand how to manage the documentation validation process for each Merchant based on their business legal type.
Note this list of required documentation can be updated without notice and your Merchants could be required to give additional information to re-validate their account.
Request cancellation Copy section link Copied!
There are few cases when a creation request can be deleted or cancelled:
- You can cancel a Merchant request if it is considered to be obsolete
- If there is a mistake in the legal type of the company or an update (change to the legal type) or that a company register number (SIRET) is already used, you can close the request and open a new one
You can use the /accountHolder/unregister API to cancel a request.
See how to manage it here from the API.