Links
Comment on page

Custom Rewards

Use inbound webhooks to reward users with custom features in your application.

1. Create Virtual Wallet

Create a virtual wallet for your user and store it's code in your your database.
Example of virtual wallet management where one wallet is connected to an account
# Request
curl "https://api.thx.network/v1/webhook/wallet/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" \
-X POST
# Response
{"code":"e7f32a71-33ea-418e-9d80-32b6bf6405f0"}
Connect the virtual wallet to a THX account in your frontend using the campaign widget and the virtual wallet code for the authenticated user.
window.THXWidget.connect(uuid)

3. Register endpoint

Implement a public endpoint in your app and monitor the requests we make to it. Make sure to verify requests using the signing secret as in the given example. This is what protects the endpoint.
Example of a registered endpoint
Example of a webhook request history

4. Create Custom Reward

Configure a custom reward with optional metadata and we will request your configured endpoint upon point redemption for this reward.