ShaunSocial docs ShaunSocial user guide
Version 1.5.6
  • 1.5.6 (this version)

ShaunSocial user guide 1.5.6 / Monetisation

eWallet

AdminMember

The eWallet is the balance of site tokens every member (and every business page) holds on your site. Members add funds to it through a payment gateway, pay for the site's paid features from it, send money to each other, receive tips, earnings and referral commissions in it, and ask you to pay their balance out to PayPal or a bank account. This page shows admins the settings, the deposit packages, the withdrawal requests and the tools to look at or change a member's balance, and shows members how to add funds, pay, send and withdraw.

How this page was checked

Checked against the 1.5.6 code; the AdminCP screens and settings were compared with a demo site. Adding funds, sending, withdrawing and handling requests were read from the code, not run; screenshots follow.

How the eWallet works#

Last updated: 2026-11-17 · v1.5.6

Balances are kept in your site token (for example "shau"), whose value in real money is set by the exchange rate (see Currencies and the site token). Tokens come in and go out like this:

Money inMoney out
adding funds through a payment gateway; funds sent by another member or by an admin; tips, paid-content earnings and referral commissionspaying for the site's paid features; sending funds to another member; a withdrawal request, which the admins pay out to PayPal or a bank account by hand
  • Only completed amounts count. A top-up that is still Pending or Processing shows in the member's list but is not in the balance until the gateway confirms it.
  • Business pages have their own eWallet, used while switched to the page; paying for the page's own features takes the money from it. Only the owner can send its money or withdraw it (see Page admins and owner transfer).
  • Who may send and withdraw is set per member role: Send funds and Transfer funds in the eWallet box of the role's permissions, both on for the Member role after installing (see The permissions of a member role). Adding funds and paying need no permission.

Members open their eWallet from the Wallet row with their balance on the profile card at the top of the left menu, or at https://example.com/wallet.

The eWallet is on after installing (AdminCP → Site Settings → General Configuration → eWallet → Enable). Switched off, the Wallet row and page disappear, members can no longer add, send, withdraw or pay with the eWallet, and featured business pages can no longer be bought, even through PayPal or Stripe (they need the eWallet on). Balances are kept and are back when you switch it on again.

The AdminCP menu eWallet holds Wallets, Deposit Packages, Transfer Fund Requests, Transfer Mass Funds and System's billing activities (see System's billing activities). Moderators need the switch of the same name in their role for each (Wallets, Deposit packages, Transfer funds requests, Transfer Mass Funds, System's billing activities; see Moderator roles).

Emma Carter's Wallet page: the balance 125.00 shau ~ 125 USD, the Transfer fund, Send fund and Add fund buttons, and Billing activities with a PayPal transfer, a payment sent to Liam Nguyen and a top-up
A member's Wallet page: the balance with its value in dollars, Transfer fund, Send fund and Add fund, and the Billing activities list. Screenshot taken 2026-11-17.

Member wallets and their transactions#

Admin

Last updated: 2026-11-17 · v1.5.6

The list shows every account, members and business pages, newest first, with Name, Email and Current balance. Type part of a name or user name in Search to find one.

Click Transactions on a row to see that account's eWallet: every line with its Date, Type (for example "Add funds to your eWallet", "Send funds to [member]", "Transfer to Paypal (1 shau - 0.1 USD)"), Status, Gross, Fee, Net and, for a top-up, the Gateway transaction id, the reference to look the payment up at the provider. Filter by status:

StatusMeaning
Pendinga top-up was started; the gateway has not confirmed it yet
Processingthe gateway took the payment but it has not cleared yet (some PayPal payments)
Completeddone; only these lines count in the balance
Failedthe gateway refused the payment, or it did not clear within 14 days. If the gateway confirms it later, it still changes to Completed
Cancelledthe member cancelled on the gateway's page, or the payment was not confirmed within 30 minutes. If the gateway confirms a payment later, it still changes to Completed

To correct a balance, use Transfer Mass Funds; lines cannot be edited or deleted.

The Transactions of Emma Carter with the status filter and three completed lines: a transfer to PayPal, funds sent to Liam Nguyen and a top-up of 200
AdminCP → eWallet → Wallets → Transactions of one member, with the status filter and a completed top-up. Screenshot taken 2026-11-17.

Wallet settings, withdrawals and fees#

Admin

Last updated: 2026-11-19 · v1.5.6

The settings save as soon as you change them (see Settings save themselves).

SettingAfter installingWhat it does
Enableonthe eWallet as a whole (see How the eWallet works)
Token name, Exchange rateempty, 1see Name the token and set the exchange rate
Enable fund transfer (to allow member to withdraw money)onlets members ask for a withdrawal. It also needs at least one of the two methods below; with both off, Transfer fund disappears
Only verified profiles can transfer funds (make sure the user profile verification option is enabled before you enable this function).offon: only members with a verified profile can ask for a withdrawal; others who click Transfer fund are offered to verify their profile. Switch on profile verification first (see Profile verification)
Transfer fund to Paypalonoffers withdrawal to a PayPal account
Paypal minimum withdrawal amounts10the smallest withdrawal to PayPal, in your default currency (10 USD, not 10 tokens)
Paypal fee (%)2the share of each PayPal withdrawal the site keeps
Transfer funds to a bank accountonoffers withdrawal to a bank account
Bank minimum withdrawal amounts10the smallest withdrawal to a bank, in your default currency
Bank fee (%)2the share of each bank withdrawal the site keeps
Remind users to deposit more when the balance in the e-wallet is lower than5an amount in tokens. When money leaving a member's eWallet takes their balance below it, they get "Your account balance is running low." and an e-mail; they are reminded again only after a top-up has brought their balance back up to the amount
Send a final low-balance reminder 24 hours before a wallet-paid subscription renewsona second request to add funds, a day before a renewal, while the balance is still too low to pay it (only when the first reminder came more than a day before)
Accept sandbox and test store purchases. Keep this on while a build is in App Store / Google Play review — reviewers pay with sandbox accounts, and those purchases credit real wallets.onconcerns only credits bought inside the mobile apps: whether purchases made with test accounts add credits. See The In-App Purchase settings

How a withdrawal is counted#

The member asks for an amount in tokens. The site converts it with the exchange rate, checks the minimum of the chosen method, and takes the fee from the converted amount; you pay the rest. With the exchange rate as installed (1, so "1 USD = 1 shau") and the PayPal fee at 2%:

AskedGrossFeeNet (what you send)
50 shau50.00 USD1.00 USD49.00 USD

The 50 shau leave the member's balance at once, when the request is sent. A request below the minimum (here 10 shau, worth 10 USD) is refused with "The amount must be minimum 10 USD.". The 1 USD fee stays with the site. With an exchange rate of 10 ("1 USD = 10 shau"), the same 50 USD withdrawal is a request for 500 shau, and the minimum is 100 shau.

For your server administrator

The low-balance reminders are sent by the scheduled task (cron job), which checks every minute; the subscription reminders run every five minutes. See What stops when the cron job does not run.

The e-mails are the templates "Remind users to deposit more when the balance in the ewallet is lower" and "When the eWallet balance is too low to renew a subscription" (see The templates: payments and subscriptions).

The eWallet card of General Configuration after installing: Enable, Token name, Exchange rate, the fund transfer switches, the PayPal and bank minimums and fees, the low-balance amount and the reminder and test purchase switches
AdminCP → General Configuration, the eWallet part: Enable, token, exchange rate, the fund transfer switches, minimums and fees, and the reminders. Screenshot taken 2026-11-17.

Deposit packages#

Admin

Last updated: 2026-11-19 · v1.5.6

Deposit packages are ready-made amounts members can pick with one click in the Add fund to wallet dialog, for example 50, 100 and 500 shau. There are none after installing, and none are needed: members can always type an amount. A package costs the same as typing its amount: 100 shau at "1 USD = 10 shau" is 10.00 USD either way.

  1. Click Create new.
  2. Enter the Amount in tokens (at least 1, up to two decimals) and switch on Active. Leave Google product id and Apple product Id empty unless you sell the package inside the mobile apps: they are the IDs of its store products (see Buying credits in the apps).
  3. Click Submit.

    What you should see: "Package has been created." and the package in the list.

The Create window of a deposit package: Amount (shau), Google product id and Apple product Id with the help text This is for in-app purchase on mobile apps, the Active switch, and Submit and Cancel
The Create window of a deposit package. Screenshot taken 2026-11-19.

Only active packages are offered. Drag the rows by their handle to set the order members see; Edit changes a package and Delete removes it after you confirm.

The Deposit Packages list with three active packages of 50, 100 and 200 shau, their drag handles, Edit and Delete, and the Create new button
AdminCP → eWallet → Deposit Packages with three active packages and the Create new button. Screenshot taken 2026-11-17.

Transfer fund (withdrawal) requests#

Admin

Last updated: 2026-11-17 · v1.5.6

When a member asks for a withdrawal, the tokens leave their balance and the request waits here. The site does not send the money: you pay the member yourself through PayPal or your bank, then mark the request as sent. The first admin account (the one created when the site was installed) gets the notification "sent a payment request."; other admins check this screen.

The list shows Date, Name, Payment method with the exchange rate of the request, Gross, Fee, Net (in your default currency) and Status: Pending, Sent or Rejected. Filter by status, by method (Transfer to Paypal, Transfer to bank account) and by member name, then click Search.

  1. Click view details on a pending request.

    What you should see: the Payment request with Request amount, Fee, Net amount, Currency, Method and Account detail (the PayPal e-mail address or the bank details the member entered).

  2. Send the Net amount to that account from your PayPal or bank account.
  3. Click Accept and confirm "Do you want to accept this request?".

    What you should see: "This payment request has been successfully accepted." The status becomes Sent and the member gets "Your payment request has been accepted.".

Pay before you accept

Accept only records that you paid; it moves no money and cannot be undone. Check the account details before you send anything: the site cannot recover money sent to a wrong account.

  • Reject (confirm "Do you want to reject this request?") gives the whole amount back to the member's eWallet, fee included, and tells them "Your payment request has been rejected.". Tell the member why by message or e-mail; the notification has no reason.
  • Several at once: tick pending requests and use Accept or Reject under the list.
  • Export data in list to excel downloads the requests matching the filters as a CSV file (open it in a spreadsheet) with Account detail, Payment method, Net, Currency and Status, for example to prepare a batch payout.
The Transfer Fund Requests list with its filters and Export data in list to excel, and Emma Carter's pending PayPal request of 50.00 USD gross, 1.00 USD fee and 49.00 USD net with Accept and Reject
AdminCP → eWallet → Transfer Fund Requests with a pending PayPal request, its gross, fee and net amounts and the Accept and Reject actions. Screenshot taken 2026-11-17.

Sending mass funds#

Admin

Last updated: 2026-11-17 · v1.5.6

Use this screen to put tokens into a member's eWallet without a payment through the site, for example when a member paid you in cash or by bank transfer, as a prize, or to correct a mistake. You can also take tokens out, for example after you refunded a member's payment in your PayPal or Stripe account: a refund made there does not take the tokens back by itself.

  1. In Select a member, type part of the name and pick the member.
  2. Enter the Number of credits in tokens: a whole number up to 100000. A negative number (down to -100000) takes tokens out; you cannot take out more than the member has.
  3. Choose Notify user: Yes sends the member "added funds to your eWallet.", No sends nothing.
  4. Click Send Credits.

    What you should see: "Successfully sent!". The member's eWallet shows the amount as a completed "Add funds to your eWallet", and System's billing activities shows it as a deposit.

Despite the screen's name, it sends to one member at a time; repeat it for each member.

The Transfer Mass Funds screen: Select a member, Number of credits (shau), Notify user with Yes and No, and Send Credits
AdminCP → eWallet → Transfer Mass Funds: Select a member, Number of credits (shau), Notify user and Send Credits. Screenshot taken 2026-11-17.

Paying with the wallet#

Member

Last updated: 2026-11-17 · v1.5.6

Everything you buy on the site is priced in tokens and can be paid from your eWallet:

What you pay forWhere it is explained
featuring your business page or your marketplace listing (renews each period)Feature your page, Feature your listing
a membership plan (renews each period)the Membership page
unlocking a paid post, subscribing to a creator, tipping a creatorthe Paid content page
an ad campaign or a boosted postthe Advertising page
sending money to another member, also in a chatSend funds, Writing messages
  1. Start the purchase and, under Select a payment method, choose Wallet. The dialog shows Your current balance and a Reload your balance link to add funds first.
  2. Tick "I accept the Term of Service" and click Subscribe now or Pay Now.
  3. Enter your password (see Password check on payments).

    What you should see: a confirmation such as "Feature Successfully."; the payment appears in your eWallet's Billing activities.

  • Not enough tokens: you see "You don't have enough balance" and nothing is charged. Add funds and try again.
  • Renewals are taken from your eWallet automatically at the end of each period, without asking for the password. If the balance is too low at that moment, the subscription stops; you are told a few days before (see How a subscription renews).
  • Business pages pay from the page's own eWallet while you are switched to the page.
The Your order dialog for the Gold yearly plan: Wallet chosen as the payment method, the current balance, Reload your balance, the ticked Term of Service box and Subscribe now
The Select a payment method dialog with Wallet chosen, the current balance, Reload your balance, the Terms of Service box and Subscribe now. Screenshot taken 2026-11-17.

Password check on payments#

Member

Last updated: 2026-11-17 · v1.5.6

Every payment from your eWallet, and every transfer of funds to another member, asks for your account password first, so that nobody else can spend your balance from a device you left signed in. A withdrawal request does not ask for it.

  1. In the Enter Password dialog, type the password you sign in with.
  2. Click Confirm.

    What you should see: the payment goes through. A wrong password shows "The password is incorrect." and nothing is charged.

  • Paying as a business page: enter the password of your own account ("Use the password of the admin of the page").
  • You signed up with a social network: use the password from the welcome e-mail you received, or click Forgot password in the dialog to set a new one (see Social login: what members see). You can then also sign in with your e-mail address and that password.
  • Your account has no e-mail address (the social network did not share one): the dialog says "You need to add an email and set a password before you can do this." Click Add email and password, which opens Settings → Add email and password, then pay again.
The Enter Password dialog with the password field, Forgot password and Confirm
The Enter Password dialog with the password field, Forgot password and Confirm. Screenshot taken 2026-11-17.

Using your wallet: deposit, withdraw, transfer#

Member

Last updated: 2026-11-17 · v1.5.6

Click the Wallet row on your profile card at the top of the left menu. The Wallet page shows Your balance in tokens with its value in money (for example "61.00 shau ~ 61 USD") and the rate, the buttons Transfer fund, Send fund and Add fund, and your Billing activities.

Add funds#

  1. Click Add fund.

    What you should see: the dialog Add fund to wallet with the rate, for example "Amount ( 1.00 shau = 1 USD)".

  2. Type an amount in tokens (at least 1), or click one of the ready-made amounts under the field. The value in money is shown under it.
  3. Under Payment method, choose a gateway such as PayPal or Stripe, and tick "I accept the Term of Service".
  4. Click Proceed to add …. You are taken to the payment site; pay there.

    What you should see: back on your Wallet page, the top-up listed as Pending, then Completed with the notification "Your account has been successfully credited.", and a higher balance.

  • If the dialog says "Payment method is not available. Please contact admin for detail", the site takes no card payments yet; use Contact admin.
  • A top-up you cancel on the payment site, or that is not confirmed within 30 minutes, shows as Cancelled. If you paid and it shows Cancelled, it is added when the payment provider confirms the payment; if it is not, contact the site admins with the transaction ID from your PayPal or Stripe receipt. One that shows Processing is being cleared by the gateway and is added when it clears; a Failed one was refused, so try another payment method.
The Add fund to wallet dialog with the amount 100, the ready-made amounts 50, 100 and 200, Paypal and Stripe as payment methods and the Proceed to add button
The Add fund to wallet dialog: the amount, ready-made amounts, the payment methods and Proceed to add. Screenshot taken 2026-11-17.

Send funds to another member#

  1. Click Send fund.
  2. In Username, type part of the name and pick the person, enter the Amount (your available balance is shown under it) and tick "I accept the Term of Service".
  3. Click Send and enter your password.

    What you should see: "Send fund successfully." The tokens move at once and the other person gets "sent you a payment.".

The button is shown when your role may send funds. You cannot send to yourself, or to someone who has blocked you or whom you have blocked ("You cannot send funds this user."). A transfer cannot be taken back; only the receiver can send the tokens back.

Withdraw: ask for a payout#

  1. Click Transfer fund.

    What you should see: the page Submit a payment request. If your site pays out only to verified members and your profile is not verified, the Profile Verification dialog opens instead.

  2. Under Amount, type an amount in tokens or choose All current balance.
  3. Under Payment method, choose PayPal or bank transfer. Each shows its minimum (in money) and the fee for your amount, for example "Paypal - Minimun 10 USD - Transfer fee is 1 USD (2%)".
  4. For PayPal, enter your Paypal Email twice. For a bank transfer, write your bank details in Bank Detail: your address, the bank's address, the account holder's name, the account number (and IBAN if you have one) and the bank's SWIFT code.
  5. Click Submit Request.

    What you should see: "Request submitted successfully". The amount leaves your balance at once.

The admins pay you the amount less the fee, by hand, and you get "Your payment request has been accepted." when they have. If they reject the request, the whole amount comes back to your eWallet. Your PayPal address and bank details are filled in for you next time. The button is shown while your site allows withdrawals; asking also needs the permission of your role.

The Submit a payment request page with 40 shau entered, the PayPal and Bank Transfer choices with their minimums and fees, the PayPal e-mail fields filled in and Submit Request
The Submit a payment request page with an amount, the PayPal and Bank Transfer choices with their minimums and fees, and Submit Request. Screenshot taken 2026-11-17.

Your billing activities#

The list under your balance shows every movement with its Type, Status, Date, Gross, Fee and Net, newest first; View more shows older ones. Filter by type (for example Add funds, Send and receive funds, Transfer funds, Send and receive funds with platform, Commission earned from referral) and by date (Past 30 days when the page opens, Past 60 days, Past 90 days or Custom with two dates). The statuses are explained in Member wallets. Money you receive from tips, paid content or referral commissions arrives here, with a notification.

Change log#

Last updated: 2026-11-19 · v1.5.6

Date (GMT+7)SectionWhat changed
2026-11-17allFirst version for 1.5.6, written from the 1.5.6 code as a guide for site admins and members.
2026-11-17overview, member-wallets, mass-funds, using-the-walletCorrections after review: switching the eWallet off and featured pages; late confirmations after Cancelled or Failed; blocking works both ways; taking back tokens after a refund made at PayPal or Stripe.
2026-11-17settingsThe withdrawal example now uses the exchange rate as installed (1 USD = 1 token), with a note on a rate of 10.
2026-11-19settings, deposit-packagesThe full labels of two eWallet settings; the setting for test store purchases and the store product IDs of deposit packages now link to the mobile app settings.
2026-11-19deposit-packagesScreenshot of the deposit package form with the store product IDs.