# Subscription creation

This method creates a new subscription.

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

## Request fields (application/json):

  - `name` (string, required)
    Name to identify the subscription.
    Example: "Service XYZ Id 11.222.333-0"

  - `email` (string, required)
    The customer e-mail.
    Example: "personal.email@gmail.com"

  - `max_amount` (number, required)
    max amount for every charge intent.
    Example: 1000

  - `currency` (string, required)
    the currency code in the ISO 4217.
    Example: "CLP"

  - `notify_url` (string, required)
    URL that will be called when the customer complete the signing process with the bank. A JSON message will be sent via POST with the information of the subscription with the following structure ( can be __"enabled"__ or __"disabled"__):
    Example: "https://my-domain.biz/subscription-notify-api"

  - `return_url` (string, required)
    URL to redirect the customer when the signing process has been completed.
    Example: "https://my-domain.biz/subscription-result"

  - `cancel_url` (string, required)
    URL to redirect the customer if the signing process could not be completed.
    Example: "https://my-domain.biz/subscription-cancel"

  - `service_reference` (string)
    Value to associate with the subscription. It can be useful when you don't want your client to be identified with a random unique string in the bank's mandate subscription form.
    Example: "12345678K"

  - `image_url` (string)
    URL of the image associated with the subscription.
    Example: "https://my-domain.biz/subscription-image.png"

  - `description` (string)
    Detailed description of the PAC (Automatic Payment) subscription carried out at banks for products.
    Example: "PAC subscription for automatic payment of products at your bank."

## Response 200 fields (application/json):

  - `subscription_id` (string, required)
    Unique subscription identifier, to be associated with the service acquired by the customer. Subsequently, this value can be used to check the status of the subscription.
    Example: "13a0f1aa-5e47-4894-aa8b-282dd19593ec"

  - `redirect_url` (string, required)
    The url where the merchant must redirect the user so that they can sign the subscription with their personal bank. It uses the subscription id as a url parameter.
    Example: "https://khipu.com/pac-manager/13a0f1aa-5e47-4894-aa8b-282dd19593ec"