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.