# Creación de suscripción

Éste método permite crear una suscripción nueva para un cliente, que puede ser utilizada para pagos recurrentes automáticos.

Endpoint: POST /v1/automatic-payment/subscription
Version: v1.0
Security: Api-Key

## Request fields (application/json):

  - `name` (string, required)
    Nombre para identificar la suscripción.
    Example: "Service XYZ Id 11.222.333-0"

  - `email` (string, required)
    El correo electrónico del cliente que se suscribe al servicio.
    Example: "personal.email@gmail.com"

  - `max_amount` (number, required)
    Monto máximo que se puede cobrar mensualmente al cliente.
    Example: 1000

  - `currency` (string, required)
    El código de moneda en el estándar ISO 4217.
    Example: "CLP"

  - `notify_url` (string, required)
    La URL que se llamará cuando el cliente complete el proceso de firma con el banco. Se enviará un mensaje JSON a través de POST con la información de la suscripción con la siguiente estructura ( puede ser __"enabled"__ o __"disabled"__):
    Example: "https://my-domain.biz/subscription-notify-api"

  - `return_url` (string, required)
    URL a la que redirigir al cliente cuando el proceso de firma se haya completado.
    Example: "https://my-domain.biz/subscription-result"

  - `cancel_url` (string, required)
    URL a la que redirigir al cliente si el proceso de firma no se pudo completar.
    Example: "https://my-domain.biz/subscription-cancel"

  - `service_reference` (string)
    Valor a asociar con la suscripción. Puede ser útil cuando no quieres que tu cliente sea identificado con un string único aleatorio en el formulario de suscripción de mandato del banco.
    Example: "12345678K"

  - `image_url` (string)
    URL de la imagen asociada a la suscripción.
    Example: "https://my-domain.biz/subscription-image.png"

  - `description` (string)
    Descripción detallada de la suscripción PAC (Pago Automático) realizada en bancos para productos.
    Example: "Suscripción PAC para el servicio XYZ."

## Response 200 fields (application/json):

  - `subscription_id` (string, required)
    Identificador único de la suscripción, que se asociará al servicio adquirido por el cliente. Posteriormente, este valor puede ser usado para consultar el estado de la suscripción.
    Example: "13a0f1aa-5e47-4894-aa8b-282dd19593ec"

  - `redirect_url` (string, required)
    La URL donde el comercio debe redirigir al usuario para que firme la suscripción con su banco personal. Utiliza el id de la suscripción como parámetro de la URL.
    Example: "https://khipu.com/pac-manager/13a0f1aa-5e47-4894-aa8b-282dd19593ec"