Wallet

Wallet and payout endpoints. Manage balance, transaction history, and cashout requests.

---

Get wallet

GET /api/wallet

Returns wallet balance and transaction history.

Authentication: Required

Example Request

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://fangate.info/api/wallet

Response (200)

{
  "success": true,
  "errors_message": null,
  "data": {
    "available": 15000,
    "pending": 5000,
    "total": 20000,
    "referral_revenue": 2500,
    "cashout_available": true,
    "transactions": [
      {
        "id": 1,
        "type": "product_earning",
        "amount": 550,
        "description": "Product sale",
        "created_at": "2026-01-15T10:30:00Z"
      }
    ]
  }
}

wallet.resource schema

Field	Type	Description
available	integer	Balance ready for withdrawal (cents)
pending	integer	Funds in payout processing (cents)
total	integer	available + pending
referral_revenue	integer	Total affiliate earnings
cashout_available	boolean	Can request payout?
transactions	array	Transaction history

Transaction types

Type	Description
product_earning	Sales revenue
affiliate_earning	Referral commissions
withdrawal	Completed payouts
fee	Platform service fees
refund	Returned payments
hold	Funds placed on hold
release_hold	Funds released from hold
pending	Funds in payout processing

---

Get affiliate wallet

GET /api/wallet/affiliate

Returns affiliate-specific earnings and transactions.

Authentication: Required

Example Request

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://fangate.info/api/wallet/affiliate

Response (200)

{
  "success": true,
  "errors_message": null,
  "data": {
    "referral_revenue": 2500,
    "transactions": [ ... ]
  }
}

---

Request cashout

POST /api/wallet/cashout

Requests payout of available balance. Workflow:

1. Validates minimum amount and sufficient balance
2. Moves funds from Balance → Pending
3. Creates payout request in admin panel
4. Admin manually wires funds
5. Admin approves/declines in panel
6. Push notification sent to creator on completion

Authentication: Required

Request Body

Check current API for required fields (e.g. amount, bank details). May require minimal or no body if bank details are already on file.

Example Request

curl -X POST https://fangate.info/api/wallet/cashout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Response (200)

{
  "success": true,
  "errors_message": null,
  "data": {
    "message": "Payout requested",
    "pending_amount": 15000
  }
}

Payout routing (by currency)

Currency	PayPal Payouts	Stripe Payouts
USD	Via Stripe	KYW Europe Operation Limited
EUR	KYW Europe Operation Limited	KYW Europe Operation Limited
GBP	KYW Europe Operation Limited	KYW Europe Operation Limited

Currency is set during registration and cannot be changed.

Wallet structure (balance categories)

Category	Description
Available	Funds ready for withdrawal; cleared all hold periods
Hold	Funds temporarily on hold (default: 1 hour after purchase). Released for "trusted users" (not blocked, verified, registered > 30 days, no refund in last 30 days)
Pending	Funds currently being processed for payout