An invoice relates charges, credits, and payments together. When a subscription is created or renewed, or a charge is created on the account, Recurly will sum the charges, discount or tax as appropriate, and send the invoice out for collection. Your subscribers are notified of successful or failed invoice collection via email.


Your invoices dashboard provides an overview of all invoices generated by Recurly. The filters on this view allow you to bucket invoices into different categories for easy sorting:

Every invoice generated within your Recurly site.
All invoices that are pending collection. Recurly has not yet received payments for these invoices.
Past Due
All invoices that attempted collection, but payment failed. These invoices will be retried automatically through the dunning process.
All invoices that have either experienced 20 declines, or has been through the dunning process without successful payment. These invoices will not be retried.
All successfully collected invoices.

You may search for an invoice on any of the following fields:


By default, your invoices will contain the following information:

Company Details
Company information configured in your site settings.
Customer Details
The account holder's name and billing information.
Line Items
Invoice line items contain any subscription or add-on description, as well as quantities and descriptions for charges and credits applied to the invoice. For recurring charges, the line items will include the bill cycle covered by this renewal charge. If a discount is applied, then the amount discounted from any active coupons are identified by line item.
Subtotal of the line item amounts, after charges and credits are applied.
Total of the applicable taxes (as denoted by an asterisk in the line item rows). Customer must have a postal code and country for tax to be calculated. The customer address is taken from Billing Info for automatic invoices (e.g. - credit card, PayPal) and Account Info for manual invoices. See the full list of supported tax regions here.
Invoice total, after taxes and coupons.
Amount Paid
For refund invoices, the Amount Paid is not displayed.
Amount Due/Refund Amount
Amount currently due for the invoice. For refund invoices, the total refunded amount back to the customer
Credit to Account
The remaining credit applied back to the customer’s account from the current invoice.


Invoices will soon have two new notes sections. These notes will only show up on invoices if there is text in those sections. Notes can be configured to have site level defaults for all invoices, as well as be customized for specific invoices through the Admin or API. Site level defaults can be configured on the Invoice Settings page. Invoice specific notes are made when generating an invoice or creating/editing a subscription.

Terms and Conditions
An extra notes section for payment terms, payment details, legal notes, or whatever you like! The title of this notes section cannot be changed.
Customer Notes
An extra notes section for customer notes. This could be special details about the invoice, a note to say "thanks for your business", or whatever you like! The title of this notes section will not show on the invoice.


A subscription change with a timeframe of immediately will generate an invoice that displays additional line items that includes prorated tax amounts:

Prorating for remainder of subscription term
Charges from upgrading.
Remaining value for the subscription
Credit due to downgrade.



Subscription signups and one-time transactions are invoiced and collected upon immediately. Subscription renewals and manual charges are invoiced and then processed at the top of every hour.


An Open invoice can be manually marked as Closed by opening the invoice in your admin console and clicking the Stop Collection tab. This will give you two options:

Stop Collecting
Indicates that the invoice was not successfully paid for and that collection attempts should stop. This functionality is mostly used to halt the dunning procedures for an invoice.

Mark Paid
Indicates that the invoice was successfully paid for and that automated collection attempts should stop - this functionality is typically used to indicate that payment was received via another method and that revenue should be recognized.


When invoice collection fails, the invoice immediately enters a Past Due state and collection attempts will start based on your dunning management settings. Recurly will email the customer to alert them of the failed payment and automatically retry payment based on the card and error type. Reviewing the invoice details will display each collection attempt and reason for the payment decline. Recurly will stop trying to collect on an invoice after it has been attempted 20 times, or when the timeline in your dunning management settings has passed without successful collection.

Please Note: Stopping collection on an invoice will not automatically cancel the related subscription. The subscription needs to be canceled separately in order to stop the subscription from renewing again.

Invoice Numbers

All invoice start with number 1000 and increment by 1 with each invoice creation. If you need your invoices to start at a specific value, please contact Recurly support.


When a customer subscribes, their first invoice is automatically included in the New Subscription email template. Subsequent invoices are sent using the Payment Confirmation email template. Recurring invoices are not sent to customers when the total amount owed is $0.00. An invoice email can be resent by clicking the Resend Last Email button on a specific invoice. You can attach a PDF of the invoice to all of your invoice related emails by enabling this feature on the Invoice Settings page.


PDF invoices are available to merchants and customers through multiple venues.

PDF invoices are not customizable at this time.

Invoice Refunds

For refund and void transactions, Recurly creates a corresponding refund invoice for the refunded amount. You can initiate a refund from the original invoice by clicking the Initiate Refund directly to the left of an invoice and have the option to refund by line item or by a specific open amount.

Initiate Refund

Line item refunds

Line item refunds allows you to select the specific line items to refund from the invoice, including the quantity and whether or not you want to prorate the amount based on the current period. We handle the calculations for any discount or tax if applicable for the refund, which you can verify on the preview page before confirming the refund. The feature is available in your Admin Panel and also via API.

Select Line

Once you confirm and the refund is successful, we create a refund invoice so that you can pass along to your customer or store internally for your own records.

Refund Invoice

Open amount refunds

Open amount refunds allows you to specify the amount you’d like to refund irrespective of a particular line item. This may be case when you need to refund a partial amount of a line time that isn’t tied to the prorated amount, or simply a partial refund for a random amount due to special circumstances. Either way, Recurly let’s you set the custom amount for the refund as along as it does not exceed the amount of the transaction, or the amount remaining that’s available to refund. The feature is available in your Admin Panel and also via API.

Open Refund

Also for open amount refunds, we calculate in the tax if it was applied on the original invoice for you as part of the amount that you specify. Once the open amount is is confirmed, we provide you with the refund invoice that references the original invoice number, which you pass to your customer or store for your own internal records.

Open Invoice