HomeGuidesRecipesAPI ReferenceChangelog
Log In

How to create a Corporate entity

Corporate entities are independent entities that can be linked to Individual users. Individuals can hold different roles in each Corporate they are attached to. Individuals can be linked to multiple Corporates.

1. Setup the ADMINISTRATOR of the Corporate

The first step in creating a Corporate entity is to check if the individual who will be set as the.ADMINISTRATOR of the Corporate is already signed up with Unblock or not. In case the Admin of the Corporate is not yet signed up with Unblock, this can be done as described here:

📘

An Admin of a Corporate does not need a full personal Unblock account

A Individual who is administrator of a Corporate entity with Unblock does not need a personal 0x wallet or Remote Bank account or Unblock bank account to be setup. They can be setup using OTP and not have anything else but a user uuid.

2. KYC the ADMINISTRATOR of a Corporate entity

It is recommended to use the UBO (Ultimate Beneficiary Owner) as the ADMINISTRATOR of the Corporate entity. Because of this, Unblock will need to KYC this Individual. The different KYC processes supported by Unblock are described here

3. Create the Corporate entity

Finally, we can create a corporate entity; this can be achieved using this endpoint

curl --request POST \
     --url https://api.getunblock.com/corporate \
     --header 'Authorization: <<API key>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "type": "LIMITED_LIABILITY",
  "contact_details": {
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+44787878787878"
  },
  "registered_address": {
    "address_line_1": "1 drive",
    "post_code": "NG72DU",
    "country": "GB"
  },
  "legal_name": "Unblock ltd",
  "registration_number": "12345",
  "target_address": "0x8C8D7C46219D9205f056f28fee5950aD564d7465"
}
'

4. Add the Individual as an ADMINISTRATOR

Once the Admin user and the Corporate are set up, it is time to link them together. One user can be linked to multiple Corporates; it is essential to add the uuid of the Corporate to ensure a user is linked to the correct Corporate.

Here is an example of the endpoint called to add a user to a Corporate

curl --request POST \
     --url https://api.getunblock.com/corporate/b13deca4-7051-485c-9f6d-6b99d3a46043/user \
     --header 'Authorization: API-Key Rw6S6geZDASAjf/lOnf86PlzlzZ6VEYTiQzzVuN8fmhYdxaGhaWmgyqus5B3eFaC' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "user_uuid": "9a9a7b16-848e-4221-82d0-a9fabec04e4c",
  "role": "ADMINISTRATOR"
}
'

5. Setup remote and unblock bank accounts

Once an Individual is linked to a Corporate, a Merchant can do all the same operations that can be done for an Individual on the Corporate account. This includes:

  • creating a Remote bank account as a target for a cryptoToFiat transaction
  • creating an Unblock bank account as a target for a fiatToCrypto transaction
  • changing default token preferences.
  • etc.

The only significant difference between a Corporate operation and an Individual operation is that a Corporate one needs to be authenticated by an Administrator or the Corporate. In the header of each Corporate endpoint call, the Merchant will also need to include a session_id of one of theADMINISTRATOR of the Corporate.

The authentication for an Individual process is described here

6. Submit KYB documentation to Unblock

The last step to fully set up a Corporate with Unblock is to submit all the KYB documents to our systems.

This can be done embedded in the Merchant platform using the link that can be retrieved with this API call:

curl --request GET \
     --url https://api.getunblock.com/corporate/a72cb622-8951-429e-82c7-cdb178392012/kyb/applicant/url \
     --header 'Authorization: API-Key {{API KEY}}' \
     --header 'accept: application/json' \
     --header 'unblock-session-id: a72cb622-8951-429e-82c7-cdb199448fd8'

This will return a link that can embedded in a webpage using the following iFrame code:

<div data-tf-widget="QGjCZNZB" data-tf-opacity="100" data-tf-iframe-props="title=Know Your Business" data-tf-transitive-search-params data-tf-medium="snippet" data-tf-hidden="corporate_uuid=" style="width:100%;height:500px;"></div><script src="//embed.typeform.com/next/embed.js"></script>

Once a Corporate has completed the KYB process in this form and Unblock has had time to review the system, the Merchant will get a webhook action confirming the approval or rejection of the Corporate.