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
- 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.
- Find the invoice. Invoices are listed with their status (Paid, Partly refunded, Refunded, Past due, Pending, Failed, credit invoices) and the amount still refundable.
- Click Refund. The Refund invoice panel opens and states exactly what will happen.
- Choose how much.
- By amount: any amount up to the refundable amount.
- By line item: pick the lines and quantities to refund.
- Choose where the money goes. To the original payment method, or as credit on the Recurly account.
- Pick a reason and add a note for your team if you like.
- 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
| Where | What changes |
|---|---|
| Recurly invoice | A refund for the amount or lines you chose, to the payment method or as account credit. |
| Recurly account | A note naming the ticket and the agent (unless an admin turned this off). |
| Zendesk ticket | An 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
| Setting | What it does |
|---|---|
| Who may take actions | admin (default), agent for everyone, custom role ids or group:<id>, comma separated. Everyone else sees the sidebar read-only. |
| Allow refunds | Turns refunds on or off. |
| Largest refund without an admin | A limit in the invoice's currency. Above it, only an admin can refund. 0 means no limit. |
| Refund reasons | Your 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
- How to collect a past-due Recurly invoice from Zendesk
- How to pause or cancel a Recurly subscription from Zendesk
More Zendesk guides
- How to pause or cancel a Chargebee subscription from Zendesk (Termwell)
- How to connect BaseLinker to Zendesk with an API token (Targwell for BaseLinker)
- How to cancel or pause a Stripe subscription from Zendesk (Tillwell)
- How to show BambooHR employee info in Zendesk (Staffwell)