R Rafina Panel guide
Guides / Sales and customers

Wallet

A customer tops up their account and pays orders without going to a gateway. From this page you configure the wallet and cashback, increase and decrease each user's balance, and give a group a top-up gift.

Where is it? Rafina Panel → Wallet

Wallet box with the active switch and paying the order with balance
Wallet main switches

Wallet top-up goes through the active gateways of “Rafina Panel ← Payment gateway”. Changes in the settings sections are saved with the “Save wallet settings” button in the bottom bar; the two boxes for manual and bulk top-up have their own buttons and run immediately.

Wallet

OptionWhat it doesDefault
Wallet is activeThe “Wallet” section is added to the user panel.On
Pay for the order with wallet balanceThe “Wallet” payment method on the checkout page; shown only when the balance is sufficient.On

Cashback

Cashback box with the switch, type, percentage, cap, minimum amount and transaction description
A percentage of each purchase returns to the customer's wallet

Cashback returns to the customer's wallet after the order is completed, not at payment. Nothing is credited until the order becomes “Completed”, and if the order is returned or canceled, its cashback is taken back. The calculation base is “total goods minus discount”; shipping cost and tax aren't counted.

OptionWhat it doesDefault
Cashback is activeOnly for logged-in users; a guest order has no wallet.Off
What cashback is for“Product purchases only”, “Wallet top-ups only” or “Both”. Top-up cashback means a “top-up gift”: every time the user tops up their wallet they get this percentage extra; mind the cap.Purchases only
Cashback percentageA number between 0 and 100; decimals are written with a dot.2
Cashback cap per order (Toman)The maximum cashback for one order. 0 means no cap.200,000
Minimum order amount (Toman)Smaller orders get no cashback. 0 means every order qualifies.0
Transaction descriptionThis text is seen in the customer's wallet ledger.Purchase cashback

Top-up amount

Top-up amount box with minimum and maximum amount, suggested amounts and the description under the balance
The allowed top-up range and the ready-made amount buttons the customer sees
OptionWhat it doesDefault
Minimum top-up amount (Toman)Less than 1,000 Toman isn't accepted.10,000
Maximum top-up amount (Toman)The cap for each top-up.50,000,000
Suggested amountsSeparate with commas, for example 50000, 100000, 200000. They are shown as quick buttons in the user panel.50, 100, 200 and 500 thousand
Description under the balanceThis sentence is written under the balance amount in the user panel.Default text

Top up one user's wallet

Single-user top-up form with user search, amount, type and reason
Increase or decrease one user's balance
  1. In “User” write the name, mobile number or email and choose the user from the results.
  2. Write the “Amount (Toman)”.
  3. Set “Type” to “Increase balance” or “Deduct from balance”.
  4. In “Reason (optional)” write the reason, for example gift, refund or compensation; it is seen in the user's transactions.
  5. Press “Submit”. The transaction is recorded in that user's ledger at once.

Bulk top-up

Bulk top-up form with target group, amount, type, reason and user list
Top up all users or a specific group
OptionWhat it does
Target group“Manual list”, “All users” or one of the “Role: …” options for a user role (for example customer, shop manager or vendor).
Amount (Toman), type, reasonThe same boxes as the single-user top-up.
User listOnly for “Manual list”: one mobile number, email or username per line.
Start bulk top-upThe work runs in batches of 25, so even with thousands of users the page doesn't time out. Don't close this page until it finishes.
WarningBulk top-up has no automatic undo. Check the group and amount again before “All users”; to reverse it you must repeat the same job with “Deduct from balance”.

Wallet withdrawal

A customer requests their wallet balance to their own bank account. The amount is deducted from the wallet and held at once; you make the deposit and press “Deposited”, or reject the request and the amount returns to the wallet. It is off by default and until the “Wallet withdrawal is active” switch is on, only that switch and the “Save withdrawal settings” button are shown; turning it on opens the options below.

Wallet withdrawal box with the active switch and the save withdrawal settings button, and the withdrawal requests box with tabs and search
The “Wallet withdrawal” and “Withdrawal requests” boxes
OptionWhat it doesDefault
Wallet withdrawal is activeOff means the customer doesn't see the withdrawal box and no request is accepted.Off
Withdrawal methods“Deposit to IBAN (Sheba) number”, “Deposit to card number” or both. The customer registers whichever is on once in their account.IBAN (Sheba)
Minimum and maximum amount of each withdrawalA maximum of zero means no cap; the amount never exceeds the balance.100,000 and no limit
Fixed and percentage feeDeducted from the amount itself and never exceeds it; the customer sees the “deposit amount” before submitting.Zero
Identity check before withdrawal“No check”, “Only users who are authenticated (Shahkar)”, or “Authenticated and the bank account is in the name of the same national ID”. The third is checked with the Authentication section's “National ID and IBAN” or “Card and national ID” service, and each account costs an inquiry fee only once.No check
Note for the buyerOne sentence under the withdrawal box title, for example the deposit time.Empty

This box's “Save withdrawal settings” button is separate from the bottom save bar. If you choose an identity check whose service isn't on in Authentication, a red warning with a link to that section appears under the box.

Withdrawal requests

  1. The “Withdrawal requests” box has the tabs “Awaiting deposit”, “Deposited”, “Rejected”, “Canceled” and “All” with each one's count, and a “Search name, account number or account holder” box. The “Awaiting deposit” tab shows open requests with customer name, their current wallet balance, amount, fee and “deposit amount”. The full IBAN or card is visible right there and has a “Copy” button.
  2. Transfer the deposit amount to that account at the bank.
  3. Press “Deposited”, write the “Deposit tracking number” and “Submit”. The customer sees the number in their history and is notified if the “Withdrawal deposited” SMS and email are on.
  4. To reject, press “Reject request” and write the reason; the amount returns to the wallet at once and the reason is sent to the customer.

Each customer has only one open request at a time and while it's pending they can cancel it themselves. The customer sees the withdrawal box in their account, “Wallet” section; in the dedicated app, the “Wallet withdrawal” tile on the wallet page.

User balances

In the “User balances” box at the bottom of the page “Total wallet balances” and “Users with a balance” are written, with a table of the columns “User”, “Email”, “Balance” and “Last transaction”. Find a specific user with “Search user…” and the “Search” button.

FAQ and troubleshooting

The wallet payment option doesn't appear on the checkout page.

This option shows only when the wallet and “Pay for the order with wallet balance” are on, the buyer is logged in and their balance is above zero.

Cashback hasn't reached the customer's account.

Cashback is credited only when the order becomes “Completed”. If orders stay in “Processing” or “Shipped”, complete them after delivery.

How does a customer top up their wallet?

In their account, “Wallet” section, they write the amount or press one of the suggested buttons and pay through one of the active gateways.