# Subscriptions

Create recurring payments that result in charges being automatically created for a customer. The frequency and amount of these automatic charges are defined by a plan. Subscriptions are always billed to the customer's current default card.

 - [POST /subscriptions](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/createsubscription.md): Creates a new subscription object. The subscription is billed to the customer's current default card.
 - [GET /subscriptions](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/listsubscriptions.md): Lists subscription objects. Results are sorted by creation date, with the most recent objects first.
 - [GET /subscriptions/{subscriptionId}](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/getsubscription.md): Retrieves an existing subscription object.
 - [POST /subscriptions/{subscriptionId}](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/updatesubscription.md): Updates an existing subscription object. Any parameters not provided are left unchanged.
 - [DELETE /subscriptions/{subscriptionId}](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/cancelsubscription.md): Cancels an existing subscription.
 - [GET /subscriptions/{subscriptionId}/charges](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/subscriptions/listsubscriptioncharges.md): Lists the charge attempts made by a subscription, including automatic renewals (rebills) and failed attempts. Results are sorted with the most recent records first. Note that unlike other list endpoin