Select a product that your webhook should work with. You can turn your webhook on after clarifying all required parameters. In case you are not sure about all webhook parameters, keep the switch disabled. Enabled: Use this switch to disable or enable your created webhook.Description: Provide a description for your webhook.Specify the following general webhook attributes: Proceed to the Webhooks section of the Integrations module on the Connect platform:Ĭlick the Create Webhook button to launch a webhook creation wizard.įollow the wizard steps to successfully configure your webhook. The API call parameters are configured.An external handler that your webhook must trigger is created.A product that you want to process is properly configured.Performs required processing operations and updates the processed objects within Connect.īefore crating a webhook on the Connect platform, ensure that the following conditions are met:.For example, the handler can use the following method to get all pending requests of a product specified by its ID: Filters objects within the Connect platform and analyzes whether they should be processed.For this operation, the handler uses a shared JWT secret string that the webhook uses for signing the JWT. Validates the received JWT by calculating the HS256 signature and compares it with the signature inside the JWT.
It exposes an endpoint URL that the webhook calls to trigger the handler.Īfter receiving an API call from the webhook, the handler performs the following typical operations: A Webhook Handler is an external custom tool that processes pending objects (e.g., fulfillment requests) in Connect via the Connect API. Note that your POST request should also contains a body.Ī Webhook represents an object in Connect that triggers an external Webhook Handler through that handler’s API. The attribute value should contain a JWT (JSON Web Token) that is signed by a secret string. Such requests should contains an Authorization header with the Bearer attribute. OperationsĪ webhook calls an external handler using HTTP GET or POST requests. The webhook method avoids additional polling and consequently uses system resources more efficiently. For instance, a webhook can watch for the fulfillment queue of a particular product and trigger the specified callbacks on queue changes.
CONNECT WEBOOK TO GET FULL LIST MANUAL
In some business cases, it is necessary to process subscriptions as fast as possible and the manual processing may prove ineffective. Therefore, Vendors are required to locate a pending fulfillment request and either approve or reject it to activate a subscription.
For example, Distributors or their systems generate a new fulfillment request that should be manually processed by Vendors. Typically, one of those accounts should pay attention to a pending object and process it. In general, some workflows within the Connect platform cannot be completed until a Connect user performs certain actions.