loyalteez_redeem_perk
Redeems a perk for a user by creating a redemption record and returning a confirmation code. Requires separate LTZ deduction from user balance.
Instructions
Redeem a perk for a user. Creates a redemption record and returns confirmation code. Note: You must separately deduct LTZ from the user's balance.
See also: loyalteez://docs/shared-services/perks-service
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"userIdentifier": "<userIdentifier>",
"platform": "<platform>",
"perkId": "<perkId>"
},
"name": "loyalteez_redeem_perk"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| perkId | Yes | UUID of the perk to redeem | |
| brandId | No | Your brand wallet address. If not provided, uses LOYALTEEZ_BRAND_ID environment variable. | |
| platform | Yes | Platform: "discord" | "telegram" | "web" | etc. | |
| userIdentifier | Yes | User identifier (platform_userId@loyalteez.app or email) |