Gas sponsorship charge recorded

Fired when Privy records a sponsored-gas charge for a wallet action.

WEBHOOK usage.gas_sponsorship.recorded

usage-gas-sponsorship-recorded

{
  "type": "usage.gas_sponsorship.recorded",
  "source_id": "wa_9f3c...7b",
  "source_type": "wallet-action-swap",
  "amount_usd": "0.004213",
  "recorded_at": 1722787200000
}

Body

application/json

Payload for the usage.gas_sponsorship.recorded webhook event (sponsored network gas).

type · enum<string> · required

The type of webhook event.

Available options: usage.gas_sponsorship.recorded

event_id · string · required

An opaque, stable identifier for this charge. Use it to deduplicate webhook deliveries.

source_id · string · required

source_type · enum<string> · required

The type of operation that incurred a usage charge.

Available options: wallet-action-transfer, wallet-action-swap, rpc

amount_usd · string · required

Pattern: ^\d{1,24}\.\d{6}$

recorded_at · integer · required

Required range: x >= 0

Response

200

Return a 200 status to indicate that the webhook was received successfully.