ClocknextClocknextHelp
DocumentationAPI ReferenceMCP Tools
Dashboard
What is Clocknext?Getting started

Customers

CustomersCustomer detail

Billing

PurchasesSubscriptionsPackagesInvoicesPaymentsCredit NotesRefunds

Tracking

SignalsRevenue dashboardCustomer Portal

Settings

Profile settingsOrganisation settingsTeam MembersModelsTaxesIntegrationsAPI KeysWebhooks

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

StatusMeaning
PENDING_AT_GATEWAYAsked from the gateway, which hasn't answered yet. Paddle reviews refunds, which can take days.
SUCCEEDEDThe gateway sent the money back to the card.
FAILEDThe gateway couldn't complete it. The money returns to the invoice balance.
REJECTED_IN_GATEWAY_REVIEWThe 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

Credit Notes

Lower an Invoice, in full or in part, or give money back for a paid one — to the Customer's invoice balance or to their card.

Signals

Every usage report your servers send, with its status, its cost and why it was not counted, plus Retry and Reject.

On this page

What you can do hereWhat can be refundedRefund statusesRelated