English

Português

English

Português

Appearance

Installment calculation ​

Installment methods ​

Appmax supports two installment calculation methods, configurable from 1 to 12 installments per merchant.

PP - Simple per installment ​

The interest rate is applied directly to the value of each installment. The additional cost is added to the base installment value, providing a clear view of the final amount to be paid each month.

This is the most commonly used method.

AM - Financing ​

The interest rate is calculated monthly on the total outstanding balance. The installment amounts vary, as interest is applied to the total balance each month.

Configured in specific situations, but equally relevant.

WARNING

It is essential to query the installments endpoint to ensure that order values are processed consistently across both systems, using the same rate. The system does not calculate interest automatically.

Query installments via API ​

Use the POST /v1/payments/installments endpoint to retrieve the values with the installment rates configured in Appmax.

bash
curl --request POST \
     --url https://api.appmax.com.br/v1/payments/installments \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "installments": 10,
  "total_value": 10000,
  "settings": true
}'

INFO

The endpoint returns the total value with interest applied for each method. Your integration must perform the division to obtain the exact value of each installment.

See the full documentation at Installment calculation via API.