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

# Get the installments of a payment method

> Returns the numbers of monthly installments a saved card accepts for an amount, so you can show an installment selector before you charge the card. The payment method must be an active card of your organization, saved with a network token, and match the mode (`live` or `test`) of the API key used. Debit, prepaid, and foreign cards return an empty list. Only `CLP` amounts are supported.



## OpenAPI

````yaml reference/main-api.json GET /v2/payment_methods/{id}/installments
openapi: 3.1.0
info:
  title: fintoc-api
  version: v2026-02-01
servers:
  - url: https://api.fintoc.com
security: []
paths:
  /v2/payment_methods/{id}/installments:
    get:
      tags:
        - Payment methods
      summary: Get the installments of a payment method
      description: >-
        Returns the numbers of monthly installments a saved card accepts for an
        amount, so you can show an installment selector before you charge the
        card. The payment method must be an active card of your organization,
        saved with a network token, and match the mode (`live` or `test`) of the
        API key used. Debit, prepaid, and foreign cards return an empty list.
        Only `CLP` amounts are supported.
      operationId: v2.payment-methods-installments
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier of the card payment method.
        - name: amount
          in: query
          required: true
          schema:
            type: integer
          description: >-
            Positive amount to charge, in the smallest currency unit (for
            example, `1000` for `$1000 CLP`, since CLP has no minor unit).
        - name: currency
          in: query
          required: true
          schema:
            type: string
          description: Three-letter ISO 4217 currency code of the amount. Must be `CLP`.
      responses:
        '200':
          description: The installment options of the card for the amount.
          content:
            application/json:
              examples:
                card_installments:
                  value:
                    available_installments:
                      - 3
                      - 6
                      - 12
              schema:
                $ref: '#/components/schemas/payment_method_installments'
        '400':
          description: >-
            The `amount` parameter is missing or not positive, or `currency` is
            not `CLP`.
          content:
            application/json:
              examples:
                not_supported_currency:
                  value:
                    error:
                      type: invalid_request_error
                      code: not_supported_currency
                      param: currency
                      message: >-
                        Not supported currency: MXN. Currently, supported
                        currencies are: CLP.
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              examples:
                invalid_api_key:
                  value:
                    error:
                      type: authentication_error
                      code: invalid_api_key
                      message: 'Invalid API Key: invalid-*oken'
              schema:
                $ref: '#/components/schemas/error_object'
        '404':
          description: >-
            The payment method does not exist, belongs to another organization,
            or its mode does not match the mode of the API key.
          content:
            application/json:
              examples:
                payment_method_not_found:
                  value:
                    error:
                      type: invalid_request_error
                      code: missing_resource
                      param: id
                      message: 'No such payments/payment_method: pm_nonexistent'
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
        '422':
          description: >-
            The payment method is not a card, or the card is canceled, inactive,
            or has no network token.
          content:
            application/json:
              examples:
                saved_card_not_available:
                  value:
                    error:
                      type: invalid_request_error
                      code: invalid_payment_method_state
                      param: id
                      message: >-
                        Payment method pm_4eFgHiJkLmNoPqRs is not available for
                        installments
                      doc_url: https://docs.fintoc.com/reference/errors
              schema:
                $ref: '#/components/schemas/error_object'
      security:
        - api_key: []
components:
  schemas:
    payment_method_installments:
      type: object
      description: Installment options of a saved card for a given amount.
      properties:
        available_installments:
          type: array
          items:
            type: integer
          description: >-
            Numbers of monthly installments the card accepts for the amount.
            Empty for debit, prepaid, and foreign cards.
      required:
        - available_installments
    error_object:
      type: object
      properties:
        error:
          type: object
          description: Details of the error that caused the request to fail.
          properties:
            code:
              type: string
              description: >-
                Machine-readable code identifying the specific error, for
                example `invalid_api_key`. Not returned by every error.
              example: invalid_api_key
            doc_url:
              type: string
              description: >-
                URL of a documentation page with more details about the error.
                Not returned by every error.
              example: https://docs.fintoc.com/reference/errors
            message:
              type: string
              description: Human-readable message describing the error.
              example: 'Invalid API Key: invalid-*oken'
            param:
              type:
                - string
                - 'null'
              description: >-
                Name of the request parameter that caused the error. `null` when
                the error cannot be tied to a single parameter, and not returned
                by every error.
              example: amount
            type:
              type: string
              description: >-
                Category of the error, for example `invalid_request_error`,
                `authentication_error`, or `api_error`.
              example: invalid_request_error
          required:
            - type
            - message
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````