# Subscriptions

Subscriptions are the easiest way to setup and schedule recurring payments. You provide us the amounts and intervals and PayPro will manage the full life-cycle of the subscription.

Each interval a [Subscription period](/reference/api/subscription-periods) and [Payment](/reference/api/payments) will be created which will charge the customer.

These subscriptions can be managed through the API or in our dashboard and also includes optional invoicing, debtor management and other features.

Refer to our [Subscriptions guide](/docs/subscriptions) how to setup and manage your subscriptions.

It is also possible to create the [Subscription period](/reference/api/subscription-periods) yourself which we call an "on-demand" subscription check our [On-demand subscriptions guide](/docs/on-demand-subscriptions) how to do this.


## Retrieves a subscription

 - [GET /subscriptions/{id}](https://docs.paypro.nl/reference/api/subscriptions/retrievesubscription.md): Retrieves a single subscription based on the id.

## Updates a subscription

 - [PATCH /subscriptions/{id}](https://docs.paypro.nl/reference/api/subscriptions/updatesubscription.md): Updates a Subscription object. Returns the updated Subscription

## Cancels a subscription

 - [DELETE /subscriptions/{id}](https://docs.paypro.nl/reference/api/subscriptions/cancelsubscription.md): Cancels a subscription. A canceled subscription will no longer create new subscription periods.

It is not possible to resume a canceled subscription.

## Retrieves a list of subscriptions

 - [GET /subscriptions](https://docs.paypro.nl/reference/api/subscriptions/retrievelistofsubscriptions.md): Retrieve a list of subscriptions that have been created for your account. The subscriptions are sorted, with the most recent first.

## Creates a subscription

 - [POST /subscriptions](https://docs.paypro.nl/reference/api/subscriptions/createsubscription.md): Creates a Subscription object.

After you created the subscription it will either be started immediately or at the start_date when a mandate was given. When pay_methods are given you need to redirect the customer to the checkout link in the  section.

## Pauses a subscription

 - [POST /subscriptions/{id}/pause](https://docs.paypro.nl/reference/api/subscriptions/pausesubscription.md): Pauses a subscription. A paused subscription will no longer create new subscription periods.

You can resume the subscription by calling the /subscriptions/:id/resume endpoint.

## Resumes a paused subscription

 - [POST /subscriptions/{id}/resume](https://docs.paypro.nl/reference/api/subscriptions/resumesubscription.md): Resumes a paused subscription. The paused subscription will return to the active state and will resume creating new subscription periods.

It is not possible to resume a canceled subscription.

## Retrieves a list subscription periods that belong to this subscription

 - [GET /subscriptions/{id}/subscription_periods](https://docs.paypro.nl/reference/api/subscriptions/retrievelistofsubscriptionperiodsbysubscription.md): Retrieves a list of subscription periods that belong to this subscription.

## Create a next period for this subscription

 - [POST /subscriptions/{id}/subscription_periods](https://docs.paypro.nl/reference/api/subscriptions/createsubscriptionperiod.md): Create a next period for this subscription