Webhook settings

The Webhooks tab of your FunnelFox Billing Settings page holds two things: the read-only inbound URLs your post events to, and the outbound targets FunnelFox Billing sends events to.

Webhook URLs

Read-only webhook endpoints for this organization. These are the fixed per-organization endpoints your PSPs post events back to. Copy each URL into the matching PSP’s own dashboard. {org} is your organization ID.

PSP	Webhook URL
Primer	`https://billing.funnelfox.com/{org}/v1/primer/webhook?region=default`
Stripe	`https://billing.funnelfox.com/{org}/v1/stripe/webhook?region=default`
PayPal	`https://billing.funnelfox.com/{org}/v1/paypal/webhook?region=default`
Checkout.com	`https://billing.funnelfox.com/{org}/v1/checkout_com/webhook?region=default`
Adyen	`https://billing.funnelfox.com/{org}/v1/adyen/webhook?region=default`

Only the default region URL is shown. Additional PSP accounts (ff_first and beyond) need a URL with the matching ?region= value.

PSP verification secrets

FunnelFox Billing uses these secrets to verify that inbound webhooks really come from your PSP. Enter each one from the corresponding PSP dashboard.

Setting	Description	Value
`adyen_collection.default.webhook_key`	HMAC key used to verify inbound Adyen webhook signatures.	Secret
`paypal_collection.default.webhook_id`	PayPal’s webhook ID, used to verify inbound PayPal webhook signatures.	Secret
`primer_collection.default.webhook_secret`	Secret used to verify inbound Primer webhook signatures. Primer also needs its domain and private key on the Main tab.	Secret

Outbound webhooks

FunnelFox Billing sends each event as JSON to every target that should receive it, retrying with exponential backoff. You can configure up to seven targets, labelled Webhook (1) through Webhook (7) and stored under slots first through seventh. A new organization has no targets, so nothing is sent until you add a URL to a slot. Each target uses the same fields. The table below shows the first slot (sender_task_targets.first.*); the other slots use the identical keys with second through seventh in place of first.

Setting	Description	Value
`sender_task_targets.first.url`	Destination endpoint for this target. A target exists only once its URL is set.	Text (required)
`sender_task_targets.first.enabled`	Master on/off switch for the target. When off, nothing is sent to it.	Yes/No (default: Yes)
`sender_task_targets.first.signing_secret`	HMAC secret. When set, each request carries an `ff-webhook-signature` header with the HMAC-SHA256 of the body. Blank sends unsigned requests.	Secret (default: unsigned)
`sender_task_targets.first.event_order_declined_enabled`	Also send declined-order events. When off, only successful order events are sent.	Yes/No (default: No)
`sender_task_targets.first.use_order_success_event`	Change when the “paid” event fires. Off sends one event once the order settles; on sends one event earlier, on the first paid state.	Yes/No (default: No)
`sender_task_targets.first.event_dispute_enabled`	Also send dispute-opened events.	Yes/No (default: No)

Only order and dispute events honor the per-target switches. Refund, subscription, one-off, consumable, and user events go to every enabled target.

Retry policy

One retry policy governs the exponential backoff for all outbound webhook retries.

Setting	Description	Value
`sender_task_retry_policy`	A `[delay_multiplicator, maximum_attempts]` pair. The default `[8, 6]` is about 6 attempts over 10.4 hours.	JSON (default: `[8, 6]`; `delay_multiplicator` 5–11, `maximum_attempts` 1–8)

For the event types FunnelFox Billing sends and their payloads, go to the Billing webhook reference.

Getting started

Payments

Subscription management

Settings

Webhook URLs

PSP verification secrets

Outbound webhooks

Retry policy

Next steps

​Webhook URLs

​PSP verification secrets

​Outbound webhooks

​Retry policy

​Next steps

Webhook URLs

PSP verification secrets

Outbound webhooks

Retry policy

Next steps