---
updatedAt: 2026-04-06T17:26:26.000Z
agentTools:
  projectIndex: https://docs.pagar.me/v3/llms.txt
---

# Calculando Pagamentos Parcelados

Essa rota é utilizada para calcular o valor de cada uma das parcelas de uma compra e o valor final após aplicar os juros.

> 📘 Juros?
>
> Essa rota é uma recomendação, para que seja possível calcular juros como uma função das parcelas e uma porcentagem.\
> As contas utilizadas são:
>
> ```
> for x in params[free_installments]..params[max_installments]
>  | installment = x
>  | amount = params[amount] * (1 + interest_rate * params[max_installments]  / 100))
>  | installment_amount = amount / x
> ```
>
> Lembrando que a Pagar.me NÃO cobra juros, essa rota é apenas uma rota de conveniência.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "3"
  },
  "servers": [
    {
      "url": "https://api.pagar.me/1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "x-default": "",
        "type": "apiKey",
        "name": "api_key",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/transactions/calculate_installments_amount": {
      "get": {
        "summary": "Calculando Pagamentos Parcelados",
        "description": "Essa rota é utilizada para calcular o valor de cada uma das parcelas de uma compra e o valor final após aplicar os juros.",
        "operationId": "calculando-pagamentos-parcelados",
        "parameters": [
          {
            "name": "amount",
            "in": "query",
            "description": "Valor do produto/serviço vendido",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 10000
            }
          },
          {
            "name": "free_installments",
            "in": "query",
            "description": "Número de parcelas isentas de juros",
            "schema": {
              "type": "string",
              "default": "1"
            }
          },
          {
            "name": "max_installments",
            "in": "query",
            "description": "Valor máximo de parcelas",
            "schema": {
              "type": "string",
              "default": "12"
            }
          },
          {
            "name": "interest_rate",
            "in": "query",
            "description": "Valor da taxa de juros",
            "required": true,
            "schema": {
              "type": "number",
              "format": "float",
              "default": 13
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"installments\": {\n        \"1\": {\n            \"installment\": 1,\n            \"amount\": 10000,\n            \"installment_amount\": 10000\n        },\n        \"2\": {\n            \"installment\": 2,\n            \"amount\": 10598,\n            \"installment_amount\": 5299\n        },\n        \"3\": {\n            \"installment\": 3,\n            \"amount\": 10897,\n            \"installment_amount\": 3632\n        }\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "installments": {
                      "type": "object",
                      "properties": {
                        "1": {
                          "type": "object",
                          "properties": {
                            "installment": {
                              "type": "integer",
                              "example": 1,
                              "default": 0
                            },
                            "amount": {
                              "type": "integer",
                              "example": 10000,
                              "default": 0
                            },
                            "installment_amount": {
                              "type": "integer",
                              "example": 10000,
                              "default": 0
                            }
                          }
                        },
                        "2": {
                          "type": "object",
                          "properties": {
                            "installment": {
                              "type": "integer",
                              "example": 2,
                              "default": 0
                            },
                            "amount": {
                              "type": "integer",
                              "example": 10598,
                              "default": 0
                            },
                            "installment_amount": {
                              "type": "integer",
                              "example": 5299,
                              "default": 0
                            }
                          }
                        },
                        "3": {
                          "type": "object",
                          "properties": {
                            "installment": {
                              "type": "integer",
                              "example": 3,
                              "default": 0
                            },
                            "amount": {
                              "type": "integer",
                              "example": 10897,
                              "default": 0
                            },
                            "installment_amount": {
                              "type": "integer",
                              "example": 3632,
                              "default": 0
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X GET https://api.pagar.me/1/transactions/calculate_installments_amount -H 'content-type: application/json' -d '{\n    \"amount\": \"10000\", \n    \"api_key\": \"SUA_API_KEY\", \n    \"free_installments\": \"1\", \n    \"interest_rate\": \"13\", \n    \"max_installments\": \"3\"\n}'"
            },
            {
              "language": "ruby",
              "code": "require 'pagarme'\n\nPagarMe.api_key = \"ak_test_grXijQ4GicOa2BLGZrDRTR5qNQxJW0\"\n\ninstallments_result = PagarMe::Transaction.calculate_installments({\n    amount: 10000,\n    interest_rate: 13\n})"
            },
            {
              "language": "javascript",
              "code": "const pagarme = require('pagarme')\n  \npagarme.client.connect({ api_key: 'SUA_API_KEY' })\n  .then(client => client.transactions.calculateInstallmentsAmount({\n    id: 1234,\n    max_installments: 3,\n    free_installments: 2,\n    interest_rate: 13,\n    amount: 1000\n  }))\n  .then(installments => console.log(installments))",
              "name": "JS"
            },
            {
              "language": "php",
              "code": "<?php\nrequire(\"vendor/autoload.php\");\n$pagarme = new PagarMe\\Client('SUA_CHAVE_DE_API');\n\n$calculateInstallments = $pagarme->transactions()->calculateInstallments([\n  'amount' => 'VALOR_DA_TRANSAÇÃO_EM_CENTAVOS',\n  'free_installments' => 'PARCELAS_SEM_JUROS',\n  'max_installments' => 'MÁXIMO_DE_PARCELAS',\n  'interest_rate' => 'TAXA_DE_JUROS_AO_MÊS'\n]);",
              "name": "PHP"
            },
            {
              "language": "csharp",
              "code": "Oops, ainda não temos essa feature no SDK."
            },
            {
              "language": "python",
              "code": "import pagarme\n\npagarme.authentication_key(\"SUA_API_KEY\")\n\ninstallments = pagarme.transaction.calculate_installments_amount({\n    \"amount\": \"10000\",\n    \"free_installments\": \"1\",\n    \"interest_rate\": \"13\",\n    \"max_installments\": \"3\"\n})\n\nprint(installments)"
            }
          ],
          "samples-languages": [
            "curl",
            "ruby",
            "javascript",
            "php",
            "csharp",
            "python"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```