Skip to content

Stripe

Connect Stripe, and Yoohoo tells you about sales, failed payments, refunds and disputes.

  1. In the app, open Add a source, then For developers, and pick Stripe.
  2. In Stripe, open Developers, then API keys, and choose Create restricted key.
  3. Give it Write access to Webhook Endpoints and None for everything else.
  4. Paste the key into Yoohoo and tap Connect.

Yoohoo uses the key once to add an endpoint called Yoohoo to your Stripe webhooks, then forgets it. A test key (rk_test_…) connects test mode, and a live key (rk_live_…) connects live mode.

If you’d rather not paste a key, tap Set it up by hand instead on the source:

  1. In the Stripe dashboard, open Developers, then Webhooks, and add an endpoint with the link Yoohoo shows.
  2. Select the events Yoohoo lists, and no others:
    • charge.succeeded
    • charge.failed
    • charge.refunded
    • charge.dispute.created
    • charge.dispute.closed
    • customer.subscription.created
    • customer.subscription.deleted
  3. Copy the endpoint’s signing secret (whsec_…), paste it into Yoohoo and tap Save secret.
Event What happens
A sale Interrupts you right away
A payment fails Interrupts you right away
A refund Interrupts you right away
A dispute opens, or is lost Interrupts you right away
A dispute is won Waits for the roundup
A new subscriber, or a cancelled subscription Waits for the roundup

A subscription’s first payment arrives as its own sale alert. When a customer pays after a failed payment, Yoohoo marks the failure settled.

Two switches on the Rules screen change this. Turn off I make a sale to get sales in the roundup instead. Turn off A payment fails or is refunded to do the same for failed payments and refunds.

Delete the source in Yoohoo, and delete its endpoint in your Stripe webhooks too.