Creating identities
You can obtain the IdentityID of your account in the Profile section of either the Public Mint Wallet or Partner Portal. Last but not the least, you can create identities via the API, as follows.
To create an identity you'll start by issuing a POST request to the /identities endpoint, with the required data.
If you are a business partner, you may be allowed to create and manage multiple identities on behalf of your customers. In this case, your API key will signal the API gateway that you have the proper authorization. Otherwise, trying to create more than one identity per account will return an error. Please refer to the KYC for companies section to learn what you need specifically for creating a company account.
// Request body:​{"name": "David McGreat","email": "[email protected]","birthday": "1991-01-01","gender": "Male","identityType": "person","companyOfficer": "false""identityOwner": ONLY FOR COMPANIES"address": {"street": "W Cass St","postalCode": 111222,"city": "Tampa","country": "US"},"phone": {"number": 444555666,"sms": true},"tax": {"idNumber": 1234567890,"state": "FL","country": "US"}}
// Response body:​{"name": "David McGreat","email": "[email protected]","birthday": "1991-01-01","gender": "Male","address": {"street": "W Cass St","postalCode": 111222,"city": "Tampa","country": "US"},"phone": {"number": 444555666,"sms": true},"tax": {"idNumber": 1234567890,"state": "FL","country": "US"}}
Every time you make such an authenticated request, the apikey in the header will be checked, thus ensuring only the owner of an identity can create transactions.
Congratulations! You've successfully created your identity and are ready to start transacting on Public Mint.
After you insert the identity, a verification will be created (this may take a moment). You can check the status of the verifications by making a call to the verifications endpoint.
The next step is to go through the KYC process and get your identity verified. The process is slightly different for individuals and companies.
Please note that in order to verify a company, you must first verify a Company Officer - an individual who will have accountability for the business account.
This person must go through the regular KYC as any individual, but flagged with the companyOfficer parameter set to true.
