How to refund a Recurly invoice from a Zendesk ticket

By Jake Marsh · Updated

To refund a Recurly invoice without leaving Zendesk, install Tenurewell, open the customer's ticket, find the invoice in the sidebar and click Refund. Choose a refund by amount or by line item, send it to the original payment method or as credit on the account, pick a reason, then click the Refund button, which shows the amount. The ticket gets an internal note and the tenurewell_refund tag, and the Recurly account gets a matching note.

Before you start

Allow refunds must be on in Tenurewell's settings, and the agent must be in Who may take actions. The Recurly API key's own permissions must allow refunds; if they don't, the sidebar says Recurly "cannot do this". Admins can set Refund reasons for agents to pick from and a Largest refund without an admin.

Steps

  1. Open the ticket. Tenurewell finds the requester's Recurly account by every email on their Zendesk profile. If several accounts match, pick one from the list. If none do, type an email or account code into the Find box.
  2. Find the invoice. Invoices are listed with their status (Paid, Partly refunded, Refunded, Past due, Pending, Failed, credit invoices) and the amount still refundable.
  3. Click Refund. The Refund invoice panel opens and states exactly what will happen.
  4. Choose how much.
    • By amount: any amount up to the refundable amount.
    • By line item: pick the lines and quantities to refund.
  5. Choose where the money goes. To the original payment method, or as credit on the Recurly account.
  6. Pick a reason and add a note for your team if you like.
  7. Click the Refund button. It shows the amount, for example "Refund $20.00" (by line item it reads "Refund about $20.00", because Recurly calculates the exact figure with tax and discounts). Nothing reaches Recurly until you do.

What happens after you confirm

WhereWhat changes
Recurly invoiceA refund for the amount or lines you chose, to the payment method or as account credit.
Recurly accountA note naming the ticket and the agent (unless an admin turned this off).
Zendesk ticketAn internal note with the amount, the Recurly invoice and transaction numbers, the reason, the agent and your note, plus tenurewell_refund.

Each confirmation carries an idempotency key, so a double click or a dropped connection never refunds twice.

Control who can refund, and how much

SettingWhat it does
Who may take actionsadmin (default), agent for everyone, custom role ids or group:<id>, comma separated. Everyone else sees the sidebar read-only.
Allow refundsTurns refunds on or off.
Largest refund without an adminA limit in the invoice's currency. Above it, only an admin can refund. 0 means no limit.
Refund reasonsYour own list, recorded in the ticket note and the Recurly account note.

If the Refund confirm button is greyed out, the red box under it says why: over the refundable amount, over your limit, or a reason of Other without a note.

What it costs

Tenurewell is $10 a month per agent on the Standard plan, with every feature, billed monthly by Zendesk. It has a 14-day free trial, and Zendesk asks for a card at install. The full reference is in the Tenurewell documentation.

Tenurewell

Recurly subscription sidebar: refund, pause or credit from the ticket, with every action logged. $10 a month per agent.


Questions

Can I refund part of an invoice?

Yes. Refund a smaller amount, or refund by line item and pick quantities. The invoice then shows as Partly refunded.

What's the difference between refunding to the card and as credit?

To the original payment method returns the money. As credit puts the amount on the customer's Recurly account, where it applies to future invoices.

Why can't I see the Refund button?

Your role or group isn't in Who may take actions, refunds are switched off, nothing is left to refund, or you're on a user profile or a new ticket. Actions need an existing ticket.

How do I report on refunds given from Zendesk?

Every refund adds the tenurewell_refund tag, so a view or report filtered on that tag lists them, and each internal note carries the amount and reason.


More Tenurewell guides


More Zendesk guides