---
title: "Crear un Plan"
method: POST
path: "/api/v1/merchants/plans"
tags: ["Planes"]
---

# Crear un Plan

`POST /api/v1/merchants/plans`

Este endpoint permite a los comercios crear un nuevo plan de suscripción. Un plan define las condiciones bajo las cuales los usuarios pueden suscribirse, incluyendo detalles como periodicidad, precios y beneficios. Este endpoint es esencial para configurar productos o servicios recurrentes que los comercios ofrezcan a sus clientes.

## Headers

- `X-API-key` string, required

## Request body

- object
  - `amount` number, required — Precio del plan por ciclo de facturación. Debe expresarse en céntimos, por ejemplo si el importe es de 19,99 dólares se representará como 1999 que significa 19 dólares céntimos.
  - `auto_renew` boolean, required — Indica si el plan se renueva automáticamente.
  - `currency` string, required — Moneda en la que se cobrará el plan. Debe expresarse en céntimos, por ejemplo si el importe es de 10,00 dólares se representará como 1000 que significa 10 dólares 0 céntimos.
  - `description` string — Descripción del plan.
  - `interval_length` integer, required — Longitud del intervalo de facturación.
  - `interval_unit` string, required — Unidad de tiempo para el intervalo de facturación.
  - `name` string, required — Nombre del plan.
  - `plan_code` string, required — Código único del plan.
  - `price_model` string, required — Modelo de precios del plan.
  - `setup_fee` number, required — Cargo inicial para el plan.
  - `tags` string[] — Etiquetas asociadas al plan.
  - `total_billing_cycles` integer, required — Número total de ciclos de facturación.

## Response `201`

Respuesta exitosa.

- object
  - `amount` number — Precio del plan por ciclo de facturación. Debe expresarse en céntimos, por ejemplo si el importe es de 19,99 dólares se representará como 1999 que significa 19 dólares céntimos.
  - `auto_renew` boolean — Indica si el plan se renueva automáticamente.
  - `currency` string — Moneda en la que se cobrará el plan. Debe expresarse en céntimos, por ejemplo si el importe es de 10,00 dólares se representará como 1000 que significa 10 dólares 0 céntimos.
  - `description` string — Descripción del plan.
  - `interval_length` integer — Longitud del intervalo de facturación.
  - `interval_unit` string — Unidad de tiempo para el intervalo de facturación.
  - `merchant_id` string — ID único del comercio.
  - `name` string — Nombre del plan.
  - `plan_code` string — Código único del plan.
  - `price_model` string — Modelo de precios del plan.
  - `setup_fee` number — Cargo inicial para el plan.
  - `tags` string[] — Etiquetas asociadas al plan.
  - `total_billing_cycles` integer — Número total de ciclos de facturació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

---

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