# Creación de intención de cobro

Éste método crea una nueva solicitud de cargo para la suscripción especificada.

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

## Request fields (application/json):

  - `subscription_id` (string, required)
    El ID de la suscripción que se cobrará.
    Example: "13a0f1aa-5e47-4894-aa8b-282dd19593ec"

  - `amount` (number, required)
    Monto que se cobrará. No use separador de miles, y un máximo de 4 decimales. Se asumirá la moneda en que el comercio registró su cuenta en Khipu.
    Example: 10000

  - `subject` (string, required)
    Asunto para identificar el cobro.
    Example: "Cargo por servicio XYZ Id 11.222.333-0"

  - `body` (string, required)
    Descripción del cobro. Puede incluir información adicional sobre el cobro, como el servicio o producto asociado, fecha, etc. Se recomienda que sea lo más descriptivo posible.
    Example: "Servicio XYZ - Noviembre 2022 - Monto: $10.000"

  - `error_response_url` (string, required)
    URL que será llamada si ocurre un error en el proceso de cobro. Se enviará un JSON por POST con la siguiente estructura:
    Example: "https://my-domain.biz/charge-error-api"

  - `custom` (string, required)
    Éste campo puede ser utilizado para enviar información personalizada sobre el cobro. Puede ser en formato texto o un documento codificado en base64.
    Example: "Contenido personalizado del cobro en formato texto o base64."

  - `transaction_id` (string, required)
    El identificador único del comercio para esta operación. Por ejemplo, el número de factura.
    Example: "INVOICE-23ffcfbe1e4a4d1c9dc631fe70bddaa0"

  - `notify_url` (string, required)
    URL que será llamada una vez que el proceso de cobro finalice y el pago sea conciliado. Se enviará un POST con los parámetros que permiten obtener los detalles del pago, utilizando el mismo flujo de un pago normal. Consulte la [documentación](https://www.khipu.com/api/#14-notificacion) para más detalles.
    Example: "https://my-domain.biz/charge-notify-api"

  - `notify_api_version` (string)
    Version of the API used for the notification. This is useful to ensure compatibility with future changes in the API.
    Example: "1.3"

## Response 200 fields (application/json):

  - `payment_id` (string, required)
    Identificador único del cobro. Representa el id de pago automático que se usará para rastrear la solicitud de cobro a la cuenta del cliente.
    Example: "v67prof2ugg3"