Creating a New Channel
For each distributor channel, you can create a channel object by providing the required properties.
Endpoint
/api/channels/ā¦.your-channel-idā¦./channels
The channel-id is the userID that you get from the login call as described above.
Request Type
POST
Headers
Content-type: āapplication/jsonā -> This is constant
Authorization: āyour access tokenā -> You will receive the access token from the login API call as described above.
JSON Payload
{
"product_productId": ".........",
"product_customerId": ".........",
"product_accessToken": ".........",
"control_active": true,
"control_allowedCount": 20,
"control_updateProductInfo": true,
"control_selfUpdation": true,
"control_updateControls": true,
"control_createChildren": true,
"control_enableFrontendURLs": false,
"disableEmailFromAmc": false,
"username": ".........",
"password": ".........",
"email": ".........",
"callbackOnAction": {
"accepted": "...",
"rejected": "...",
"draft": "..."
},
"pageCallbackUrl": {
"identity": ".....",
"address": ".....",
"corraddress": ".....",
"bankaccount": ".....",
"documents": ".....",
"fatca": ".....",
"signature": ".....",
"photo": ".....",
"video": ".....",
"contract": ".....",
"submit" : "....."
}
}The API accepts the following properties as detailed in the table below:
Property | Data Type | Example Values |
|---|---|---|
username | String | username |
password | String | password |
String | ||
product_productId | String | investorOnbaording |
product_customerId | String | 5219872648addff |
product_accessToken | String | whr320jrehbfdvipkqwmnh |
control_active | Boolean | true/false |
control_allowedCount | Integer | Integer |
control_updateProductInfo | Boolean | true/false |
control_selfUpdation | Boolean | true/false |
control_updateControls | Boolean | true/false |
control_createChildren | Boolean | true/false |
control_enableFrontendURLs | Boolean | true/false |
disableEmailFromAmc | Boolean | true/false |
callbackOnAction | Object |  |
pageCallbackUrl | Object |  |
Field Descriptions
product_productId
This information tells what Signzyās product does this particular channel allowed to push data into.
value = 'investorOnboardingā
Currently, only the above value is allowed.
product_customerId
The product_customerId is obtained for a particular user by logging into Signzyās product as defined by the above definition. The userId parameter of the login call is where you get the value of this parameter.
product_accessToken
The product_accessToken is obtained for a particular user by logging into Signzyās product as defined by the above definition. The id parameter of the login call is where you get the value of this parameter.
control_active
If control_active is set as true, only then the API calls from the channels will be allowed to enter into the Signzy system, if this property isnāt set or is set to false, that channel wonāt make the channel API calls or onboarding API calls. Defaults toĀ trueĀ if not set.
control_allowedCount
This property defines the number of onboarding objects that this channel can create. Defaults toĀ 500Ā if not set.
control_selfUpdation
If this property is not set or set to false, then the update calls to its own object. The self-updation API mentioned below will not be enabled. This enables the channels to update the username, password, and email. For updating product specifications and the control parameters, control_updateControls & control_updateProductInfo should also be set. Defaults toĀ trueĀ if not set.
control_updateControls
If this property is not set or set to false, then the channel wonāt be able to update the properties which have a prefix of control_. Defaults toĀ falseĀ if not set.
control_updateProductInfo
If this property is not set or set to false, then the channel wonāt be able to update the properties which have a prefix of product_. Defaults toĀ falseĀ if not set.
control_createChildren
If this property is not set or set to false, then the channel wonāt be able to child channels. Channels wonāt be able to call the create channel API if this is not set or set as false. Defaults toĀ falseĀ if not set.
control_enableFrontendURLs
Enables showing of frontend Web URLs for onboarding in response of create Onboarding API, in JSON keys:Ā applicationUrl,Ā autoLoginUrL,Ā mobileLoginUrl,Ā mobileAutoLoginUrl
disableEmailFromAmc
Flag to Disable/Enable Emails that are sent to investors on behalf of AMC. true implies email won't be sent. Defaults toĀ falseĀ if not set.
callbackOnAction
This object contains the list of callback URLs, to which data is to be posted when any corresponding action is taken on the application. Defaults to empty if not set.
pageCallbackUrl
This object contains the list of callback URLs, to which data is to be posted when any step is completed by the investor. Defaults to empty if not set.
Expected Response
{
"product_productId": "........",
"product_customerId": "........",
"product_accessToken": "........",
"control_active": false,
"control_allowedCount": 20,
"control_updateProductInfo": false,
"control_selfUpdation": true,
"control_updateControls": true,
"control_createChildren": true,
"control_enableFrontendURLs": false,
"disableEmailFromAmc": false,
"username": "......",
"email": "......",
"id": "......",
"channelId": "......",
"callbackOnAction": {
"accepted": "...",
"rejected": "...",
"draft": "..."
},
"pageCallbackUrl": {
"identity": ".....",
"address": ".....",
"corraddress": ".....",
"bankaccount": ".....",
"documents": ".....",
"fatca": ".....",
"signature": ".....",
"photo": ".....",
"video": ".....",
"contract": ".....",
"submit" : "....."
}
}Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected].