> ## Documentation Index
> Fetch the complete documentation index at: https://kb.paymentsmojo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recurring billing

> Charge a customer's card on a schedule, with their authorization: weekly, monthly, quarterly or yearly.

**Recurring billing** charges a customer's card on a schedule you set: a monthly service, a weekly delivery, a yearly
membership. The customer authorizes the plan on a page of its own, their card is saved for that plan only, and each
payment is charged on its date with a receipt emailed to them.

Mojo Payments turns recurring billing on for your account. To start, write to [hello@paymentsmojo.com](mailto:hello@paymentsmojo.com). Once it's on,
you'll find it under the **Recurring** tab (people who can take payments).

![The Recurring tab: a list of plans with customer, amount and schedule, next payment and status.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/recurring-list.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=2d0643e73c1390c36f6df0ebe6c10a4a)

Recurring: your plans (portal as of October 2026)

## Create a plan

**1. Start a plan**

On the **Recurring** tab, click **New recurring plan**.

**2. Say what it's for**

A description the customer sees (for example "Office coffee service"), the MID it's paid to, and optionally your
own reference and a PO number.

**3. Set the amount and schedule**

The amount of each payment; how often (**every week**, **every 2 weeks**, **every month**, **every 3 months** or
**every year**); the first payment's date; and when it ends: **When cancelled**, or **After a number of payments**.

**4. Who it's for**

The customer's email (required), and their company or name. A phone number lets you send the link by text.

**5. Lines (optional)**

What each payment covers, line by line. Lines must add up to the amount. Business customers' cards cost less to
accept when a payment carries its lines and PO number.

**6. Send**

The customer gets a link to set up their payments. Nothing is charged until they authorize it.

![The new recurring plan form: description, MID, amount, how often, first payment, number of payments, customer and lines.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/recurring-new.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=81a4908f72ca9dbd38b7d4b6e752e57b)

Recurring → New recurring plan (portal as of October 2026)

## What your customer sees

The link opens a page in your business's look (your name, logo and colors from **Settings → Payment page**). It shows
the plan's terms. The customer enters their card, ticks the authorization (it states the amount, how often and from
when), and confirms.

* **First payment today:** it's charged right away, and the card is saved for the rest.
* **First payment later:** the card is checked (nothing charged), and the first payment is taken on its date.

![The customer's page: the plan's amount and schedule, a card box, and the authorization checkbox.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/subscribe-setup.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=1cd2a1a6e79842ef58fcbbcbcd44ae10)

The customer's setup page (as of October 2026)

The same link stays the customer's page for the plan. There they see their next payment and the card in use, and can
**change their card** or **cancel**. Both need a one-time code emailed to them first, so someone who only has the link
can't change anything.

![The customer's plan page: next payment, the card in use, and buttons to change the card or cancel.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/subscribe-manage.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=6adc650187746e94154286bb432e29ad)

The customer's plan page (as of October 2026)

The card is saved for this plan only, at the card processor: neither you nor Mojo Payments sees its number. It isn't
offered for your invoices, and it's removed when the plan ends.

## Each payment

* Each payment is charged on its date, and the customer gets a receipt by email.
* **Declined:** the customer is emailed, with a link to change their card, and the payment is tried again on the days
  you choose (below). If the last try is declined too, the plan stops (**Stopped (failed payments)**) and your cancellation address hears.
* **When the card's issuer gives advice**, it's followed, so you aren't charged by the card brands for retries that
  can't succeed:
  * **Never try this card again** (for example, the account is closed, or the cardholder stopped recurring payments):
    no more retries. The plan stops now, as if every try had been declined.
  * **Don't send this payment again:** the plan is paused with the reason. Resume it to carry on from the next payment.
  * **Try again after a few days:** the next try waits at least that long, still before the next payment is due.
* **No answer from the processor:** the plan is paused so a payment can't be taken twice. Check the payment, then
  resume the plan (or cancel it).

## Your plans

Open a plan from the list to see its terms, the customer, the card (last four digits and expiry), and every payment
with its result. From there you can:

| Action | What it does |
| - | - |
| **Copy link**, **Send the setup link again** | The customer's setup link, while they haven't authorized yet. |
| **Pause** | Stops charging until you resume. Payments due while paused are skipped, not caught up later. |
| **Resume** | Starts again from the next payment date on or after today. |
| **Cancel plan** | Ends the plan for good. Payments already made stay made. The customer is told. |

![A recurring plan's page: status, schedule, setup link, customer and card details, and its payments.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/recurring-plan.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=a93c1a0f471b7dbda9d4726ae249d1a7)

Recurring → a plan (portal as of October 2026)

| Status | Means |
| - | - |
| **Waiting for the customer** | The link is sent; the customer hasn't authorized yet. |
| **Active** | Payments are being charged on schedule (**retrying** after a decline). |
| **Paused** | Paused by you, or by Mojo Payments when a payment's outcome was unknown or the card's issuer asked not to resend it. |
| **Completed** | All its payments were made. |
| **Cancelled** | Cancelled by you or the customer. |
| **Stopped (failed payments)** | A payment was declined on every try. |

## Settings

Under **Settings → Payment page** (Owners and Admins), in **Recurring billing**:

* **Declined payments:** the days after a declined payment to try again (1, 3 and 5 days by default), before the next
  payment is due.
* **Cancellation notices:** an email address told whenever a customer cancels or a plan fails. It's used once
  someone clicks the confirmation link sent to it.
* **Recurring emails:** the wording of the setup, receipt, declined and cancelled emails, with a preview and **Send a test**.

![The recurring billing settings: retry days for declined payments, the cancellation-notification address and the recurring emails.](https://mintcdn.com/mojo-payments/OfnEEu0_N2aQ-DDY/images/portal/recurring-settings.png?fit=max\&auto=format\&n=OfnEEu0_N2aQ-DDY\&q=85\&s=bc7a0fe0c43bbb93a1336c48ee823e23)

Settings → Payment page → Recurring billing (portal as of October 2026)

Your systems can create and follow plans through the API: see [Recurring plans](https://kb.paymentsmojo.com/developers/recurring-plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.