Wallet & Payouts

The Fangate wallet backend exposes creator balances, affiliate revenue, transaction history, and payout requests.

Wallet endpoints

• GET /api/wallet
• GET /api/wallet/affiliate
• POST /api/wallet/cashout

Wallet balance model

The live wallet resource currently returns:

• available
• hold
• pending
• total
• referral_revenue
• cashout_available
• transactions

Balance meanings

Available

Funds that the creator can currently cash out.

Hold

Funds that exist in the wallet but are still under a hold period or similar release rule.

Pending

Funds already moved into the payout-processing state.

Total

Aggregate view across wallet balance categories.

Referral revenue

Affiliate earnings exposed separately for creator reporting.

Cashout behavior

Current endpoint:

• POST /api/wallet/cashout

Current backend behavior:

• no request body is required
• the backend attempts to create a payout for the current available amount
• on success it returns a success envelope with the message Cashout created successfully
• if no funds are available it returns an error such as No available funds

Affiliate wallet view

GET /api/wallet/affiliate returns affiliate-specific revenue data using the affiliate resource shape. This is separate from the broader wallet summary.

Transaction history

The wallet summary includes a transaction collection. Integrators should treat the backend-provided resource as the source of truth for:

• transaction timestamps
• direction/type labeling
• amounts shown to the creator

Payout prerequisites

Whether a creator can cash out depends on:

• available balance
• payout / bank information present on the user account
• backend business rules

Bank details are currency-dependent and live on the user profile.

Examples:

• EUR: iban, bic_swift
• USD: account_number, routing_number
• GBP: account_number, sort_code

See Users.

Example flow

1. GET /api/wallet
2. client confirms cashout_available=true
3. POST /api/wallet/cashout
4. client refreshes GET /api/wallet to observe updated pending / available balances

Integrator guidance

• do not compute creator payout balances locally
• do not assume pending funds are withdrawable
• do not expose payout eligibility based on stale cached wallet data

Related

• Wallet API
• Affiliate API
• Users