Settings

The Refinery Payouts Settings page (WP Admin → Refinery Payouts → Settings) controls global behavior: Stripe credentials, refund handling, test mode, white-label branding, and email templates.

Stripe tab

Holds your Stripe Client ID and the test/live API key pairs. See the Stripe Connect setup guide for details. The status badge at the top of the page reports whether the plugin can authenticate with Stripe.

Test mode

Toggle Enable test mode on to use your sk_test_… and pk_test_… keys. Transfers created in test mode appear in your Stripe Dashboard’s test data view. They don’t move real money.

Connected accounts created in test mode are not portable to live mode — your payees must complete onboarding again when you switch.

Refund reversals

Toggle Enable refund reversals to automatically reverse Stripe Transfers when a WooCommerce order is refunded.

When enabled and a refund is processed, the plugin:

1. Looks up every successful transfer associated with the refunded line items.
2. Calculates the prorated reversal amount: refund_amount ÷ original_line_total × transfer_amount.
3. Creates a Transfer::createReversal on each affected transfer.
4. Updates the log entry with the cumulative refunded amount and a Partial refund or Refunded status.

If you leave this off, you’ll need to handle reversals manually via the Stripe Dashboard or your own scripts.

White-label branding

Set the Private label option to Enabled to replace “Refinery Payouts” branding throughout the admin (menu labels, page titles, email templates) with your store name. Use this when you’re reselling the functionality to your own clients and don’t want them to see the Refinery brand.

Email settings

Customize the subject line and templates for the Stripe Connect onboarding invitation. The invitation uses the WooCommerce email pipeline, so any styling you’ve applied to your other WC emails (header, footer, colors) carries over automatically.

License tab

Enter your Refinery Payouts license key here to enable automatic updates. The same form is available from the plugin row on the WP Admin Plugins screen.