Skip to main content

Cash wallet and refunds

Cash Wallet and Refunds is a level-0, write-capable source route for a cashback loyalty plan, business participation, and related settings. Its sidebar item requires addon_cash_wallet_and_refunds; the route can also mount while configuration is loading.

Do not use an empty production project

The base category view does not mount the plan controller. Selecting Cash wallet, or loading its matching ?id deep link, mounts it. If no requested plan exists, the controller reads businesses and can create a default cashback plan for the first result. Use a pre-provisioned non-production fixture only.

Runtime remains blocked even when a plan appears to exist: only a pre-provisioned synthetic cashback fixture or hermetic zero-create proof can satisfy re-entry.

My addons navigation without wallet plans, balances, refunds, or customer data

No control screenshot is included yet: safely capturing the wallet panel requires a non-production project with a pre-provisioned cashback plan. Opening that panel in an empty project merely to obtain a screenshot can create data.

What the page contains

Source defines General and Businesses tabs. A plan can contain a name, cashback type, rates, and per-business accumulation/redemption participation. Returned add-on settings can include refund-destination policy. These fields involve monetary value, orders, customers, businesses, and payment paths and were not read.

Plan and per-business controls map to loyalty writes. Staged setting changes are saved one configuration at a time, so an interrupted sequence can partially persist. No endpoint was called, and no success, rollback, refund, wallet, payment, or value-transfer effect is claimed.

Cash wallet uses cashback; points use credit_point. The labels do not establish a conversion formula. Rates, businesses, refund settings, balances, orders, and customer value remain excluded until the pre-provisioned synthetic fixture intercepts every read and mutation and proves provider/payment paths unreachable.

If no business is returned, source sets an error instead of creating the default plan. That branch does not make the panel safe: when a business is returned and no cashback plan exists, creation remains possible. This target stays blocked-and-excluded pending the exact re-entry evidence.


Related guides: Points wallet and levels