# Monthly Payment Calculations

POST /partner/v3/shops/:shopUuid/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/v3/shops/{shopUuid}/calculations
Security: bearerAuth

## Path parameters:

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

## Request fields (application/json):

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

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

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

  - `downPaymentAmount` (number)
    Down payment amount. If not provided, then set to 0. 
Note that down payment is required in Latvia for Hire Purchase payment products for amounts over 1400 EUR.

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

  - `responseLevel` (string)
    Indication of how detailed the returned response should be. If not selected, the simple option will be used by default. Note, that to show the Split into parts payments, you need to use the payment_schedule response level.
    Enum: "simple", "advanced", "payment_schedule"

## Response 201 fields (application/json):

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

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

  - `period` (integer)
    Loan period.

  - `downPaymentAmount` (number)
    Down payment amount.

  - `paymentDay` (integer)
    Payment day.

  - `responseLevel` (string)
    Response level.
    Example: "simple"

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

  - `paymentAmountMonthly` (number)
    Monthly payment.

  - `interestRateAnnual` (number)
    Annual interest rate.

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

  - `totalCost` (number)
    Total cost.

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

  - `downPaymentMinimumPercentage` (number)
    Down payment minimum percentage.

  - `downPaymentMinimumAmount` (number)
    Down payment minimum amount.

  - `advanced` (object)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  - `advanced.downPaymentMainPart` (number)
    Down payment main part.

  - `advanced.inbankPsDetails` (object)

  - `advanced.inbankPsDetails.interestType` (string)
    Interest calculation strategy. Example: floating

  - `advanced.inbankPsDetails.campaignInterestType` (string)
    Campaign interest calculation strategy. Example: floating

  - `advanced.inbankPsDetails.campaignInterestRate` (number)
    Interest rate on campaign period.

  - `advanced.inbankPsDetails.campaignInterestPeriodStartDate` (string)
    Campaign interest period start date.

  - `advanced.inbankPsDetails.campaignInterestPeriodEndDate` (string)
    Campaign interest period end date.

  - `advanced.inbankPsDetails.floatingInterestRate` (string)
    Floating interest rate.

  - `paymentSchedule` (array)
    Payment schedule items.

  - `paymentSchedule.itemNumber` (integer)
    Payment number.

  - `paymentSchedule.paymentDate` (string)
    Payment date.
    Example: "2022-06-29"

  - `paymentSchedule.balanceBefore` (number)
    Balance.

  - `paymentSchedule.principal` (number)
    Principal.

  - `paymentSchedule.residual` (number)
    Residual.

  - `paymentSchedule.interest` (number)
    Interest.

  - `paymentSchedule.contractFee` (number)
    Contract fee.

  - `paymentSchedule.adminFee` (number)
    Admin fee.

  - `paymentSchedule.insuranceFee` (number)
    Insurance fee.

  - `paymentSchedule.totalPayment` (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"