> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar cotización de plan de pagos

Este endpoint genera un presupuesto para un plan de pagos a plazos.

> \**Nota*
>
> Los planes de pago a plazos solo están disponibles para pagos con tarjeta de crédito.

**Consideraciones monetarias:**

La moneda utilizada para el plan de pagos a plazos puede ser:

* **Moneda local:** La moneda del país seleccionado. En este caso, se le cobrará al cliente en su moneda local.
* **Moneda de la cuenta:** La moneda de tu cuenta de Localpayment. Si esta difiere de la moneda local, Localpayment realizará una conversión de divisas para obtener el importe equivalente en moneda local. Esta conversión se reflejará en tu extracto de cuenta.

> **Nota**
>
> Para los países con varias monedas oficiales, el parámetro `paymentMethod.code` se utiliza para especificar la moneda de la transacción. Esto garantiza que el pago se procese en la moneda correcta para el método de pago elegido.

> **Caducidad del token**
>
> El token proporcionado en la respuesta es válido durante **10 minutos** desde el momento en que se genera. Transcurrido este período, el token caducará y ya no podrá utilizarse para procesar planes de pago a plazos.

## Consideraciones monetarias:

La moneda utilizada para el plan de pagos a plazos puede ser:

* **Moneda local**: La moneda del país seleccionado. En este caso, al cliente se le cobrará en su moneda local.\_
* **Moneda de la cuenta:** La moneda de tu cuenta de Localpayment. Si esta difiere de la moneda local, Localpayment realizará una conversión de divisas para obtener el importe equivalente en moneda local. Esta conversión se reflejará en tu extracto de cuenta.

> [!NOTE]
>
> **Nota**
>
> Para los países con varias monedas oficiales, el parámetro `paymentMethod.code` se utiliza para especificar la moneda de la transacción. Esto garantiza que el pago se procese en la moneda correcta para el método de pago elegido.


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/installments-plans
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/installments-plans:
    post:
      summary: Generar cotización de plan de pagos
      operationId: installments-plan-quote
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                paymentMethod:
                  type: object
                  description: >-
                    Especifica el método de pago utilizado o solicitado para la
                    transacción.
                  properties:
                    code:
                      type: string
                      description: >-
                        [Código del método de
                        pago](/es/reference/get-available-payment-methods). Solo
                        `paymentMethodType = CreditCard`.
                  required:
                    - code
                country:
                  type: string
                  enum:
                    - ARG
                    - BOL
                    - BRA
                    - CHL
                    - COL
                    - CRI
                    - DOM
                    - GTM
                    - HND
                    - MEX
                    - PAN
                    - PRY
                    - PER
                  description: >-
                    [País](/es/reference/country-codes) en el que se procesará
                    el pago. ISO 3166-1 alfa-3.
                currency:
                  type: string
                  enum:
                    - ARS
                    - BOB
                    - BRL
                    - CLP
                    - COP
                    - CRC
                    - DOP
                    - USD
                    - GTQ
                    - MXN
                    - PYG
                    - PEN
                  description: >-
                    La [moneda](/es/reference/currency-codes) en la que se
                    expresa la cantidad.
                amount:
                  type: number
                  description: Cantidad a dividir en cuotas.
                accountNumber:
                  type: string
                  description: >-
                    Número de cuenta de Localpayment en la que se abonará el
                    importe.
              required:
                - paymentMethod
                - country
                - currency
                - amount
                - accountNumber
              x-examples:
                Example 1:
                  paymentMethod:
                    code: '1000'
                  country: ARG
                  currency: ARS
                  amount: 1000
                  accountNumber: '{{accountNumber}}'
            examples:
              Installments Plan Quote:
                value:
                  paymentMethod:
                    code: '1000'
                  country: ARG
                  currency: ARS
                  amount: 1000
                  accountNumber: '{{accountNumber}}'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  installmentsToken:
                    type: string
                    description: >-
                      Un identificador único para el plan de pagos a plazos.
                      Este token se utiliza para hacer referencia a las opciones
                      de pago a plazos específicas generadas para una
                      transacción.
                  creationDate:
                    type: string
                    description: >-
                      Fecha y hora de creación del plan de pagos. La marca de
                      tiempo sigue el formato ISO 8601.
                  expirationDate:
                    type: string
                    description: >-
                      Fecha y hora de vencimiento del plan de pagos.
                      Transcurrido este plazo, el plan ya no podrá utilizarse.
                      La marca de tiempo sigue el formato ISO 8601.
                  currency:
                    type: string
                    description: El código de moneda para el importe de la transacción.
                  amount:
                    type: number
                    description: >-
                      El importe total de la transacción para la que se generó
                      el plan de pagos a plazos.
                  installments:
                    type: array
                    items:
                      type: object
                      properties:
                        installments:
                          type: integer
                          description: Número de cuotas disponibles para esta opción.
                        installmentAmount:
                          type: number
                          description: La cantidad a pagar en cada cuota.
                        totalPaymentAmount:
                          type: number
                          description: >-
                            El importe total a pagar en todas las cuotas,
                            incluidos los gastos de financiación.
                        financingFee:
                          type: number
                          description: >-
                            La comisión adicional que se cobra por financiar la
                            transacción en el número de cuotas seleccionado.
                x-examples:
                  Example 1:
                    installmentsToken: b71a6973-ffdc-427b-b014-e03eb4462e82
                    creationDate: '2022-03-29T23:53:52.7150456+00:00'
                    expirationDate: '2022-03-30T00:03:52.71509+00:00'
                    currency: ARS
                    amount: 2000
                    installments:
                      - installments: 2
                        installmentAmount: 1100
                        totalPaymentAmount: 2200
                        financingFee: 200
                      - installments: 3
                        installmentAmount: 941.7187
                        totalPaymentAmount: 2825.156
                        financingFee: 825.156
                      - installments: 6
                        installmentAmount: 633.17334
                        totalPaymentAmount: 3799.04
                        financingFee: 1799.04
              examples:
                200 - Installment Plan Quote:
                  value:
                    installmentsToken: bc1a1973-fadc-427b-b014-e43eb4462e82
                    creationDate: '2025-01-29T23:53:52.7150456+00:00'
                    expirationDate: '2025-01-30T00:03:52.71509+00:00'
                    currency: ARS
                    amount: 2000
                    installments:
                      - installments: 2
                        installmentAmount: 1100
                        totalPaymentAmount: 2200
                        financingFee: 200
                      - installments: 3
                        installmentAmount: 941.7187
                        totalPaymentAmount: 2825.156
                        financingFee: 825.156
                      - installments: 6
                        installmentAmount: 633.17334
                        totalPaymentAmount: 3799.04
                        financingFee: 1799.04
        '201':
          description: Creado
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Código de estado.
                      detail:
                        type: string
                        description: Detalles adicionales de la respuesta.
                    required:
                      - code
                      - detail
                required:
                  - status
              examples:
                829 - System error to generate Installment Plan.:
                  value:
                    status:
                      code: '829'
                      detail: System error to generate Installment Plan
        '400':
          description: Solicitud incorrecta.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Código de estado.
                      detail:
                        type: string
                        description: Detalles adicionales de la respuesta.
                    required:
                      - code
                      - detail
                required:
                  - status
              examples:
                300 - Invalid param.:
                  value:
                    status:
                      code: '300'
                      detail: Invalid param + [paymentMethod] + [Is mandatory]
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
        '403':
          description: Prohibido
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                required:
                  - detail
                x-examples:
                  Example 1:
                    detail: You do not have permission to perform this action.
              examples:
                403 - You do not have permission to perform this action.:
                  value:
                    detail: You do not have permission to perform this action.
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Código de estado.
                      detail:
                        type: string
                        description: Detalles adicionales de la respuesta.
                    required:
                      - code
                      - detail
                required:
                  - status
              examples:
                300 - Instalment Payment Plan is only for types of Credit Card methods:
                  value:
                    status:
                      code: '300'
                      detail: >-
                        Instalment Payment Plan is only for types of Credit Card
                        methods
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.