Set up vendor payouts and webhooks

Payouts through Stripe Connect

Cubbie pays vendors through Stripe Connect. Setup lives at Vendor → Payouts:

1. Open the payouts page and start Connect onboarding (Stripe Connect Express). If your company already has a Stripe Connect account, link the existing account instead — it takes two clicks.

2. Complete the Stripe steps: business details, identity and know-your-business verification, and your bank account.

3. Once Stripe marks the account ready, payouts from completed orders settle automatically.

The same flow is offered during vendor onboarding. Until Connect onboarding completes, sales cannot settle to your bank — finish this before publishing your first offer.

Webhooks

Vendor → Webhooks lets your engineers subscribe systems to Cubbie events instead of polling:

• deal.created, deal.redeemed, deal.expired
• order.completed, order.refunded
• subscription.cancelled, subscription.renewed
• payout.released

Create an endpoint with the URL to deliver to and the events to subscribe. The signing secret is revealed once at creation — store it immediately; afterwards only a prefix is shown in the dashboard.

Verify deliveries

Every delivery is HMAC-signed with the X-Cubbie-Signature header. Verify the signature against your signing secret before trusting a payload. Failed deliveries are retried, so make your handler idempotent — the same event may arrive more than once.

A sane integration order

1. Connect Stripe and finish the business verification before your first sale.

2. Add a webhook endpoint for order.completed and payout.released — the two events your finance team asks about first.

3. Expand to the deal events when you start running offers at volume.

If an endpoint starts failing, rotate or fix it promptly: persistent failures mean your systems are drifting out of sync with reality on Cubbie.

• Create offers and deals buyers can act on
• Claim and verify your product profile