---
title: "Actualizar una suscripción"
method: PATCH
path: "/api/v1/merchants/subscriptions/{subscription_id}"
tags: ["Suscripciones"]
---

# Actualizar una suscripción

`PATCH /api/v1/merchants/subscriptions/{subscription_id}`

Este endpoint permite actualizar los detalles de una suscripción existente. Es útil para realizar cambios como actualizar el método de pago entre otros.

## Path parameters

- `subscription_id` string, required

## Headers

- `X-API-key` string, required

## Request body

- object
  - `billing_address` object — Dirección de facturación.
    - `address1` string
    - `city` string
    - `country_code` string
    - `email` string
    - `first_name` string
    - `last_name` string
    - `phone` string
    - `state_code` string
    - `zipcode` string
  - `metadata` object — Metadatos adicionales para la suscripción.
    - `site_domain` string
  - `payer_info` object, required — Información del cliente.
    - `email` string, required
    - `last_name` string
    - `name` string, required
    - `phone` string
  - `payment_source` object, required — Información del método de pago.
    - `card_info` object, required — Información de la tarjeta.
      - `card_cvv` string
      - `card_holder` string
      - `card_id` string
      - `card_number` string
      - `expiry_month` string
      - `expiry_year` string
    - `method_type` string
  - `plan_code` string, required — Código único del plan asociado a la suscripción.
  - `shipping_address` object — Dirección de envío.
    - `address1` string
    - `city` string
    - `country_code` string
    - `email` string
    - `first_name` string
    - `last_name` string
    - `phone` string
    - `state_code` string
    - `zipcode` string
  - `webhooks_urls` object, required — URLs para recibir notificaciones relacionadas con la suscripción.
    - `notify_order` string
    - `notify_update_subscription` string

## Response `200`

Respuesta exitosa.

- object
  - `activated_at` string, date-time — Fecha de activación.
  - `auto_renew` boolean — Indica si la suscripción se renueva automáticamente.
  - `canceled_at` string, date-time — Fecha de cancelación.
  - `created_at` string, date-time — Fecha y hora de creación.
  - `currency` string — Moneda de la suscripción.
  - `current_period_ends_at` string, date-time — Fin del periodo actual.
  - `current_period_started_at` string, date-time — Inicio del periodo actual.
  - `expires_at` string, date-time — Fecha de expiración.
  - `payer_info` object — Información del usuario asociado.
    - `email` string — Correo electrónico del usuario.
    - `user_id` string — ID único del usuario.
  - `plan_code` string — Código del plan asociado.
  - `remaining_billing_cycles` integer — Ciclos de facturación restantes.
  - `status` string — Estado inicial de la suscripción.
  - `subscription_id` string, uuid — ID único de la suscripción creada.
  - `total_billing_cycles` integer — Número total de ciclos de facturación.
  - `updated_at` string, date-time — Fecha de última actualización.

## Other responses

- `400` — Respuesta de un bad request
- `401` — Respuesta de una solicitud **sin autorización** este problema es debido a el **X-API-KEY** inválido o por el **Bearer-Auth
- `404` — Recurso no encontrado.
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)