# Charge intent creation

This method creates a new charge request for the specified subscription.

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

## Request fields (application/json):

  - `subscription_id` (string, required)
    The subscription id that will be charged.
    Example: "13a0f1aa-5e47-4894-aa8b-282dd19593ec"

  - `amount` (number, required)
    Amount that will be charged. Do not use thousands separator, and a maximum of 4 decimal places. It will assume the currency in which the merchant registered its account in Khipu.
    Example: 10000

  - `subject` (string, required)
    Subject to identify the charge.
    Example: "Charge Service XYZ Id 11.222.333-0"

  - `body` (string, required)
    Charge description.
    Example: "Service XYZ - November 2022 - Amount: $10.000"

  - `error_response_url` (string, required)
    URL that will be called if an error occurs in the charge process. A JSON will be sent by POST with the following structure:
    Example: "https://my-domain.biz/charge-error-api"

  - `custom` (string, required)
    This field can be used to send custom information about the charge intent. It can be in text format or base64-encoded document.
    Example: "Custom information content."

  - `transaction_id` (string, required)
    Merchant's unique identifier for this operation. For example, the invoice number.
    Example: "INVOICE-23ffcfbe1e4a4d1c9dc631fe70bddaa0"

  - `notify_url` (string, required)
    URL that will be called once the charging process finishes and the payment is conciliated. A POST will be sent with parameters that allows fetch the payment details, using the same flow of a normal payment. See the [documentation](https://www.khipu.com/api/#14-notificacion) for details.
    Example: "https://my-domain.biz/charge-notify-api"

  - `notify_api_version` (string)
    API version for instant payment notification(same value as used for the payment API).
    Example: "1.3"

## Response 200 fields (application/json):

  - `payment_id` (string, required)
    Unique charge identifier. Represents the automatic payment id that will be used to trace the request to charge the customer's account.
    Example: "v67prof2ugg3"