---
title: "Crear plan"
method: POST
path: "/subscriptions/plan"
tags: ["Subscripciones", "Subscriptions"]
---

# Crear plan

`POST /subscriptions/plan`

Un plan determina el precio y la frecuencia con la que se cobrará la suscripción a un producto, entre otras características. Un plan se asocia a un sólo producto.

## Parameters

- `#/paths/~1/get/parameters/0` — unresolved $ref

## Request body

- object
  - `signature` Signature, required — unresolved $ref
  - `name` Name, required — unresolved $ref
  - `external_id` ExternalId, required — unresolved $ref
  - `product` ExternalId, required — unresolved $ref
  - `amount` Amount, required — unresolved $ref
  - `interval` Interval, required — unresolved $ref
  - `interval_type` string, required — Determina cada cuánto tiempo debe cobrarse la subscripción. Los valores permitidos son "DAILY", "WEEKLY", "MONTHLY", "ANNUAL"
  - `trial_available` TrialAvailable — unresolved $ref
  - `interval_offset` IntervalOffset — unresolved $ref
  - `interval_offset_type` string — Determina cuánto dura el periodo de prueba. Los valores permitidos son "DAILY", "WEEKLY", "MONTHLY", "ANNUAL"

## Response `200`

OK

- object
  - `message` string, required — Nombre del código HTTP de respuesta.
  - `code` number, required — Código de respuesta.
  - `current_time` string, required — Fecha y hora de la petición.
  - `plan` Plan — El plan establece muchas variables que pueden utilizarse para personalizar el intervalo, importe y tiempo de prueba de una subscripción.
    - `amount` number, required — Cantidad a cobrar, en la moneda fraccionaria elegida. Una cantidad de 100 utilizando la moneda Euro es igual a 1€.
    - `created_at` Created, required — unresolved $ref
    - `external_id` string, required — ID externo otorgado por el comercio para identificar de forma única a un plan.
    - `interval` number, required — Intervalo en la unidad indicada en el campo `interval_type` que determina cada cuánto tiempo debe cobrarse la subscripción.
    - `interval_offset` number — Intervalo en la unidad indicada en el campo `interval_offset_type` que determina la unidad de tiempo que dura el periodo de prueba de la subscripción.
    - `interval_offset_type` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Unidad de tiempo que determina la unidad de tiempo que dura el periodo de prueba de la subscripción. Requerido si se indica el campo `interval_offset`.
    - `interval_type` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY', required — Unidad de tiempo que determina la unidad de tiempo que dura el periodo de prueba de la subscripción. Requerido si se indica el campo `interval_offset`.
    - `name` string, required — Nombre del plan.
    - `product` Product, required — El producto de la subscripción. A esta entidad se asocian planes.
      - `created_at` Created, required — unresolved $ref
      - `external_id` string, required — ID externo otorgado por el comercio para identificar de forma única a un producto.
      - `name` string, required — Nombre del producto.
      - `notification_url` string — URL que recibirá una notificación HTTP cuando el pago cambie de estado.
      - `sandbox` boolean, required — Indica sí el producto pertenece al entorno de sandbox.
      - `updated_at` UpdatedAt, required — unresolved $ref
    - `trial_available` boolean — Por defecto, false. Indica si hay periodo de prueba. Hasta que éste no termine no se realizará el primer cobro.
    - `updated_at` string, required — Fecha de última actualización de la entidad.

---

[API](https://skmtc.net/paylands/apis/documentacio-n-de-paylands.md) · [All operations](https://skmtc.net/paylands/apis/documentacio-n-de-paylands/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylands/documentacio-n-de-paylands/revisions/6bf9c0ba354b/schema)