/certify_business

Certifies that all major beneficial owners (25% stake and higher) have been registered, linked, and individually certified for this business.

Most business types require certification after verification to transact, meaning that a business administrator must ascertain and certify that all beneficial owners (there could be 0) have accurate personal information and ownership stakes registered.

To certify a business at this endpoint, the business must have passed verification first and all beneficial owners must either be unlinked or certified.

A list of business types requiring certification is provided here: https://docs.silamoney.com/docs/get_business_types

  

Requests

header.user_handle should have the handle of the administrator performing the certification.
header.business_handle should have the registered business entity of which the specified individual and administrator are members.

Headers authsignature, usersignature, and businesssignature are required for this request. The usersignature header should be generated with a keypair registered to the individual user identified by the header.user_handle key (either registered from the /register endpoint or the /register_wallet endpoint). The businesssignature header should be generated with a keypair registered to the business user (either registered from the /register endpoint or the /register_wallet endpoint). See authentication section for more details on how to generate this signature.

Note - We recently renamed the field auth_handle to app_handle. For backward compatibility, auth_handle is still valid but has been removed from our documentation.

  
POST /0.2/certify_business HTTP/1.1
Host: sandbox.silamoney.com
authsignature: [GENERATED AUTHSIGNATURE HEX STRING HERE]
usersignature: [GENERATED USERSIGNATURE HEX STRING HERE]
businesssignature: [GENERATED BUSINESSSIGNATURE HEX STRING HERE]
Content-Type: application/json

{
    "header": {
        "created": 1234567890,
        "app_handle": "your_app_handle",
        "user_handle": "your_admin_user",
        "business_handle": "your_business_user",
        "reference": "<your unique id>"
    }
}

***

HTTP/1.1 200 OK

{
    "success": true,
    "status": "SUCCESS",
    "message": "Business successfully certified.",
    "response_time_ms": "171",
    "reference": "<your unique id>"
}
const res = await sila.certifyBusiness(
  user_handle,
  user_private_key,
  business_handle,
  business_private_key
);

// Success response object

console.log(res.statusCode); // 200
console.log(res.data.success); // TRUE
console.log(res.data.message); // Response message
console.log(res.data.status);
payload = {
    "user_handle": user_handle,
    "business_handle": business_handle
}

response = BusinessOperations.certifyBusiness(app, payload, user_private_key, business_private_key)

# Success Response

{
    "status": 'SUCCESS',
    "status_code": 200,
    "success": true,
    "message": "Business successfully certified."
}
ApiResponse response = api.certifyBusiness("user handle", "user private key", "business handle", "business private key");

// Success Object Response
  
System.out.println(response.getStatusCode()); // 200
System.out.println(((BaseResponse) response.getData()).getMessage()); // Business successfully certified
System.out.println(((BaseResponse) response.getData()).getSuccess()); // true
System.out.println(((BaseResponse) response.getData()).getStatus()); // SUCCESS
$businessHandle = 'business.silamoney.eth';
$businessPrivateKey = 'some private key';
$userHandle = 'user.silamoney.eth'; // Must be a registered administrator in the business
$userPrivateKey = 'some other private key';

$response = $client->certifyBusiness($businessHandle, $businessPrivateKey, $userHandle, $userPrivateKey);

// Response 200 

echo $response->getStatusCode(); // 200
echo $response->getData()->status;
echo $response->getData()->success; // TRUE
echo $response->getData()->message; // Business successfully certified
Console.WriteLine(response.Success);
Console.WriteLine(response.Status);
ApiResponse<object> response = api.CertifyBusiness(userHandle, privateKey, businessHandle, businessPrivateKey);

// Success object response

Console.WriteLine(response.StatusCode); // 200
var parsedData = (BaseResponse)response.Data;
Console.WriteLine(response.Message); // Business successfully certified
  

Responses

Status Code

success Attribute

Description

200

true

The business has been successfully certified.

400

false

Bad request format - check validation_details for more information.

403

false

authsignature, businesssignature, or usersignature header was absent or incorrect or the certification token was invalid.


Did this page help you?