Skip to Content

Refunds and cancellation

Open a customer and select the relevant paid product grant in its payment history. Actions depend on the grant’s source, status, linked payment and subscription. Do not use customer suspension or deletion as a substitute for stopping billing.

Refund a Stripe payment

For an eligible paid Stripe grant, choose a full remaining refund or a partial amount. A partial refund must use the payment’s currency and cannot exceed its remaining refundable balance. The configured Stripe account and mode must match the original payment.

The action has an operation ID for retry handling. Reuse the same operation when retrying a request whose outcome is uncertain; do not create a new refund simply because a response was lost.

Provider acceptance does not always mean completion. A refund can be pending or require further action, and provider events reconcile its final state. A correlated full refund marks the access grant refunded. A partial refund does not trigger that full-refund access rule.

A refund does not by itself cancel recurring billing. If future billing must stop, use cancellation as well.

Cancel a subscription

Cancellation is available for eligible active or refunded paid Stripe grants with a linked, nonterminal subscription. The cancellation action requests immediate cancellation from Stripe. Its accepted response identifies the subscription; local history can update later through reconciliation.

unpaid ends local access but is not a final provider state. It can still require cancellation. canceled and incomplete_expired are final states for this integration.

Refund and cancel

The combined action prepares a full refund and immediate cancellation, then executes both independently. Read both outcomes:

RefundCancellationWhat remains
AcceptedAcceptedVerify provider completion and local reconciliation.
AcceptedFailedResolve cancellation; do not issue another accepted refund.
FailedAcceptedResolve the refund; recurring cancellation does not refund payment.
FailedFailedInspect both errors before retrying.

There is no automatic rollback of a successful half. A network interruption can also leave an unknown result rather than an explicit rejection. Inspect the payment and subscription before retrying; do not present the combined operation as atomic.

App Store purchases

These refund/cancel controls are Stripe operations. Do not promise they perform App Store refunds or subscription management. Use the relevant Apple customer/support workflow and reimport verified purchase state where required by your integration. See App Store billing.

Last updated on