Withdrawal
/my-account/wkwc_withdrawal/ — customers request wallet payout to their bank, PayPal, or custom payment method.
Prerequisites
| Requirement | Setting |
|---|---|
| Withdrawal feature enabled | Master switch in Settings → Payments → Wallet |
| Customer has positive wallet balance | (live) |
| Customer has saved at least one payment method | (filled-in below) |
Page layout
Two sections:
- Saved Payment Methods — accounts you've added (bank / PayPal / custom)
- Withdrawal Request — form to request a new payout
Plus a Request History table showing past withdrawals and their statuses.
Adding a payment method
Click Add Withdrawal Method at the top right.
A modal asks for:
| Method | Required fields |
|---|---|
| Bank transfer | Account holder name, bank name, account number, IFSC / SWIFT, branch |
| PayPal | PayPal email |
| Custom | Free-form fields configured by admin |
These details aren't validated automatically
The plugin doesn't verify your bank account exists. Admin manually reviews before approving payouts.
Saved methods appear in a list; you can edit or delete them. They're stored as encrypted user-meta.
Requesting a withdrawal
- Select a payment method (radio button)
- Enter amount — must be ≥ the configured minimum
- Add note (optional — context for admin)
- Click Request Withdrawal
The request is created with status pending. Your wallet balance is not debited until admin approves it (so the funds remain spendable on auctions until then).
Limits
| Limit | Default | Configurable in |
|---|---|---|
| Minimum withdrawal | 100 | Wallet settings |
| Maximum withdrawal per request | (admin-configurable) | Wallet settings |
| Daily withdrawal cap | (off by default) | Wallet settings |
| Withdrawal fee | 0 | Wallet settings |
If the limit is hit, the form shows an inline error before submission.
Request statuses
pending → approved → paid
↓
rejected
| Status | What it means |
|---|---|
| Pending | Submitted, waiting for admin review |
| Approved | Admin approved; payout in progress |
| Paid | Admin confirms payout completed; wallet balance debited |
| Rejected | Admin rejected; reason shown; wallet balance untouched |
Request History
The bottom of the page lists every withdrawal you've made:
| Column | Source |
|---|---|
| Request ID | unique reference |
| Method | bank / PayPal / custom |
| Amount | requested amount |
| Fee | deducted fee (if any) |
| Net | amount you actually receive |
| Status | per above |
| Submitted | timestamp |
| Updated | timestamp of last status change |
| Actions | View / Edit (pending only) / Delete (pending only) |
Click View for full details, including any admin rejection reason.
Editing / cancelling a pending request
While status is pending, you can:
- Edit — change the amount, method, or note
- Delete — cancel the request entirely
Once approved, no edits are allowed (admin owns the payout from there).
Notifications
| Trigger | |
|---|---|
| Request submitted | "Withdrawal request received" |
| Request approved | "Withdrawal approved — payout in progress" |
| Request paid | "Withdrawal sent — funds dispatched" |
| Request rejected | "Withdrawal could not be processed" with reason |
Templates editable in WooCommerce → Settings → Emails.
Admin-side workflow
What happens after you submit:
- Admin sees your request in Wallet → Withdrawal queue
- Admin reviews your saved bank / PayPal details
- Admin clicks Approve → executes payout (Stripe Connect, PayPal Payouts, manual bank transfer — depends on admin's setup)
- Admin clicks Mark Paid when payout completes
- Your wallet balance is debited
- You receive the "Withdrawal sent" email
Approval timing: typically 1–3 business days. Configurable SLA tracked on the admin side.
Why my withdrawal might be rejected
| Reason | Fix |
|---|---|
| Bank details incomplete | Edit saved method, add missing fields |
| Account name mismatch | Account holder name must match your registered name |
| Below minimum threshold | Wait until balance is higher |
| Recent disputes / chargebacks | Resolve disputes before re-requesting |
| KYC not completed (if required) | Submit KYC documents in My Account → Account details |
| Suspicious activity flagged | Contact support |
Security
- All withdrawal requests are logged in the Audit Log
- Bank details are encrypted at rest in user-meta
- Admin actions on your withdrawal are logged with timestamp + admin user ID
- The plugin does not initiate bank transfers automatically — admin manually executes each payout
Common questions
"How long until I get paid?"
After admin approval, payout depends on the method:
| Method | Typical |
|---|---|
| Bank transfer | 1–5 business days |
| PayPal | Same day or next business day |
| Custom | Depends on admin's payout system |
"Can I cancel a pending request?"
Yes — click Delete on the row. Only works while status is pending.
"Can I withdraw my full balance?"
Subject to minimums and any daily cap. If your balance exceeds the daily cap, split into multiple requests over consecutive days.
"Why can't I see this page?"
Withdrawal might be disabled in Settings → Payments → Wallet → Withdrawal. Contact support.