LogoLogo
  • Introduction
  • Core Concepts
  • Partner setup
  • Tutorials [WIP]
    • Create Identities
    • Create a Blockchain Address
    • Payout Service
  • Public Mint Widget
    • Getting started
    • Embed Widget
      • Deposit of funds
      • Withdraw of funds
  • Public Mint API
    • Getting started
    • Creating identities
    • Connecting to the blockchain
      • Running your own client node
    • Executing Transactions
      • Depositing
      • Wallet Transactions
      • Withdrawing
    • Sandbox
    • API Reference
      • Identities
      • Operations
      • Transfer Methods
      • Transactions
      • Withdrawals (deprecated)
      • Verifications
      • Identity Relations
      • Documents
      • Deposits (deprecated)
      • Authentication
      • Pagination
      • Errors
      • Core Resources
    • Webhooks
  • Public Mint Blockchain
    • Getting started
    • Transacting
    • Configuring Metamask for the Public Mint blockchain
    • Interoperability [WIP]
  • Other Information
    • Public Mint Wallet
    • Users and Accounts
Powered by GitBook
On this page
  • Step 1 - Upload KYC documents
  • POST /presign-url
  • Step 2 - Create the identity

Was this helpful?

  1. Public Mint API

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

{
    "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"
        }
    }
}

Step 2 - Create the identity

PreviousGetting startedNextConnecting to the blockchain

Last updated 3 years ago

Was this helpful?

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

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 for details on how to do it.

AWS documentation
Identities API