User Documentation
What You Need
- WordPress admin access with WooCommerce management capability.
- WooCommerce active.
- For Stripe sync: WooCommerce Stripe settings must contain the active secret key, or a developer must provide one through
webme_pdm_lite_stripe_secret_key. - For WooPayments sync: a developer must attach a payload provider to
webme_pdm_lite_woopayments_payloads.
First Run
- Activate plugin.
- Open
WooCommerce > WebMe Payout Matcher. - Set sync window days.
- Review provider status cards.
- Run
Manual resync.
Reading The Payout List
Each payout row shows:
- provider
- arrival date
- payout status
- provider net amount
- unmatched item count
Click a payout ID to open detail.
Reading Payout Detail
Detail view shows:
- reconciliation totals: gross, fees, refunds, adjustments, expected net, provider net, gap
- export buttons for summary and detailed CSV
- payout line-item table with transaction ID, order, refund, net, confidence, reason, review state, notes
If the reconciliation gap is non-zero, the plugin shows a warning before export.
Confidence Levels
| Confidence | Meaning |
|---|---|
matched | Transaction metadata or refund metadata matched directly. |
inferred | One likely paid order matched by amount and date window. Review before bookkeeping use. |
unmatched | No reliable WooCommerce match found. |
CSV Exports
Export summary CSV: one row per payoutExport detailed CSV: one row per payout item
Detailed export keeps formula-like values safe for spreadsheet software by prefixing risky cells.
Troubleshooting
| Status code or symptom | Meaning | Action |
|---|---|---|
missing_woocommerce | WooCommerce not active. | Activate WooCommerce. |
missing_secret_key | Stripe secret key not found in expected settings. | Verify WooCommerce Stripe config or inject key by filter. |
needs_payload_provider | WooPayments plugin exists but no payout payload source is attached. | Add companion integration for webme_pdm_lite_woopayments_payloads. |
not_detected | WooPayments not present. | No action needed unless WooPayments support is expected. |
| Reconciliation warning | Totals do not net cleanly. | Review adjustments, unmatched lines, and provider classification before export. |