Skip to main content

How to Refund an Invoice Paid Through Stripe

Last updated

Refunds can't be started from inside Adracare. You issue the refund in your clinic's Stripe account. Stripe then tells Adracare, and the invoice status updates on its own.

Before you start

  • This only applies to invoices paid through Stripe (Stripe - Send payment link or Payment method on file). Invoices paid by Manual (e-transfer, cheque, processed in person) or Third Party Payers have no refund status in Adracare.
  • If you refund a Manual payment outside Adracare and want the invoice to stop showing as Paid, an admin can move it back to Sent (if this is enabled for your role) and then change it to Void. Moving it back to Sent sends the client an Undo Paid Status notification. See How to Update an Invoice Status.
  • You need to be able to sign in to your clinic's Stripe Dashboard. Clinics that connected their own account with Connect A Stripe Account have a Stripe Dashboard login.
  • Some older clinics had their Stripe account created inside Adracare instead. Their Payment Configuration page shows the Enter your banking information for depositing collected patient payments section. These accounts don't have a Stripe Dashboard login. Contact [email protected] with the invoice number to have the refund issued.

Note: Refunds come out of your available Stripe balance. Stripe doesn't give back the processing fee it charged on the original payment.

How to Issue a Refund

  1. In Adracare, click Invoices in the left menu. If you aren't an admin, this menu item is called My Invoices.
  2. Find the invoice you want to refund. Note the invoice number, client, date and amount.
  3. Sign in to your Stripe Dashboard and find the matching payment. The Adracare invoice number doesn't appear in Stripe. Search by the client's name or email, then match the amount and date.
  4. Issue a full or partial refund by following Stripe's guide: Refund and cancel payments.
  5. Go back to Invoices in Adracare. As Stripe processes the refund, the invoice's Status changes to a refund status. Like other Stripe transactions, a refund usually takes 5 to 10 business days to complete.

Note: If you bill many invoices through Stripe, the Invoice Summary report (under Settings, then Reports) lists each invoice's stripe_invoice_id and stripe_invoice_number. You can search for these in your Stripe Dashboard. See Generating Reports.

Note: You can't set a refund status by hand. Only Stripe updates it.

What Each Refund Status Means

  • Refund Pending: Stripe has accepted the refund and is still processing it. The money hasn't reached the client yet.
  • Refund Succeeded: Stripe has sent the refund. It can take 5 to 10 business days to show on the client's statement.
  • Refund Requires Action: Stripe needs something more before it can finish the refund, usually the client's bank details. Check the refund in your Stripe Dashboard.
  • Refund Failed: The refund couldn't be completed, for example because the client's card or bank account was closed. See When a Refund Fails below.
  • Refund Cancelled: The refund was cancelled in Stripe before it finished. The client didn't receive the money.

To find all invoices in one of these states, pick it from the Select a status filter at the top of Invoices.

Seeing the refund details

Each refund update is added to the invoice's activity log. It shows the reason picked in Stripe (Requested by customer, Duplicate, Fraudulent or Other). For a successful refund, it also shows the amount refunded.

  1. Go to Invoices.
  2. Find the invoice and click the cabinet icon in its row.
  3. The Invoice Activity Logs window opens. Refund updates are listed with the actor Stripe API.

Note: You only see the cabinet icon if your role has the Invoice Activity Logs feature turned on in Access Management.

Partial Refunds

You can refund part of a payment in Stripe. Adracare handles it like this:

  • There is no separate "partially refunded" status. A partial refund shows the same statuses as a full refund, such as Refund Succeeded.
  • The invoice amount doesn't change. The refunded amount only appears in the invoice's activity log.
  • If you send more than one partial refund for the same invoice, a new log entry is only added when the status changes. A second refund that ends in the same status as the first one doesn't get its own log entry. Check your Stripe Dashboard for the full list of refunds.
  • The Invoice Summary report shows the refund status in the invoice_status column, but not the refunded amount. Its amount columns still show the original invoice.

What Your Client Sees

  • Adracare doesn't send the client an email or text about the refund. Stripe can email the client a refund receipt if Refunds is turned on in your Stripe Dashboard under Settings, Business, Customer emails. See Stripe's guide to automatic receipts.
  • On the client portal's Invoices page, the status filter only offers Outstanding and Paid. A refunded invoice no longer appears there under either one.
  • On the appointment in the client portal, the Invoices section still lists the invoice while it is Refund Pending or Refund Requires Action. The client sees the status as "Refund pending" or "Refund requires action". Once the refund succeeds, fails or is cancelled, the invoice is no longer listed there.

Because the portal doesn't show completed refunds, we recommend telling your client directly when you issue one.

When a Refund Fails

If an invoice shows Refund Failed:

  1. Open the refund in your Stripe Dashboard and check why it failed.
  2. Read Stripe's guide on failed refunds. When a refund fails, the bank returns the money to Stripe and Stripe adds it back to your Stripe balance. This can take up to 30 days.
  3. Contact your client to confirm their payment details.
  4. Refund the client another way, such as e-transfer or cheque, or follow Stripe's guidance to try again.
  5. If you issue a new refund in Stripe and it succeeds, the Adracare status changes to Refund Succeeded.

Note: If Stripe shows a refund as complete but the Adracare invoice still says Paid after 10 business days, contact [email protected] with the invoice number.

Note: After a refund succeeds, fails or is cancelled, the appointment no longer counts as having an invoice. You can create a new invoice for it without a duplicate-invoice warning. While the refund is Refund Pending or Refund Requires Action, the invoice still counts. See How to Prevent Duplicate Invoices for an Appointment.

Related articles

Was this article helpful?