Payout Settings
Configure store payout policy, connect supported payout methods, and understand production-readiness safeguards.
When to use this page
- You need to configure payout rules or connect a supported payout method for the current shop.
- You need to confirm whether the shop and platform are ready for automated payouts.
Before you start
- Decide whether payouts will be handled through automated gateways, manual processing, or both.
Success looks like
- The intended payout methods and store payout policy are saved.
- Stripe onboarding and required capabilities are complete before Stripe is enabled.
- You understand that store enablement does not bypass the platform live-execution safety gate.
Where to find it
Merchant sidebar → Settings → Payout Settings
Steps
Step 1.
Open Settings → Payout Settings.
Step 2.
Configure the Store payout policy: currency, minimum and optional maximum payout, approval mode, schedule, processing-fee handling, holding period, and whether early payout requests are allowed.
Step 3.
In Stripe Connect, select Connect or Resume onboarding, finish the Stripe-hosted flow, and refresh the account status.
Step 4.
Enable Stripe for the store only after the required charges and payouts capabilities are active.
Step 5.
Enable Manual / Other when payments will be completed outside Affilyn. Leave PayPal disabled unless the page confirms that platform OAuth and Payouts permissions are ready.
Settings explained
- Store payout policy controls currency, payout limits, manual or automatic approval, on-request/weekly/monthly scheduling, fee handling, holding period, and early-payout availability.
- Stripe Connect is the implemented automated provider. Onboarding is hosted by Stripe, and the page reports the connected account reference, last synchronization, and capability status.
- PayPal Payouts is not available for live automated execution while platform OAuth is unconfigured. Legacy merchant REST credentials may be identified for migration but are no longer editable in the browser.
- Manual / Other means the merchant sends money outside Affilyn and records the result for audit and reconciliation.
- Production readiness is separate from store configuration. Live execution fails closed unless the explicit safety gate, encryption, Stripe platform credentials, webhook secret, worker authorization, and production runtime are ready.
Example
A merchant configures a monthly payout schedule and holding period, completes Stripe-hosted onboarding, refreshes the capability status, and enables Stripe only after the page confirms the account is ready.
Tips and limits
- Store method enablement alone does not prove that live execution is ready; check the production preflight and operational health views.
- If partners cannot request payout, check this page before troubleshooting their dashboard because store-level gateway availability is enforced.
- Use Disable or Disconnect only when you understand the effect on pending payout operations.
- Do not share credentials, onboarding links, or sensitive account information in screenshots or support tickets.
Current behavior
- Stripe uses Stripe-hosted Connect onboarding; Affilyn does not collect a merchant Stripe secret key or bank details.
- PayPal Payouts OAuth is not currently configured for live automated execution.
Limitations
- PayPal cannot be enabled until the platform OAuth integration and Payouts permissions are configured and verified.
- Live execution also requires the production runtime and platform preflight checks to pass.