# Monthly Payment Calculations

POST /partner/v2/shops/:shop_uuid/calculations

The calculations endpoint retrieves a preliminary calculation based on the credit amount and period. The actual calculation will be presented to the client after there is a decision based on the credit application.

Endpoint: POST /partner/v2/shops/{shop_uuid}/calculations
Security: bearerAuth

## Path parameters:

  - `shop_uuid` (string, required)
    The unique identifier of the shop.
    Example: "a93f1f44-d5dd-4469-bfcc-c1de9e969213"

## Request fields (application/json):

  - `product_code` (string, required)
    Product code.
    Example: "product_code_here"

  - `amount` (number, required)
    Financing amount.
    Example: 2000

  - `period` (integer, required)
    Financing period in months. Options depend on the particular product.
    Example: 12

  - `payment_day` (integer)
    Payment day. If not indicated, the default payment day set for this product will be used.
    Example: 5

## Response 201 fields (application/json):

  - `product_code` (string)
    Product code.
    Example: "product_code_here"

  - `amount` (number)
    Loan amount.
    Example: 200.99

  - `period` (integer)
    Loan period.

  - `payment_day` (integer)
    Payment day.

  - `currency` (string)
    Currency.
    Example: "EUR"

  - `payment_amount_monthly` (number)
    Monthly payment.

  - `interest_rate_annual` (number)
    Annual interest rate.

  - `credit_cost_rate_annual` (number)
    Annual credit cost rate.

  - `total_cost` (number)
    Total cost.

  - `total_cost_of_credit` (number)
    Total cost of credit.

  - `advanced` (object)

  - `advanced.interest_amount_total` (number)
    Total interest amount.

  - `advanced.contract_fee_amount_total` (number)
    Contract fee.

  - `advanced.contract_fee_percentage` (number)
    Contract fee percentage.

  - `advanced.contract_fee_minimum` (number)
    Minimum contract fee.

  - `advanced.admin_fee_amount_monthly` (number)
    Admin fee.

  - `advanced.admin_fee_amount_total` (number)
    Total admin fee.

  - `advanced.insurance_fee_amount_total` (number)
    Insurance fee.

  - `advanced.net_credit_amount` (number)
    Net credit amount.

  - `advanced.interest_bearing_amount` (number)
    Interest bearing amount.

  - `advanced.repayments_amount_total` (number)
    Repayments amount.

  - `advanced.credit_cost_amount_total` (number)
    Total cost of credit.

  - `advanced.first_payment_date` (string)
    First payment date.
    Example: "2022-08-05"

  - `advanced.first_payment_amount` (number)
    First payment amount.

  - `advanced.last_payment_date` (string)
    Last payment date.
    Example: "2023-01-05"

  - `advanced.last_payment_amount` (number)
    Last payment amount.

  - `advanced.inbank_ps_details` (object)

  - `advanced.inbank_ps_details.interest_type` (string)
    Interest calculation strategy. Example: floating

  - `advanced.inbank_ps_details.campaign_interest_type` (string)
    Campaign interest calculation strategy. Example: floating

  - `advanced.inbank_ps_details.campaign_interest_rate` (number)
    Interest rate on campaign period.

  - `advanced.inbank_ps_details.campaign_interest_period_start_date` (string)
    Campaign interest period start date.

  - `advanced.inbank_ps_details.campaign_interest_period_end_date` (string)
    Campaign interest period end date.

  - `advanced.inbank_ps_details.floating_interest_rate` (string)
    Floating interest rate.

  - `payment_schedule` (array)
    Payment schedule items.

  - `payment_schedule.item_number` (integer)
    Payment number.

  - `payment_schedule.payment_date` (string)
    Payment date.
    Example: "2022-06-29"

  - `payment_schedule.balance_before` (number)
    Balance.

  - `payment_schedule.principal` (number)
    Principal.

  - `payment_schedule.residual` (number)
    Residual.

  - `payment_schedule.interest` (number)
    Interest.

  - `payment_schedule.contract_fee` (number)
    Contract fee.

  - `payment_schedule.admin_fee` (number)
    Admin fee.

  - `payment_schedule.insurance_fee` (number)
    Insurance fee.

  - `payment_schedule.total_payment` (number)
    Total payment.

## Response 401 fields (application/json):

  - `message` (string)
    Unauthorized
    Example: "unauthorized"

## Response 403 fields (application/json):

  - `message` (string)
    Unauthorized access
    Example: "User is not authorized to access this resource with an explicit deny"

## Response 404 fields (application/json):

  - `message` (string)
    Not Found
    Example: "not_found"

## Response 422 fields (application/json):

  - `message` (string)
    Unprocessable Entity

## Response 500 fields (application/json):

  - `message` (string)
    Internal server error
    Example: "internal_server_error"