# Renewal

> How each subscription is charged again every period, on the saved card or with a renewal charge by PIX and boleto. What happens when a renewal isn't paid, add-ons and coupons at renewal, contracts and the emails.

At the end of each period, the subscription is charged again and the period moves forward, without anyone in the community having to do anything. How it is charged depends on the method the person pays with.

## What it's for

Renewal is what turns a sale into recurring revenue. A community with 200 subscribers to Student Monthly (R$ 49) renews 200 charges a month; each one that fails without anyone noticing is a lost subscriber. Understanding how renewal works is understanding where money slips away.

## How it works

### The cycle

<div class="flow">
<div class="flow-row"><span class="flow-node">Active subscription</span><span class="flow-arrow">→</span><span class="flow-node">Next charge date</span><span class="flow-arrow">→</span><span class="flow-node">Charge</span><span class="flow-arrow">→</span><span class="flow-node">Paid: the period moves forward</span></div>
<div class="flow-row"><span class="flow-node">Not paid</span><span class="flow-arrow">→</span><span class="flow-node">Past due</span><span class="flow-arrow">→</span><span class="flow-node">Pay now</span><span class="flow-arrow">→</span><span class="flow-node">Active again</span></div>
</div>

### On the card

On the next charge date, the subscription is charged to the **saved card**: the card it was paid with, or the member's **default** card under **Billing**. The period only moves forward once the payment is **confirmed**.

- Approved: the period moves forward and the member gets *"Renewal charged: …"*.
- Declined: the subscription becomes **past due** and the member gets *"We could not renew …"*.

With [annual in installments](/monetizacao/anual-parcelado), the renewal charges the year again on the card, in the same number of installments as the purchase.

### By PIX and boleto

**Renewal charge**: **5 days before** the due date, the platform generates a PIX or a boleto, with the same method as the purchase, for the **same subscription**, and sends it by email (*"Renew …: your PIX is ready"* or *"…: your boleto is ready"*). The code also shows under **Billing** (*"Renewal: pay by 11/15 · R$ 129.00"*). The PIX is valid until the due date; the boleto is due on it.

- **Paid**: the period moves forward.
- **Not paid by the due date**: the subscription becomes **past due**, with no second automatic charge for the same period. The member sorts it out with [Pay now](/pagamentos/pagar-agora).
- **Card saved after the charge**: if the member saves a card before the due date, the card is charged on that date and the PIX or boleto charge is canceled. A saved card always takes priority.


### Add-ons and coupons at renewal

- [Add-ons](/monetizacao/adicionais) billed with the plan renew **in the same order**, on the same date, with the fixed fee charged only once.
- A **forever** or **repeating** [coupon](/monetizacao/cupons) keeps discounting renewals for the agreed time; **once** applies only to the first charge.
- A [downsell](/monetizacao/downsell) discount follows the offer's rule (1st charge, N charges or for as long as it lasts).

### Contracts

On an option with a [contract length](/monetizacao/duracao-do-contrato), the monthly renewal carries on as normal until the end of the contract; at the end, the contract renews for another period of the same length, unless the member canceled before.

### Cancellation

Canceling doesn't refund what was already paid: access continues until the end of the period, and there is no new renewal. With a contract, the cancellation takes effect at the end of the contract. On the yearly plan, there is no refund: access lasts until the end of the year.

### Past due and access

A **past due** subscription keeps showing under Billing with the notice to pay, and in the billing option's list as **Past Due**.

## A renewal's timeline

**On the card** (subscription with the next charge on the 20th):

| Day | What happens |
|---|---|
| 20 | The platform charges the saved card |
| 20 | Approved: the period now runs until the 20th of the following month, and *Renewal charged* arrives |
| 20 | Declined: the subscription becomes **past due**, and *We could not renew* arrives |
| 21 onwards | The member changes the card and uses **Pay now** |

**By PIX** (next charge on the 20th):

| Day | What happens |
|---|---|
| 15 | The renewal PIX arrives, valid until the 20th; it also shows under Billing |
| 15 to 20 | The member pays: the period moves forward to the 20th of the following month |
| 20 | No payment: the subscription becomes **past due** |
| 21 onwards | **Pay now** generates a new PIX for the period |

## What the team sees

- Under **Monetization › Options**, the **Subscribers** column for each option.
- The **Past Due** status on subscriptions.
- Paid renewals go into the statement as sales, each with its fee.
- The **Dashboard** adds each renewal to **Total Revenue**.

## How to reduce late payments

1. **Prefer the card** for subscriptions: it renews on its own. Say so in the option's description.
2. **Offer the yearly plan**: one renewal a year instead of twelve.
3. **Ask for the card during the free trial** (**Require Card for Trial?**), so the first charge doesn't depend on the member coming back.
4. **Remind members to keep their card up to date** under **Billing**, especially close to the card's expiry date.
5. **Keep an eye on who is past due** and send them the way to **Pay now**.

## Examples with numbers

**Student Monthly (R$ 49), card.** Every 10th, R$ 49 on the saved card. Each month, R$ 43.08 is left for the community (fee R$ 5.92).

**Growth Monthly + Coworking (R$ 579), card.** Every 20th, one order of R$ 579. Fee R$ 42.96. R$ 536.04 is left.

**Growth Monthly with the coupon `ANUAL10` (10% forever).** Every renewal: R$ 116.10 instead of R$ 129.00.

**Student Monthly by PIX.** On the 5th, the R$ 49 PIX arrives, due on the 10th. Paid on the 7th: the period moves forward to the 10th of the following month. Not paid: on the 10th, the subscription becomes past due, and the member uses **Pay now**.

## Renewal emails

| Moment | Subject |
|---|---|
| Card charged | *Renewal charged: …* |
| Card declined | *We could not renew …* |
| Renewal PIX or boleto generated | *Renew …: your PIX is ready* / *your boleto is ready* |
| Needs to pay to keep access | *Renew … to keep your access* |
| Downsell discount ending | *Your … discount ends soon* |

See [Payment emails](/notificacoes/emails-de-pagamento).

## Common errors and how to fix them

| Situation | What to do |
|---|---|
| Many subscribers past due every month | Encourage the card: show in the description that it renews on its own; keep PIX for those who prefer it |
| The member changed the card and the renewal still failed | Check that the new card was set as **default** |
| The card is under review and the member tried to pay again | Wait for the answer: *"A card payment for this subscription is still being reviewed. Wait for the answer before trying again."* |
| The renewal came without the coupon discount | The coupon was **once**, or the **repeating** period ended |

## Frequently asked questions

**Does the platform try the card again after a decline?**
Not automatically. The member pays through **Pay now**, with the same card or another one.

**Can I change the renewal date?**
The date is the purchase date. An add-on added mid-cycle lines up with the plan's date.

**Does the member get a notice before being charged on the card?**
The email arrives when the renewal is charged. With PIX and boleto, 5 days before, because they need to pay.

**What happens to the access of someone who is past due?**
The subscription is no longer up to date; the member sorts it out with **Pay now**, and once paid, access carries on as normal.

## In the API

Subscription reads (`GET /api/subscriptions`, `/api/subscriptions/{id}` and `/api/subscriptions/me`) include `nextBillingDate`, `status` and, when there is an open charge, `pendingRenewal`. See [Subscriptions](/api/referencia/subscriptions).

## Related

- [Pay now](/pagamentos/pagar-agora)
- [Member billing](/pagamentos/faturamento-do-membro)
- [PIX, boleto and card](/pagamentos/metodos-de-pagamento)
