Enhanced webhook payloads

Webhook payloads associated with all Pinwheel solutions now have new fields that make it easier to track and decision on the customer usage data returned by webhooks.

In summary, the new fields are as follows:

  • The account.added webhook now gets a platform_type field that conveys the kind of account the user connected to: a payroll platform, a bill-switch merchant, a tax platform, or a time_and_attendance platform.
  • Many webhooks now get both platform_id and platform_name which previously were only available in the account.added webhook.
  • Bill Switch and Bill Detection webhooks now get a detection_method field that conveys how we detected a bill or subscription: external_plaid for when a user connects an external account; first_party for when we detect it from transactions you upload to us directly; and manual for when a user manually adds a bill.
  • Bill Switch webhooks also get a bill_id that corresponds with the id field of Bill Detection webhooks.
  • We've also added new fields in the Bill Switch and Bill Detection webhooks for "long tail" merchants. For more details on that, see our implementation guide section on long tail merchants.

See the API Reference for the detailed technical specs for the new fields.