Documentation
Refunds
Send money back to a Customer's card, from a credit note, when you cancel a subscription, or from their invoice balance.
A refund is money going back to a Customer's card. It is paid out of the money you owe them, and the payment gateway (Stripe or Paddle) sends it to the card that paid. There is no Refunds page: you start a refund from a credit note, when you cancel a subscription, or over the API, and you follow it in the Customer's invoice balance history (Manage tab, View details).
What you can do here
- Refund a paid Invoice to the card by issuing a credit note with Refund to: Card (owners and admins).
- Refund the unused time of a subscription to the card when you cancel it: choose Create proration and Refund to: Card in the cancel dialog. See Changing the plan or cancelling.
- Refund part of a Customer's invoice balance to their card with the API. This isn't in the dashboard.
- Follow a refund's progress in the Customer's invoice balance history, or by the Refunded and Refund failed status tabs on the Credit notes page.
What can be refunded
Only card credit goes back to a card: money a card paid, which became credit through a credit note or a plan change. Cash and goodwill (a balance you added by hand) can only pay Invoices; it is never refunded to a card. Hover the Invoice balance figure on the Customer to see the split between From card payments and Cash and goodwill.
When you cancel a subscription, the refund can go to the card only when the card paid the whole refund. Otherwise it can only go to the invoice balance, and Card is greyed out with the reason.
Each refund goes back to the payment it came from. A request larger than one payment's card credit is split across payments, so one request can make several refunds.
Refund statuses
| Status | Meaning |
|---|---|
PENDING_AT_GATEWAY | Asked from the gateway, which hasn't answered yet. Paddle reviews refunds, which can take days. |
SUCCEEDED | The gateway sent the money back to the card. |
FAILED | The gateway couldn't complete it. The money returns to the invoice balance. |
REJECTED_IN_GATEWAY_REVIEW | The gateway refused it. The money returns to the invoice balance. |
The money leaves the invoice balance first, and the gateway is asked next. A
failed or rejected refund puts it back, and the balance history shows Refund
failed, money returned or Refund rejected, money returned. The gateway's
reason is the refund's failureReason over the API.
On the Credit notes page, a credit note that asked for a card refund reads Issued until the gateway answers. It then reads Refunded, or Refund failed when the refund failed or was rejected.
Related
- Credit notes — issue one to refund an Invoice.
- Subscriptions — cancel a subscription and refund its unused time.
- Customer detail — the invoice balance and its history.
- API: List refunds · Refund to the card · Get a refund