Webhooks
Webhooks are basically user defined HTTP callbacks which are triggered by specific events.
When to use webhooks
The most common use-case of webhooks is to automate the communication between Cryptlex and other 3rd party apps asynchronously. You might use webhooks to:
- Email a license key to your customer after a successful purchase.
- Email your customer when the license expires.
- Renew subscription licenses when your customer makes the payment.
- Get notified through email or chatting apps like slack when any user activates the trial or license.
- Any other integration your business needs.
Creating a webhook
You can easily create a webhook through dashboard. Go to the webhooks section in the dashboard and click the add the button. A webhook form with following fields will popup:
Name
Name for the webhook.
URL
The endpoint which will receive the HTTP POST payload.
Token
The secret which will be used to sign the payload using HMAC256 algorithm.
Events
The list of events you want to subscribe.
Active
Whether webhook should be triggered or not, you can use it to disable a webhook.
Webhook payload
Each event type has a specific payload format with the relevant event information. Additionally, the signature generated using HMAC256 algorithm is included in "Webhook-Signature" header. A typical payload will have a following structure:
1
POST /webhook-endpoint HTTP/1.1
2
Content-Type: application/json; charset=utf-8
3
Content-Length: 661
4
Webhook-Signature: Bb3jMWkC1DOqEv5fAOsqwkKH7r57w9o8fZ3Jg72lNk0=
5
6
{
7
"event": "license.created",
8
"data": {
9
"key": "D08B53-C564F8-463EA5-F16A15-E35D6E-D2559B",
10
...
11
},
12
"triggeredAt": "2018-04-20T13:11:34.6926949Z"
13
}
Copied!
Last modified 3yr ago
Copy link