Skip to content
Farin Theme Guide
GuidesSales and Customers

Wallet

With the wallet, each buyer has a balance in the store. They top it up through the payment gateway, buy with it, and the money from cancelled orders returns to it. You can see balances, add or deduct manually, and review withdrawal requests.

Where is it? Farin → Wallet

This section handles buyers' moneyEvery increase, decrease, payout or rejected withdrawal request changes the buyer's real balance and is recorded in their transaction history. The wallet works with WooCommerce; without WooCommerce a message appears instead of this section.

This section has four tabs: “Buyers”, “Transactions”, “Withdrawal requests” and “Settings”. Amounts are in the site's currency; in the pictures it is Toman.

Buyers

The Buyers tab with four counters, the increase or decrease balance form and the buyer wallets table
Four counters at the top, the “Increase or decrease a buyer's balance” form in the middle, and the “Buyer wallets” table at the bottom.

The counters: “Balance of all wallets” (money you are holding), “Top-ups in the last 30 days”, “Wallet purchases in 30 days” and “Pending withdrawals”.

Increase or decrease a buyer's balance

  1. Find the buyer. Enter their username, email or mobile.
  2. Choose “Increase” or “Decrease” and enter the amount.
  3. Enter the reason. A reason is required and the buyer sees it in their wallet history; for example “Compensation for delay in shipping order 1234”.
  4. Click “Record”. The balance updates immediately.

The “Buyer wallets” table shows each buyer, their transaction count and balance. Use “Search buyer” to find one person. Click a buyer's name to open that person's transaction list.

Transactions

Transactions with transaction type buttons and a table of buyer, description, amount and time
Each money movement is one row: buyer, description, amount and time. Added amounts are shown with + and in green.

All money movements are recorded here and can be separated with the buttons at the top: wallet top-up, top-up reversal, order payment, partial order payment, order refund, purchase reward, purchase reward reversal, admin increase, admin decrease, withdrawal request and withdrawal request reversal.

Each movement has a unique ID, so a payment or a refund is never counted twice.

Withdrawal requests

The Withdrawal requests tab with buttons for On hold, Paid, Rejected, Cancelled and All
This tab opens on “On hold”.

When “Withdrawal” is on in settings, the buyer requests an amount in their account panel to be paid to their IBAN or card. The amount is deducted from their wallet at once. Each buyer can have only one pending request at a time, and until it is reviewed they can cancel it themselves.

Each row shows the buyer, the account (IBAN or card, and the account holder's name), the fee and the “Payout amount”. “Copy number” copies the account number for your banking app.

  1. Send the payout amount to the buyer's account yourself. Farin does not move any money.
  2. Write in the “Reference number or reason” field. For a payout, the bank's reference number; for a rejection, the reason.
  3. Click “Paid” or “Reject”. With “Reject”, the amount returns to the buyer's wallet.
Pay first, then press the button“Paid” only records that you have sent the money. Click it after the real payout.

Settings

Settings has five boxes and saves instantly.

Wallet

The wallet box with the toggle on, the wallet name and the text under the balance
The “Wallet” page in the account panel is visible only when this toggle is on.
OptionWhat it doesDefault
Wallet onTurns the whole wallet on and off.On
Wallet nameThis name appears at checkout and in orders. Up to 40 characters.Wallet
Short text under the balanceA sentence under the balance in the account panel, up to 200 characters.Empty

Pay with wallet

The pay with wallet box with two toggles and the text under the payment method
Two ways to pay with the balance: the whole order, or part of it.
OptionWhat it doesDefault
Pay the whole order with the walletThe wallet becomes a payment method at checkout when the balance covers the whole order.On
Text under this payment methodThe description under this method at checkout.Pay from your wallet balance, without going to the payment gateway.
Pay part of an order with the balanceA toggle appears above the payment methods: the balance is deducted from the order amount and the rest is paid through the payment gateway. If the order is cancelled or its payment fails, that amount returns to the wallet.On

If an order paid with the wallet is cancelled or refunded, even partially, its money returns to the buyer's wallet.

Wallet top-up

The wallet top-up box with minimum and maximum amount and preset amounts
Preset amounts are the buttons the buyer sees on the top-up form.
OptionWhat it doesDefault
Let the buyer top up the walletThe top-up form in the account panel. The buyer enters an amount or taps a preset amount and pays through the payment gateway. After payment, the balance is added.On
Minimum amountThe minimum amount per top-up.10,000
Maximum amountThe maximum amount per top-up.50,000,000
Preset amountsSeparate with commas; up to six amounts, between the minimum and maximum.100,000, 200,000, 500,000, 1,000,000
A payment gateway is requiredPay on delivery is not offered for top-ups. If no payment gateway is on, a warning appears in this box and the buyer sees a message instead of the top-up form. Set up the payment gateway from Payment gateway .

Purchase reward

The purchase reward box with the toggle off
Until the toggle is turned on, the percentage and cap are hidden.

When an order becomes “Completed”, a percentage of the price of its items (after discount, excluding shipping) goes to the buyer's wallet. When an order is cancelled or refunded, the reward is taken back, and when part of an order is refunded, the reward is reduced in the same proportion. Wallet top-ups earn no reward.

OptionWhat it doesDefault
Purchase reward onTurns the reward on and off.Off
PercentageWhat percent of the item price is given as a reward.2%
Maximum rewardThe reward cap per order. 0 means no cap.200,000
Minimum purchaseOrders below this amount receive no reward.0

Example: with 2% and a cap of 200,000 Toman, an order of 3,000,000 Toman gets a 60,000 Toman reward, and an order of 20,000,000 Toman gets the 200,000 Toman cap.

Wallet withdrawal

The wallet withdrawal box with the toggle off
Withdrawal is closed by default.
OptionWhat it doesDefault
Let the buyer request a withdrawalThe withdrawal request form in the account panel.Off
Payout to IBANThe buyer can provide an IBAN (IR and 24 digits).On
Payout to cardThe buyer can provide a 16-digit card number.On
Minimum withdrawal amountRequests below this are not accepted.100,000
FeeA percentage deducted from the payout amount. 0 means no fee.0%
Guide textText the buyer sees next to the withdrawal form.Requests are reviewed on business days and paid into your account.

Frequently Asked Questions

I cancelled an order that was paid through the payment gateway. Does its money go to the wallet?

Not automatically. Only the part that was paid with the wallet returns. If you want to give the gateway payment to the wallet as well, record it from the “Buyers” tab with “Increase” and a clear reason.

The buyer does not see the top-up form.

Check “Wallet on” and “Let the buyer top up the wallet”, and make sure at least one online payment gateway is on.

I added an amount to someone's wallet by mistake.

Deduct the same amount with “Decrease” and the reason “Correction of a mistaken entry”. Transaction rows are never deleted; both rows remain.

Farin Theme · 1405