---
title: "Get Available Installment Plans"
method: GET
path: "/v3/fees/calculate"
tags: ["Fees API"]
---

# Get Available Installment Plans

`GET /v3/fees/calculate`

Retrieves valid installment options for a transaction based on the credit card BIN,
amount, and other input parameters. Performs validation for the "Meses Sin Intereses" program in Mexico.

> 🚧 Installments Authorization
> 
> The Installments feature from PagSeguro International Payin uses a different authorization method.
> 
> To authorize your requests to the Get Available Installment Plans endpoint, you have to use the authorization method described by the [Payout Authorization](https://developers.international.pagseguro.com/boacompra/reference/payout-authentication) documentation.

## Query parameters

- `payment_methods` 'CREDIT_CARD', required
- `value` number, float, required
- `max_installments` integer
- `card_bin` string, required
- `charge_country` 'BR' | 'MX', required
- `currency` 'BRL' | 'MXN', required

## Headers

- `x-store-id` string, required

## Response `200`

Successful response with available installment plans.

- InstallmentPlansResponse
  - `payment_methods` object
    - `credit_card` object
      - `mastercard` object
        - `installment_plans` object[]
          - `installments` integer
          - `installment_value` number, float
          - `amount` object
            - `value` number, float
            - `currency` string — Currency code (ISO 4217 alpha-3).

## Other responses

- `400` — Bad Request
- `500` — Internal server error

---

[API](https://skmtc.net/pagseguro/apis/pagseguro-international-api.md) · [All operations](https://skmtc.net/pagseguro/apis/pagseguro-international-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagseguro/pagseguro-international-api/revisions/032af0550731/schema)