{
"id": "paywall_balance_trial_granted_evt_123",
"paywallId": "pw_live_123",
"ownerUserId": "usr_owner_789",
"type": "balance.trial.granted",
"version": "2024-05-01",
"createdAt": "2024-05-01T12:34:56Z",
"status": "pending",
"attempts": 1,
"data": {
"paywallId": "pw_live_123",
"ownerUserId": "usr_owner_789",
"walletUserId": "wallet_123",
"credits": 500,
"activityId": "act_trial_001"
}
}Webhook events
Trial credits granted
Triggered when trial credits are granted to a user. Tracks complimentary credits so marketing and growth tooling maintain accurate lifetime value calculations. Payload fields: paywallId, ownerUserId, walletUserId, credits, activityId.
WEBHOOK
balance.trial.granted
{
"id": "paywall_balance_trial_granted_evt_123",
"paywallId": "pw_live_123",
"ownerUserId": "usr_owner_789",
"type": "balance.trial.granted",
"version": "2024-05-01",
"createdAt": "2024-05-01T12:34:56Z",
"status": "pending",
"attempts": 1,
"data": {
"paywallId": "pw_live_123",
"ownerUserId": "usr_owner_789",
"walletUserId": "wallet_123",
"credits": 500,
"activityId": "act_trial_001"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Paywall event payload that triggered the webhook delivery.
Event key (see the webhooks section for the full catalog).
Available options:
updated, archived, secret.rotated, integration.connected, integration.disconnected, integration.stripe.webhook.rotated, authorization.requested, authorization.completed, authorization.revoked, authorization.declined, balance.deposit.created, balance.topup.link.created, balance.trial.granted, balance.charge.created, balance.charge.completed, balance.charge.failed, usage.charge.created, usage.charge.deferred, usage.rate.limited, balance.depleted, request.blocked, stripe.checkout.session.completed, proxy.request.started, proxy.request.completed, proxy.request.failed, proxy.request.canceled, proxy.request.blocked Allowed value:
"balance.trial.granted"Payload fields: paywallId, ownerUserId, walletUserId, credits, activityId.
Response
200
Return a 2xx to acknowledge receipt.