# Crear Suscripción

Crea una suscripción en el entorno.

Endpoint: POST /subscription/
Version: 1.0
Security: AppKeys

## Request fields (application/json):

  - `order_id` (string)
    Identificador externo

  - `currency` (string, required)
    Moneda en formato ISO

  - `note` (string)
    Nota

  - `extra` (object)
    Valores extra en formato JSON

  - `return_url` (string)
    URL de retorno. Se envía al cliente a esta url después de realizar el pago correctamente

  - `cancel_url` (string)
    URL de cancelación. Se envía al cliente a esta url si cancela el pago

  - `notify_url` (string)
    URL de notificación. Se envían a esta url las notificaciones de cambio de estado

  - `gateway_selected` (boolean)
    Si cuando el cliente abra la pantalla de pago la primera opción debe estar seleccionada

  - `language` (string)
    Idioma de la pantalla de pago
    Enum: "au", "es", "en", "fr"

  - `expired_date` (string)
    Fecha de expiración (por defecto, es una semana después de la creación)

  - `plan_id` (string)
    Identificador del plan al que se suscribe al usuario existente en el API (requerido si no se envía el parámetro plan)

  - `plan` (object)
    Representa el modelo de datos para crear un plan.

  - `plan.plan_id` (string)
    Identificador externo

  - `plan.name` (string, required)
    Nombre

  - `plan.price` (number, required)
    Precio

  - `plan.description` (string)
    Descripción

  - `plan.duration` (integer, required)
    Duración

  - `plan.unit` (string, required)
    Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)
    Enum: "D", "M", "Y"

  - `plan.recurring` (boolean)
    Si es un plan recurrente o no (por defecto: True)

  - `trial_price1` (number)
    Precio a pagar en un primer periodo de prueba (si se envía se deben enviar también los parámetros duration1 y unit1)

  - `duration1` (integer)
    Duración de primer periodo de prueba

  - `unit1` (string)
    Unidad de tiempo del primer periodo de prueba (opciones: D - Día, M - Mes, Y - Año)
    Enum: "D", "M", "Y"

  - `source` (array,null)
    Origen de los fondos

  - `source.amount` (number, required)
    Cantidad

  - `source.wallet_id` (string)
    Identificador de Cuenta de Pago

  - `source.authorization_id` (string)
    Identificador de Autorización

  - `destination` (array,null)
    Destino de los fondos

## Response 201 fields (application/json):

  - `id` (string)
    Identificador único

  - `token` (string)
    Token de transacción. Se utiliza para representar la transacción de cara al usuario

  - `status` (string)
    Estado de la transacción (N - Pendiente, C - Cancelada, D - Completada, E - Expirada)
    Enum: "N", "C", "D", "E"

  - `items_price` (number)
    Precio total de todos los productos

  - `total_price` (number)
    Precio a pagar

  - `order_id` (string)
    Identificador externo

  - `currency` (string, required)
    Moneda en formato ISO

  - `note` (string)
    Nota

  - `extra` (object)
    Valores extra en formato JSON

  - `return_url` (string)
    URL de retorno. Se envía al cliente a esta url después de realizar el pago correctamente

  - `cancel_url` (string)
    URL de cancelación. Se envía al cliente a esta url si cancela el pago

  - `notify_url` (string)
    URL de notificación. Se envían a esta url las notificaciones de cambio de estado

  - `gateway_selected` (boolean)
    Si cuando el cliente abra la pantalla de pago la primera opción debe estar seleccionada

  - `language` (string)
    Idioma de la pantalla de pago
    Enum: "au", "es", "en", "fr"

  - `expired_date` (string)
    Fecha de expiración (por defecto, es una semana después de la creación)

  - `plan_id` (string)
    Identificador del plan al que se suscribe al usuario existente en el API (requerido si no se envía el parámetro plan)

  - `plan` (object)
    Representa el modelo de datos para crear un plan.

  - `plan.plan_id` (string)
    Identificador externo

  - `plan.name` (string, required)
    Nombre

  - `plan.price` (number, required)
    Precio

  - `plan.description` (string)
    Descripción

  - `plan.duration` (integer, required)
    Duración

  - `plan.unit` (string, required)
    Unidad de tiempo de la duración (opciones: D - Día, M - Mes, Y - Año)
    Enum: "D", "M", "Y"

  - `plan.recurring` (boolean)
    Si es un plan recurrente o no (por defecto: True)

  - `trial_price1` (number)
    Precio a pagar en un primer periodo de prueba (si se envía se deben enviar también los parámetros duration1 y unit1)

  - `duration1` (integer)
    Duración de primer periodo de prueba

  - `unit1` (string)
    Unidad de tiempo del primer periodo de prueba (opciones: D - Día, M - Mes, Y - Año)
    Enum: "D", "M", "Y"

  - `source` (array,null)
    Origen de los fondos

  - `source.amount` (number, required)
    Cantidad

  - `source.wallet_id` (string)
    Identificador de Cuenta de Pago

  - `source.authorization_id` (string)
    Identificador de Autorización

  - `destination` (array,null)
    Destino de los fondos