Webhooks
Configuration
What we send
FlipKey POSTs JSON to your Webhook URL, signed with an
X-FlipKey-Signature header — an HMAC-SHA256 of the raw request body using your
webhook secret. Verify it before trusting the request. Events:
- purchase — a license was sold and minted:
{ event, orderRef, tokenId, walletAddress, playerAddress, dropId, priceUsd, txHash, timestamp } - activation — a license was redeemed:
{ event, tokenId, playerAddress, txHash, contractAddress, timestamp } - refund.requested — a buyer requested a refund (delivered to your refund webhook endpoint, if set).
- test — sent by the “Send Test” button above.