Skip to main content
POST
Create prepayment quote

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Path Parameters

id
string<uuid>
required

Loan account identifier.

Body

application/json
amount
string
required

Prepayment amount in major currency units (e.g. "100.00").

Example:

"42000.00"

quoteType
enum<string>
required

Discriminator: partial principal prepayment.

Available options:
partial
businessDate
string

Optional valuation date (RFC3339 or YYYY-MM-DD); defaults to now (UTC).

Example:

"2026-06-14"

Response

Created

chargeRebate
string
required

Rebate of unaccrued charges and fees credited on prepayment, as a decimal string, scale 2.

Example:

"120.00"

consumerProtectionRegime
string
required

Consumer-protection regime label applied to the prepayment terms.

createdAt
string
required

RFC3339 UTC timestamp when the quote was created.

Example:

"2026-06-14T12:00:00Z"

currency
string
required

ISO 4217 currency code of the loan and quote.

Example:

"BRL"

expiresAt
string
required

RFC3339 UTC timestamp after which the quote is no longer valid.

Example:

"2026-06-14T12:00:00Z"

grossAmount
string
required

Retired settlement principal being paid off (equals the outstanding principal for a full settlement), as a decimal string, scale 2.

Example:

"42000.00"

id
string
required

Unique identifier (UUID) of the prepayment quote.

Example:

"550e8400-e29b-41d4-a716-446655440000"

interestRebate
string
required

Mandatory interest rebate (juros nao incorridos) credited on prepayment, as a decimal string, scale 2.

Example:

"1250.75"

iofReconciliation
string
required

IOF adjustment as a decimal string, scale 2. Defined-principal loans report zero because IOF is not refunded on early payoff.

Example:

"0.00"

jurisdictionCode
string
required

ISO jurisdiction code governing the quote (e.g. "BR").

Example:

"BR"

loanAccountId
string
required

UUID of the loan account the quote was generated for.

Example:

"550e8400-e29b-41d4-a716-446655440001"

netSettlementAmount
string
required

Net cash payable to settle: gross settlement principal minus charge rebate plus any IOF due, as a decimal string, scale 2. Interest rebate is disclosure-only; defined-principal loans report zero IOF reconciliation because IOF is not refunded.

Example:

"41880.00"

principalOutstanding
string
required

Outstanding principal at quote time as a decimal string in major currency units, scale 2.

Example:

"42000.00"

profileVersion
string
required

Jurisdiction profile version used to compute the quote.

Example:

"1.0.0"

quoteType
string
required

Quote variant: partial (principal prepayment) or full_settlement.

Example:

"partial"

rebateMandatory
boolean
required

True when regulation mandates applying the interest rebate to this quote.

acceptedAt
string

RFC3339 UTC timestamp when the quote was accepted; empty while still pending.

Example:

"2026-06-14T12:00:00Z"

acceptedTransactionId
string

Identifier of the settlement transaction that accepted the quote; empty while still pending.

Example:

"550e8400-e29b-41d4-a716-446655440002"

slaDueAt
string

RFC3339 UTC full-settlement SLA deadline; omitted for partial quotes.

Example:

"2026-06-19T12:00:00Z"