/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. |
Updated about 2 years ago