Creating identities

Most API calls require an IdentityID to operate on, and there's a few ways to get one.

An identity is the core entity on Public Mint service. It represents an individual or company and is required to be able to execute most of the operations.

The creation of an identity is executed in 2 distinct steps:

1. Upload all the identity KYC documentation (ex: ID Card, proof-of-address, selfie, etc.) to Public Mint's AWS secure S3 bucket;

2. Create the identity passing the required information, including the documents uploaded from step 1.

Step 1 - Upload KYC documents

The first step when creating an identity is to upload the KYC documents to Public Mint's AWS secure S3 bucket.

You need to first request a pre-signed url for each of the documents to be uploaded, using the following API method:

POST /presign-url

POST [ENVIRONMENT_HOST]/presign-url

Request a pre-sign url for a document to be uploaded.

Request Body

Name	Type	Description
filename*	String	The name of the file to be uploaded

200: OK Response with the details to be used for upload.

{
    "data": {
        "url": "https://pmint-custodial-api-sandbox-identity-docs.s3.amazonaws.com/",
        "fields": {
            "key": "f1/ad/2a/17/Q9TdlaDeAqvdwrjM.jpeg",
            "bucket": "pmint-custodial-api-sandbox-identity-docs",
            "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
            "X-Amz-Credential": "ASIAXVB7MGLQKWDL2ONQ/20220401/eu-west-1/s3/aws4_request",
            "X-Amz-Date": "20220401T101751Z",
            "X-Amz-Security-Token": "FwoGZXIvYXdzEKT//////////wEaDMSysV9GDJK8pUzCMCLaASCB2eCZORx/NJqlFlHiC5fhSKE8UM5ZzbVWHAiUUAsHJhWKXIRSfsRQAFdTkxSR/mpqtXwGcDSI8B/v8KfIcq+gi+Zr1zSycaN2NyG0e53Rg6nsFTD5Wg4PIO2DkTmknFhvEjI5PhOBcfylSc3dBhu28H8JuYE422K28dI/1a2LoGhfZBXEmTXothptBpr9+SWGWaG1ESigDdGdYa3lalSnS0jycLAPZUR4a3ZyEh3phVDPN3y/a84Zv/3UnWON29fS6+j1nk4aD11NHV/WLu0mHeL+2+uUs5RDKM+im5IGMi2R1GxPnv2bqIgYpd8VCUPEDOOX3/x3zjeTCdBBNlKZi9uM9pFwdDO1GPwjcKQ=",
            "Policy": "eyJleHBpcmF0aW9uIjoiMjAyMi0wNC0wMVQxMDozMjo1MVoiLCJjb25kaXRpb25zIjpbeyJrZXkiOiJmMS9hZC8yYS8xNy9ROVRkbGFEZUFxdmR3cmpNLmpwZWcifSx7ImJ1Y2tldCI6InBtaW50LWN1c3RvZGlhbC1hcGktc2FuZGJveC1pZGVudGl0eS1kb2NzIn0seyJYLUFtei1BbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJYLUFtei1DcmVkZW50aWFsIjoiQVNJQVhWQjdNR0xRS1dETDJPTlEvMjAyMjA0MDEvZXUtd2VzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LHsiWC1BbXotRGF0ZSI6IjIwMjIwNDAxVDEwMTc1MVoifSx7IlgtQW16LVNlY3VyaXR5LVRva2VuIjoiRndvR1pYSXZZWGR6RUtULy8vLy8vLy8vL3dFYURNU3lzVjlHREpLOHBVekNNQ0xhQVNDQjJlQ1pPUngvTkpxbEZsSGlDNWZoU0tFOFVNNVp6YlZXSEFpVVVBc0hKaFdLWElSU2ZzUlFBRmRUa3hTUi9tcHF0WHdHY0RTSThCL3Y4S2ZJY3ErZ2krWnIxelN5Y2FOMk55RzBlNTNSZzZuc0ZURDVXZzRQSU8yRGtUbWtuRmh2RWpJNVBoT0JjZnlsU2MzZEJodTI4SDhKdVlFNDIySzI4ZEkvMWEyTG9HaGZaQlhFbVRYb3RocHRCcHI5K1NXR1dhRzFFU2lnRGRHZFlhM2xhbFNuUzBqeWNMQVBaVVI0YTNaeUVoM3BoVkRQTjN5L2E4NFp2LzNVbldPTjI5ZlM2K2oxbms0YUQxMU5IVi9XTHUwbUhlTCsyK3VVczVSREtNK2ltNUlHTWkyUjFHeFBudjJicUlnWXBkOFZDVVBFRE9PWDMveDN6amVUQ2RCQk5sS1ppOXVNOXBGd2RETzFHUHdqY0tRPSJ9XX0=",
            "X-Amz-Signature": "2b9a7f914ce0d8aa5a16b3ae5811c4668f3714212c4f4eb34742c960729d79fb"
        }
    }
}

With the response from the previous request, you can upload the file to aWS S3 bucket. Please refer to AWS documentation on how to do that.

Step 2 - Create the identity

With the documents uploaded to the S3 bucket, the next step is create the identity on the Public Mint services, passing all the information including the uploaded documents. Refer to the Identities API for details on how to do it.