Pinwheel API Resellers

Overview

The Partnership Model enables partners who offer Pinwheel through their own platforms to better manage, track, and understand their customers’ activity. By using the parameter partner_customer_id, resellers can seamlessly associate end-user activity with their own customer records, giving them full visibility into engagement, performance, and outcomes within the Pinwheel ecosystem.

This enhancement eliminates the limitations of earlier tagging approaches and provides a unified, standardized way for reseller partners to onboard, monitor, and report on their customers.

Why We Built It

In the past, resellers integrated Pinwheel using custom tags or by creating individual workspaces for each of their customers. While both approaches worked, they came with tradeoffs:

• Tags only: Resellers could track activity using their own identifiers, but the Pinwheel platform had limited visibility into who those customers were. This made analytics, support, and reporting less efficient.
• Separate workspaces: Provided strong data isolation but made it difficult for resellers to view and manage all their customer activity in one place.

The Partnership Model bridges these gaps. It gives resellers a single workspace that can represent all of their downstream customers while maintaining full attribution and traceability for every Link token, report, and webhook event.

How It Works

When a reseller creates a Link token, they include a partner_customer_id to identify their end customer. This identifier travels with every associated job, report, and webhook event, providing clear, consistent visibility across the full lifecycle of user interactions.

For example:

• Link Tokens: Each token is tied to a specific end customer by including the partner_customer_id in the creation request.
• Webhooks: Any webhook events generated by the user’s actions—such as a completed Direct Deposit Switch—will include that same identifier in the payload.
• Reporting: All downstream reports and dashboards can be filtered or aggregated by the partner_customer_id, allowing resellers to easily understand performance by customer.

This makes it simple to connect internal customer systems with Pinwheel data, track conversion and usage metrics, and provide better service to end users.

Benefits for Resellers

• Unified view of customer activity
  Access insights across all your customers in one workspace, without losing the ability to distinguish individual customer behavior.

• Simplified integrations
  Replace legacy tagging systems with a consistent, officially supported API parameter.

• Enhanced analytics and reporting
  Filter reports, dashboards, and webhook streams by partner_customer_id to measure performance, engagement, and outcomes.

• Streamlined onboarding and management
  Easily add new customers without provisioning separate workspaces or managing additional credentials.

Example: End-to-End Visibility

When a user completes a Direct Deposit Switch through your application, the webhook you receive will include the same partner_customer_id you provided when creating the Link token. This allows you to correlate that event directly with your own internal customer record.

{
  "event": "direct_deposit_switch.added",
  "payload": {
    "partner_customer_id": "customer-123",
    "outcome": "success",
    "account_id": "d56ae584-af56-405d-9b98-5eaa4674ac98"
  }
}