Ambikly Docs

Appearance

Store Credit Wallet PRO ​

A per-customer wallet for refunds, gift credit and goodwill, spendable at checkout.

Category: Customer · Enable at: Ambikly → Add-ons → Store Credit Wallet

What it does ​

An append-only ledger per customer, with the balance as the running sum. Customers apply credit at checkout; the amount is snapshotted at order creation and debited under a per-customer lock once payment lands. Refunds on payment methods that can’t refund can be issued as credit instead.

Capabilities ​

  • Append-only ledger — every grant and spend is auditable
  • Apply and clear credit at checkout
  • Per-customer lock before the debit is written
  • Offline-payment orders debit on status change
  • Refund-to-credit only for methods that can’t issue a real refund
  • Configurable minimum balance to apply
  • Manager adjustment endpoint

Turn it on ​

  1. Make sure Ambikly Pro is active and your license is activated under Ambikly → Settings → License.
  2. Go to Ambikly → Add-ons, find Store Credit Wallet and switch it on. There is nothing else to install.
  3. Open its settings panel and set the options listed below.
  4. Visit your storefront to confirm the new surface appears: [ambikly_store_credit_balance] shortcode.

Settings ​

Open the add-on's settings panel from Ambikly → Add-ons → Store Credit Wallet.

  • Credit refunds to store credit for non-refundable payment methods
  • Minimum balance applied at checkout

Where it appears ​

On the storefront

  • [ambikly_store_credit_balance] shortcode
  • “Store credit applied” line in cart totals
  • Apply / remove credit at checkout

In the admin

  • Manual wallet adjustment
  • Balance lookup

For developers ​

REST routes

  • POST /ambikly-pro/v1/cart/store-credit
  • DELETE /ambikly-pro/v1/cart/store-credit
  • GET /ambikly-pro/v1/store-credit
  • POST /ambikly-pro/v1/store-credit/adjust

Every route enforces the same capability checks as the rest of the API — see the REST API guide.

Core hooks it listens to

  • ambikly_cart_totals
  • ambikly_order_created
  • ambikly_order_paid
  • ambikly_order_status_changed
  • ambikly_order_refunded
  • rest_api_init

The full list is in the hooks reference.

Questions ​

Will a refund pay the customer twice? ​

No. Refund-to-credit only fires for payment methods that can’t refund, where crediting the wallet is the refund.

Can the same balance be spent on two orders at once? ​

No. The debit is re-validated against the live balance inside a per-customer lock.

Where does credit come from? ​

Manual adjustments, refunds on non-refundable methods, and any other add-on that writes a ledger row.

Works well with ​

Loyalty Points · Gift Cards

Turning it off ​

Switch the add-on off from Ambikly → Add-ons. Its settings and data stay in the database, so turning it back on restores exactly what you had. A lapsed license pauses it the same way — the store keeps selling on the free core, and nothing is deleted.

PROStore Credit Wallet is part of Ambikly Pro

One license covers all 35 add-ons — $199 a year or $549 once for a single site. Nothing here is sold separately.

See pricing →