Payouts
Connect your Stripe Connect Standard account, finish onboarding, link recipients and check readiness for prize payouts from Dashboard → Payouts.
Cash prizes are paid from your own Stripe Connect Standard account to each winning player's own connected Stripe account. Tanitar never holds the funds; it instructs the transfer on your behalf and reconciles the result. Dashboard → Payouts (titled Prize payouts) is where you connect that account and keep it ready.
Stripe test-mode keys only: a live Stripe key is refused.
How a prize becomes a payout, and the API for it, is in Payouts.
Connect your Stripe account
- In Connected account, select Connect Stripe account.
- In Connect a Stripe account, either enter your Existing Stripe account id (
acct_…) or leave it empty to have Stripe create a new connected account for you. - Select Connect.
- The Finish Stripe onboarding now dialog shows a Stripe onboarding link. Open it and complete Stripe's hosted onboarding, then tick I have opened or copied this onboarding link and select Done. The link is shown only this once and is not stored.
Redirect URLs
The dashboard builds Stripe's two redirect URLs from its own address, so there is nothing to configure:
| URL | Where Stripe sends you |
|---|---|
| Return URL | /dashboard/payouts?onboarding=complete, when onboarding is finished |
| Refresh URL | /dashboard/payouts?onboarding=refresh, when the link expired or was already used |
Stripe onboarding links expire within minutes. If yours expired, select Re-issue onboarding link to get a fresh one.
Check the account
Connected account shows the account's state, revision, Stripe account id, mode, Stripe's capability flags, the default and allowed currencies, and when onboarding started and completed.
In Readiness, select Check readiness. Tanitar re-reads the account from Stripe and reports one verdict; this moves no money.
| Verdict | Meaning |
|---|---|
| Ready | Stripe has fully enabled the account and Tanitar advertises the provider |
| Not ready | Stripe has not finished enabling the account; finish onboarding |
| Disabled | The payout account is disabled |
| Not enabled upstream | This Tanitar deployment does not offer payouts |
| Stripe unreachable | Stripe could not be reached; nothing was changed |
| Not connected | Connect an account first |
Set the currency allowlist
In Currency allowlist, enter the three-letter currencies prizes may be paid in, comma separated, and select Replace allowlist. Only your account's default currency is accepted: no conversion is performed. An empty list allows none.
Link payout recipients
Each winning player is paid to their own connected Stripe account.
- In Payout recipients, select Link a recipient.
- Enter the Player id and the player's Stripe account id (
acct_…). - Select Save recipient. Tanitar checks the account with Stripe and marks the recipient eligible or ineligible.
Use Edit to change a recipient's account and Remove to unlink it. A player without a recipient cannot be paid until one is linked again.
Follow payouts
Recent payouts lists the ten most recent prize payouts with their status and attempt count (at most 6 attempts). A payout whose send was ambiguous shows Reconcile: select it to ask Stripe what happened before anything is sent again. Refresh all re-reads the whole page.
Disable payouts
Select Disable payouts and confirm. Prize payouts are refused from then on, and no new onboarding link is issued for a disabled account.
What can go wrong
| Code or message | Why | What to do |
|---|---|---|
PAYOUT_ACCOUNT_EXISTS | Your tenant already has a payout account | Use the connected account shown on the page |
PAYOUT_CURRENCY_UNSUPPORTED | The allowlist names a currency other than the account's default | Use the default currency only |
PAYOUT_ACCOUNT_DISABLED | You asked for an onboarding link on a disabled account | Contact Tanitar to restore payouts |
PAYOUT_REVISION_CONFLICT | The account or recipient changed since you loaded the page | Select Refresh all and retry |
An error code starting STRIPE_ | Stripe refused or could not be reached | Retry; check the account in your Stripe dashboard |
| Only an organization admin can change payout configuration. | Your role is org:member | Ask an admin |