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

ShaunSocial user guide 1.5.6 / Monetisation

Billing

Admin

The money settings every paid feature relies on: the real currency your site charges in, the site token (the credits members hold in their eWallet) and its exchange rate, the list of all subscriptions with the actions admins can take on them, the record of the money moving between your site and its members, and the Terms of Service members accept before they pay. Set the currency and the token first, then the payment gateways and the eWallet.

How this page was checked

Checked against the 1.5.6 code; the AdminCP screens were compared with a demo site. Cancelling and resuming subscriptions were read from the code, not run; screenshots follow.

Currencies and the site token#

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

Your site works with two kinds of money:

  • The default currency is a real currency (US dollar, euro …). It is what members are charged when they pay through a payment gateway, and what they receive when you pay out a withdrawal. Marketplace prices are also shown in it.
  • The site token is the credit members hold in their eWallet. Every price inside the site (feature packages, membership plans, ads, event entry fees) is set in tokens. The exchange rate decides how many tokens one unit of the default currency buys.

Moderators need the Manage Currencies switch in their role (see Moderator roles).

Choose the default currency#

The site comes with 12 currencies: US dollar (the default), euro, Japanese yen, British pound sterling, Chinese yuan, Australian, Canadian, Hong Kong, New Zealand and Singapore dollars, Swiss franc and Viet Nam dong.

  1. Open AdminCP → Billings → Manage Currencies.
  2. Switch on Default next to the currency you want.

    What you should see: that switch is on and every other one is off. The change is saved at once; there is no Save button.

Only one currency is the default at a time, and the current default cannot be switched off directly: switch on another one instead. Its Delete link is hidden.

Pick a currency your payment gateways accept

Members only see a payment gateway that accepts your default currency. PayPal and Stripe accept most major currencies, but not all the same ones (see Available gateways). If no active gateway accepts your currency, members who try to add funds see "Payment method is not available. Please contact admin for detail".

To add a currency that is not in the list, click Create new and fill in Name, Code (the three-letter code, for example NGN, which gateways use to recognise it) and Symbol (up to 16 characters), then click Submit. Edit changes the three fields; Delete removes a currency that is not the default, after you confirm.

The Currencies list with Name, Code, Symbol, Default and Action columns: twelve currencies, US dollar switched on as the default and without a Delete link
AdminCP → Billings → Manage Currencies: the 12 currencies with US dollar as the default. Screenshot taken 2026-11-17.

Name the token and set the exchange rate#

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

SettingAfter installingWhat it does
Token nameemptythe name of the credits, shown next to every amount in the site. Empty uses the first four letters of your site name in lower case (a site called ShaunSocial shows "shau")
Exchange rate1how many tokens one unit of the default currency is worth. The line under the field shows the result, for example "1 USD = 10 shau". Empty or 0 counts as 1

An example with US dollar and an exchange rate of 10:

  • a member who adds 100 shau to their eWallet pays 10.00 USD through the gateway (amounts are rounded to the cent);
  • a featured page package priced at 50 shau costs the member the same as 5 USD;
  • a member who asks to withdraw 500 shau is due 50.00 USD, less the withdrawal fee (see the eWallet settings).
Decide the rate before members pay

Changing the currency, the token name or the rate later applies everywhere at once, but nothing is converted. Balances keep their number of tokens and prices keep their number of tokens, so their value in real money changes. If you change the rate, review your package and plan prices, and the prices of the matching plans at PayPal and Stripe (see Recurring plans).

The Token name field, empty with its help text, and the Exchange rate field set to 1 with the line 1 USD = 1 shau
AdminCP → General Configuration, the eWallet part: Token name and Exchange rate with the line "1 USD = 1 shau". Screenshot taken 2026-11-17.

All subscriptions#

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

A subscription is anything a member pays for again every period: a membership plan, a featured business page, a featured marketplace listing, or a subscription to a creator's profile (paid content). This screen lists them all; moderators need the Manage Subscriptions switch in their role.

How a subscription renews#

  • Paid from the eWallet: when the period ends, the scheduled task takes the price from the member's eWallet (from the page's eWallet for a featured page) and starts the next period. If the balance is too low, the subscription stops at once and the member is told.
  • Paid through PayPal or Stripe: the payment provider charges the member and tells your site. The site waits a little longer than the period for that message (12 hours for PayPal, 24 hours for Stripe); if it has not arrived, the subscription stops. When the payment arrives later, the subscription starts again.
  • A charge after a subscription ended for good: if PayPal or Stripe still charges a member whose subscription stopped for good (for example because they moved to another plan), the site refuses the payment, stops the billing at the provider and notifies the first admin account (the one created when the site was installed). Refund that payment in your PayPal or Stripe account.
  • Reminders: a few days before each renewal the member gets a notification and an e-mail: 5 days before for memberships, featured pages and featured listings, 1 day before for creator subscriptions, after installing (each feature has its own setting). For a subscription paid from the eWallet whose balance is too low, that reminder is replaced by a request to add funds, and a final one can follow 24 hours before the renewal (see eWallet settings).
For your server administrator

Renewals, reminders and stops are done by the scheduled task (cron job), every five minutes. Without it, subscriptions are never renewed or ended. See What stops when the cron job does not run.

Find a subscription#

The list shows User, Status, Name (the feature, package and price, for example "Membership - Gold - 9 shau monthly"), Created date and the actions. Filter it with:

  • Search: the member's name or user name;
  • Status: Init (started through PayPal or Stripe but not paid, or not yet confirmed), Active, Cancelled (runs until its renewal date, then stops) or Stopped (ended);
  • Type: Membership, Page feature, Profile subscription or Listing feature;
  • Date: when the subscription was created, Past 30 days, Past 60 days, Past 90 days or Custom with a From date and a To date.
Older subscriptions are hidden at first

The list opens on Past 30 days, counted from the day each subscription was created. To find a member who subscribed earlier, choose Custom and leave both dates empty, then click Search.

View opens the details: the member, the created date, the status and, while it is active, the trial days, Subscription renewal date, You will be charged and Payment method (Wallet, Paypal or Stripe); a cancelled subscription shows Subscription will stop at. Under it, every payment is listed with its date, status, transaction ID and amount.

The Subscriptions list with the search, two status and type filters and Past 30 days, and Noah Kim's active Membership - Gold - 9 shau monthly with View and Cancel
AdminCP → Billings → Subscriptions with the filters and an active membership paid from the eWallet. Screenshot taken 2026-11-17.

Cancel or resume a subscription for a member#

  • Cancel (on the row or on the details) stops future renewals after you confirm. The member keeps what they paid for until the renewal date, then the subscription stops. Nothing is refunded. For PayPal and Stripe the site also stops the billing at the provider; if the provider refuses, you see "The payment gateway could not cancel this subscription. Please try again later." and nothing changes.
  • Resume undoes a cancellation before the renewal date, and renewals go on as before. If PayPal or Stripe refuses, you see "The payment gateway could not resume this subscription. Please try again later."

A member can cancel and resume their own subscriptions, but not one you cancelled: only an admin can resume that. Use this when you change the price of a package and want a member to move to the new price: cancel their subscription, and once it has stopped they subscribe again. Changing a package only affects new subscribers.

Your subscriptions#

Members find their own subscriptions in Settings → Subscriptions. Filter by Type and by Status (All, Active, Cancel, Stop) and click View to open one. The details show the renewal date, the price, the payment method and the Payment history.

  1. Click Cancel subscription.

    What you should see: "Cancel Subscription?" with the date the subscription ends. Access continues until then, and the remaining period is not refunded.

  2. Click Cancel Subscription to confirm, or Keep Subscription.

Until the end date you can click Resume subscription to keep it. A business page's subscriptions are under the page's own Settings → Subscriptions, while you are switched to the page.

Noah Kim's Settings, Subscriptions: the Gold membership with created date, renewal date, price 9 shau monthly, payment method Wallet, Cancel subscription and the Payment history with one paid line
Settings → Subscriptions, the details of a membership: renewal date, price, payment method, Cancel subscription and the Payment history. Screenshot taken 2026-11-17.

System's billing activities and wallet transactions#

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

Your site has an account of its own in the eWallet. Every time tokens move between a member and the site, the site's side of it is listed here, newest first, with the User, a Description, the Date and the Amount. Moderators need the System's billing activities switch in their role.

What happenedDescriptionAmount
a member added funds through a gateway, or you sent them funds with Transfer Mass FundsDeposit funds from [member]negative: tokens the site put into a member's eWallet (positive when you took funds back with a negative amount)
a member paid the site from their eWallet (membership, featured page or listing, ads, paid content fees …)Payment received for … (the feature)positive
a member asked for a withdrawalCast out funds to [member]positive: the tokens leave the member's eWallet. A rejected request adds the same line with a negative amount, because the tokens go back
the site paid a referral commissionReceive referral commission from …negative

Filter by member (Search), by type (Deposit, Payment, Withdraw) and by date (Past 30 days when the screen opens, Past 60 days, Past 90 days or Custom). Above the list, three totals add up the lines that match the filters, in tokens: Total deposits (shown as a negative number, by the rule above), Total payments received and Total withdrawal amount (included withdrawal fee).

The money itself is not here: card and PayPal payments are in your accounts at the payment providers, and you pay out withdrawals yourself (see Transfer fund requests). The eWallet of one member is in AdminCP → eWallet → Wallets → Transactions (see Member wallets).

System's billing activities with the search, type and date filters, the three totals, and two payments received: an Ads campaign by Sofia Rossi and a membership by Noah Kim
AdminCP → eWallet → System's billing activities: the three totals and two payments received, for a membership and an ads campaign. Screenshot taken 2026-11-17.

Terms of Service at paid checkout#

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

Before a member pays, they tick "I accept the Term of Service"; the button that pays stays greyed out until they do. The box is shown when a member adds funds, sends funds (also in chat), chooses how to pay for a membership, a feature package, a creator subscription or a paid post, and creates or boosts an ad.

The setting Terms of Service in the paid checkout URL (empty after installing) decides where the "Term of Service" link goes:

  • Empty: the site's own Terms of Service page. Write your terms there (see Static pages).
  • A web address: that page instead, for example terms kept on your company site. Enter the full address, starting with https://.

The link opens in a new tab, so the member does not lose what they filled in. See also the other settings of this part in Other general settings.

The Add fund to wallet dialog with 100 shau, the ready-made amounts, Paypal chosen, I accept the Term of Service ticked and the Proceed to add 100.00 shau button
The Add fund to wallet dialog with the "I accept the Term of Service" box ticked and the Proceed to add button. Screenshot taken 2026-11-17.

Change log#

Last updated: 2026-11-17 · 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-17currencies, subscriptionsCorrections after review: only PayPal and Stripe are covered; the message an admin sees when PayPal or Stripe refuses a cancel or resume; a charge after a subscription ended for good.