A refund or a dispute at the payment provider is invisible in the console #106

Open
opened 2026-09-21 07:18:31 +00:00 by cgalo5758 · 1 comment
Owner

What a person cannot do today

See that a payment was refunded or disputed, or issue a refund from the console. Refunds and disputes happen at the payment provider and never reach the console's mirror, so a payment the console shows as paid may already be reversed.

What they should be able to do

See refunds and disputes on the payment and the invoice they belong to, issue a refund from the console with a reason, and respond to a dispute with the evidence the provider asks for.

Why it matters

Money the console believes it has is the number every other figure rests on, and a reversed payment that stays invisible makes the billing pages wrong.

Where

The billing model (refund and dispute mappings), the webhook processors for the provider's refund and dispute events, the operator payments and invoice pages.

Done when

Refund and dispute events are projected, shown on the payment and invoice pages, and a refund can be started from the console.

## What a person cannot do today See that a payment was refunded or disputed, or issue a refund from the console. Refunds and disputes happen at the payment provider and never reach the console's mirror, so a payment the console shows as paid may already be reversed. ## What they should be able to do See refunds and disputes on the payment and the invoice they belong to, issue a refund from the console with a reason, and respond to a dispute with the evidence the provider asks for. ## Why it matters Money the console believes it has is the number every other figure rests on, and a reversed payment that stays invisible makes the billing pages wrong. ## Where The billing model (refund and dispute mappings), the webhook processors for the provider's refund and dispute events, the operator payments and invoice pages. ## Done when Refund and dispute events are projected, shown on the payment and invoice pages, and a refund can be started from the console.
cgalo5758 added the
kind
enhancement
area/billingarea/operator-ui
labels 2026-09-21 07:18:31 +00:00
Author
Owner

One consequence this does not name yet: delivery.

A refund or a lost dispute changes nothing in the console, so the plan the payment bought keeps delivering for the rest of the paid period, unless an operator also cancels the subscription at the payment provider. A cancellation there does reach the console and ends the plan. The guide (docs/stripe.md, "Acceptable in Stripe") says to handle disputes and issue refunds at the provider and does not say to cancel the subscription as well.

Two things follow. The guide should say so now. And whoever takes this issue has to decide whether a full refund or a lost dispute ends the plan by itself, and whether a plan is suspended while a dispute is open.

One consequence this does not name yet: delivery. A refund or a lost dispute changes nothing in the console, so the plan the payment bought keeps delivering for the rest of the paid period, unless an operator also cancels the subscription at the payment provider. A cancellation there does reach the console and ends the plan. The guide (`docs/stripe.md`, "Acceptable in Stripe") says to handle disputes and issue refunds at the provider and does not say to cancel the subscription as well. Two things follow. The guide should say so now. And whoever takes this issue has to decide whether a full refund or a lost dispute ends the plan by itself, and whether a plan is suspended while a dispute is open.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wiki-cafe/member-console#106