Onboarding Process
After an account for a sub-merchant has been created, two records are created: a test merchant and a live merchant record. The live merchant is not immediately usable. In order to conduct real-money transactions, the live merchant must go through the onboarding process first.
Unlike the Accounts API, the Onboarding API operates at the merchant level. For platform merchants using the Onboarding API on behalf of its sub-merchants, please refer to the Dual Authentication documentation.
File Uploading
Some API calls here require some additional paperwork to be submitted via file upload. For this purpose, we provide the Files API that can be used for general file uploading.
The Onboarding API requires file UUIDs that can be obtained by uploading the appropriate files requested via the Files API.
4 Basic Information Types
Company Information Must be Submitted First
The very first step of the onboarding process is to submit the company information. Without this information, other information cannot be submitted, due to different paperwork requirements that are dependant on the company information details.
Two corporation types are supported: "corporation" or "sole proprietor". Depending on the corporation type, you must upload either an incorporation certificate or extract of business registration, or proof of sole proprietorship registration. Note that Japanese corporation merchants are exempt from this requirement.
Please upload these documents in advance using the Files API in order to obtain the UUID of the uploaded files.
Examples of company information fields are company name, company URL, company address, company share capital, etc. For more details, please see the Company Information API Reference
Submitting Personal Information
Once the company information has been submitted, the API caller can subsequently submit the personal information of the personnel involved.
Please upload a picture or scan of both sides of a government issued identification document (passport, residence card, driver's license, or a Japanese My Number Card). Ensure that the information is clearly displayed. For passports, the photograph page is sufficient.
Please upload these documents in advance using the Files API in order to obtain the UUID of the uploaded files.
Examples of personal information fields are the representative director name, the representative director address, etc. For more details, please see the Personal Information API Reference.
Submitting the Site Information
Once the company information has been submitted, the API caller can subsequently submit the site information.
Please note the merchant must read and agree to our acceptable use policy.
Also, a Specified Commercial Transaction Act page is required when operating an online shop in Japan. During the review process, we will check if the provided page exists and its contents. For more details, please see What is the Specified Commercial Transactions Law? or Article of Specified Commercial Transaction Law (PDF:166KB).
If your business requires a sales permit, please upload these documents in advance using the Files API in order to obtain the UUID of the uploaded files.
Examples of site information fields are site name, store address, etc. For more details, please see the Site Information API Reference.
Submitting the Bank Account Information
Once the company information has been submitted, the API caller can subsequently submit the Bank Account information.
Three types of bank accounts are supported: domestic (Japanese), SWIFT, and SEPA. The bank account submission only requires a bank statement for merchants outside of Japan.
Please upload these documents in advance using the Files API in order to obtain the UUID of the uploaded files.
Examples of site information fields are bank branch code, SWIFT account number, etc. For more details, please see the Bank Account Information API Reference.
Applying for Payment Methods
After all the above basic information has been submitted, you are ready to apply for payment methods. You will only be required to submit the information necessary for the payment methods you apply for.
If you plan on using API integration and you wish to apply for credit card payment methods, you must submit proof of PCI compliance. Please upload these documents in advance using the Files API in order to obtain the UUID of the uploaded files.
For more details, please see the Payment Methods Information API Reference.
Waiting for Onboarding Approval
After submitting the above information, KOMOJU will review all provided information and file uploads. We will contact you if there are any problems during the review process. You will also be notified once your application has been approved, enabling the sub-merchant to start processing real-money transactions using the live merchant.