Refunds and take-backs

Refund orders from in game, and have rewards taken back by themselves on refunds, chargebacks and the end of timed items.

When money goes back to a player, the reward should go too. Emberstore takes it back by itself, once per order, whether the refund started in game or in the gateway's own dashboard, and even if the player is offline.

An admin refund through /store admin refund goes through the gateway API when it can refund, or is marked locally otherwise. A refund or chargeback made at the gateway arrives as an event. Both take the reward back once.

Refunding from in game

/store admin refund <order_id> [local]

Only completed orders can be refunded this way. A refund is always the whole order, partial refunds are not supported.
On Stripe, PayPal, Razorpay, Creem and Dodo Payments, the money is sent back through the gateway. If the gateway refuses, you see its reason and nothing changes.
On every other gateway, or when you add local, the order is only marked refunded and the reward is taken back. You then send the money back from the gateway's dashboard yourself.
You can type the first few characters (six or more) of an order id instead of the whole id, as long as only one order matches. Find ids with /store admin orders.

Refunds and chargebacks made at the gateway

On gateways that report them, a refund made in the gateway's dashboard and a chargeback (dispute) arrive by themselves and are handled the same way. Which gateways report what is on Payment gateways. A partial refund made in a gateway's dashboard is ignored, so take the reward back by hand if you need to.

What taking back means

revocation:
  # Take the reward back when an order is refunded
  on-refund: true
  # Take the reward back when an order is disputed or charged back
  on-dispute: true

Command items run their revoke-commands once per unit bought, for the player who received the item.
Economy items withdraw the amount through Vault. If the player has spent it, as much as their balance allows is taken, and the console says how much was missing.
Bundles take back every item in them.
Offline players get it on their next join (or on whichever server they join, on a network).
Timed items end their subscription. If the item had already ended, nothing is taken back a second time.
Each order is taken back at most once, however many refund or dispute messages arrive.

The end of a timed item always takes the reward back, whatever revocation says.

What staff are told

Players with emberstore.admin and the console get a notice for every refund and dispute. The notice also says when:

an item has no revoke-commands, so it must be taken back by hand
the order paid a referral reward, which is not taken back by itself

Disputes you win

A dispute later decided in your favour is not reversed by itself. Give the item back with /store admin give <player> <category> <item>.