---
title: "Resume Subscription"
method: POST
path: "/subscriptions/{id}/resume"
tags: ["Subscriptions"]
---

# Resume Subscription

`POST /subscriptions/{id}/resume`

Resumes a previously paused subscription, reactivating the billing cycle.

**Resume Effects**:

- Billing is immediately reactivated
- The subscription status changes from `PAUSED` to `ACTIVE`
- The next billing date is recalculated based on the current date
- Regular charging schedule resumes according to the subscription interval

**Important Notes**:

- No immediate charge is created when resuming (billing continues on next scheduled date)
- Any pause duration is added to the current billing period, maintaining the expected number of billing cycles
- If a significant time has passed, verify that the payment method is still valid

## Response `200`

A subscription object

- Subscription
  - `id` string, required — Unique identifier for the subscription.
  - `amount` integer, required — Amount intended to be collected by this payment. A positive integer representing how much to charge in the smallest currency unit (e.g., 100 cents to charge 1.00 USD).
  - `currency` string — Three-letter [ISO currency code](https://en.wikipedia.org/wiki/ISO_4217), in uppercase. Must be a supported currency.
  - `allowedPaymentMethods` string[] — List of payment methods allowed for subscriptions.
  - `description` string — An arbitrary string attached to the subscription. Often useful for displaying to users.
  - `accountId` string, required — MONEI Account identifier.
  - `livemode` boolean, required — Has the value `true` if the resource exists in live mode or the value `false` if the resource exists in test mode.
  - `status` 'PENDING' | 'EXPIRED' | 'TRIALING' | 'ACTIVE' | 'PAST_DUE' | 'PAUSED' | 'CANCELED', required — The status of the subscription.
  - `customer` PaymentCustomer
    - `email` string — The customer's email address.
    - `name` string — The customer's full name or business name.
    - `phone` string — The customer's phone number in E.164 format.
  - `billingDetails` PaymentBillingDetails — Billing information associated with the payment method at the time of the transaction.
    - `name` string — The customer's billing full name.
    - `email` string — The customer's billing email address.
    - `phone` string — The customer's billing phone number in E.164 format.
    - `company` string — Billing company name.
    - `taxId` string — Company tax ID.
    - `address` Address
      - `country` string — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `city` string — City, district, suburb, town, or village.
      - `line1` string — Address line 1 (e.g., street, PO Box, or company name).
      - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
      - `zip` string — ZIP or postal code.
      - `state` string — State, county, province, or region.
  - `shippingDetails` PaymentShippingDetails — Shipping information associated with the payment.
    - `name` string — The shipping customer's full name.
    - `email` string — The shipping customer's email address.
    - `phone` string — The shipping customer's phone number in E.164 format.
    - `company` string — Name of the company where the shipment is going.
    - `taxId` string — Company tax ID.
    - `address` Address
      - `country` string — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `city` string — City, district, suburb, town, or village.
      - `line1` string — Address line 1 (e.g., street, PO Box, or company name).
      - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
      - `zip` string — ZIP or postal code.
      - `state` string — State, county, province, or region.
  - `interval` 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year', required — Subscription interval. The `minute` and `hour` intervals are only available in test mode.
  - `intervalCount` integer, required — Number of intervals between subscription payments.
  - `pauseIntervalCount` integer — Number of intervals when subscription will be paused before it activates again.
  - `skipIntervalCount` integer — The number of intervals during which the subscription billing cycle will be skipped without altering the subscription status. This is useful when payment for a specific period is received through different methods.
  - `lastOrderId` string — An order ID from your system. A unique identifier that can be used to reconcile the payment with your internal system.
  - `lastPayment` SubscriptionLastPayment
    - `id` string — Unique identifier for the payment.
    - `status` 'SUCCEEDED' | 'PENDING' | 'FAILED' | 'CANCELED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'AUTHORIZED' | 'EXPIRED' | 'PENDING_PROCESSING' | 'PAID_OUT' — The status of the payment.
    - `statusCode` string — Payment status code.
    - `statusMessage` string — Human readable status message, can be displayed to a user.
  - `paymentMethod` SubscriptionPaymentMethod — Details about the payment method at the time of the transaction.
    - `method` 'card' | 'bizum' — Subscription method type.
    - `card` PaymentPaymentMethodCard — Details about the card used as payment method at the time of the transaction.
      - `country` string — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
      - `brand` 'visa' | 'mastercard' | 'diners' | 'amex' | 'jcb' | 'unionpay' | 'discover' | 'unknown' — Card brand.
      - `type` 'debit' | 'credit' — Card type `debit` or `credit`.
      - `threeDSecure` boolean — Whether this transaction used 3D Secure authentication.
      - `threeDSecureVersion` string — The protocol version of the 3DS challenge.
      - `threeDSecureFlow` 'CHALLENGE' | 'FRICTIONLESS' | 'FRICTIONLESS_CHALLENGE' | 'DIRECT' — The flow used for 3DS authentication.
      - `expiration` integer — Time at which the card will expire. Measured in seconds since the Unix epoch.
      - `last4` string — The last four digits of the card.
      - `fingerprint` string — Unique identifier for the card number. Used to detect duplicate payment methods across customers. Not present for tokenized cards.
      - `tokenizationMethod` 'applePay' | 'googlePay' | 'clickToPay' — The digital wallet used to tokenize the card.
      - `cardholderName` string — The name of the cardholder.
      - `cardholderEmail` string — The email of the cardholder.
    - `bizum` PaymentPaymentMethodBizum — Details about the Bizum account used as payment method at the time of the transaction.
      - `phoneNumber` string — Phone number in E.164 format used to pay with `bizum`.
  - `currentPeriodStart` number — The start date of the current subscription period. Measured in seconds since the Unix epoch.
  - `currentPeriodEnd` number — The end date of the current subscription period. Measured in seconds since the Unix epoch.
  - `trialPeriodEnd` number — The end date of the trial period. Measured in seconds since the Unix epoch.
  - `trialAmount` integer — Amount charged on each billing cycle during the trial period, as a positive integer in the smallest currency unit (e.g., 100 cents to charge 1.00 USD). Once the trial ends, the subscription's regular `amount` is charged. Use this to offer discounted introductory pricing. Can be combined with `trialIntervalCount` (charged each cycle for that many cycles) or with `trialPeriodDays`/`trialPeriodEnd` (charged once at activation, covering the subscription until the trial period ends).
  - `trialIntervalCount` integer — Number of billing cycles charged at `trialAmount` before the regular `amount` applies, using the subscription's `interval` (e.g., `interval` of `month` with a `trialIntervalCount` of 3 charges the `trialAmount` for the first 3 months). Requires `trialAmount` and cannot be combined with `trialPeriodDays` or `trialPeriodEnd`. In responses, the value decrements after each trial payment and is removed once the trial ends.
  - `nextPaymentAt` integer — The date when the next payment will be made.
  - `retryCount` integer — Number of retries left for the subscription.
  - `retrySchedule` object[] — Defines a custom schedule for retrying failed subscription payments. Each entry in the array specifies how long to wait before attempting the next payment retry. If not specified, the system's default retry schedule will be used.
    - `interval` 'day' | 'week' | 'month' | 'year', required — The unit of time to wait before the retry attempt.
    - `intervalCount` integer, required — The number of intervals to wait before the retry attempt.
  - `cancelAtPeriodEnd` boolean — If true, the subscription will be canceled at the end of the current period.
  - `pauseAtPeriodEnd` boolean — If true, the subscription will be paused at the end of the current period.
  - `traceDetails` PaymentTraceDetails — Information related to the browsing session of the user who initiated the payment.
    - `ip` string — The IP address where the operation originated.
    - `countryCode` string — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
    - `lang` string — Two-letter language code ([ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1)).
    - `deviceType` string — Device type, could be `desktop`, `mobile`, `smartTV`, `tablet`.
    - `deviceModel` string — Information about the device used for the browser session (e.g., `iPhone`).
    - `browser` string — The browser used in this browser session (e.g., `Mobile Safari`).
    - `browserVersion` string — The version for the browser session (e.g., `13.1.1`).
    - `os` string — Operation system (e.g., `iOS`).
    - `osVersion` string — Operation system version (e.g., `13.5.1`).
    - `source` string — The source component from where the operation was generated (mostly for our SDK's).
    - `sourceVersion` string — The source component version from where the operation was generated (mostly for our SDK's).
    - `userAgent` string — Full user agent string of the browser session.
    - `browserAccept` string — Browser accept header.
    - `browserColorDepth` string — The color depth of the browser session (e.g., `24`).
    - `browserScreenHeight` string — The screen height of the browser session (e.g., `1152`).
    - `browserScreenWidth` string — The screen width of the browser session (e.g., `2048`).
    - `browserTimezoneOffset` string — The timezone offset of the browser session (e.g., `-120`).
    - `userId` string — The ID of the user that started the operation.
    - `userEmail` string — The email of the user that started the operation.
  - `sequenceId` string — A permanent identifier that refers to the initial payment of a sequence of payments. This value needs to be sent in the path for `RECURRING` payments.
  - `callbackUrl` string — The URL will be called each time subscription status changes. You will receive a subscription object in the body of the request.
  - `paymentCallbackUrl` string — The URL will be called each time subscription creates a new payments. You will receive the payment object in the body of the request.
  - `metadata` Metadata — A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.
  - `createdAt` integer — Time at which the resource was created. Measured in seconds since the Unix epoch.
  - `updatedAt` integer — Time at which the resource updated last time. Measured in seconds since the Unix epoch.

## Other responses

- `400` — The request is incorrect or could not be processed
- `401` — Unauthorized error. Please check your auth credentials
- `404` — The specified resource was not found
- `422` — The request was well-formed but could not be processed due to semantic errors
- `500` — Unexpected server error
- `503` — The service is temporarily unavailable

---

[API](https://skmtc.net/monei/apis/monei-api-v1.md) · [All operations](https://skmtc.net/monei/apis/monei-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monei/monei-api-v1/versions/23554d4fb9e5/schema)