Skip to main content
POST
Declare charge model revision

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

id
string<uuid>
requerido

Loan product version identifier.

Cuerpo

application/json
amount
string
requerido

Flat amount, decimal string, non-negative.

Ejemplo:

"25.00"

chargeCode
string
requerido

Charge code carried onto every charge assessed from this model.

Minimum string length: 1
Ejemplo:

"SERVICING_FEE"

chargeTemplateId
string
requerido

Operator-chosen key for this charge model. Charges are applied by naming it.

Required string length: 1 - 128
Ejemplo:

"SERVICING_FEE"

chargeType
enum<string>
requerido

Charge type. Not a label: the Brazilian consumer-credit cap applies to late_fee and default_interest only, so a wrong type escapes its own ceiling.

Opciones disponibles:
late_fee,
default_interest,
origination_fee,
fee
Ejemplo:

"fee"

currency
string
requerido

ISO 4217 currency code.

Required string length: 3
Ejemplo:

"BRL"

effectiveFrom
string
requerido

Date this revision takes effect (RFC3339 or YYYY-MM-DD, UTC). Must be strictly after the newest revision of the same model on this version: a revision never reaches backwards into days already priced.

Ejemplo:

"2026-04-01"

rate
string

Rate component, decimal string, non-negative. Defaults to 0.

Ejemplo:

"0"

refundable
boolean

Whether early payoff gives this charge back pro-rata (CDC art. 52 par. 2), measured from the day it was assessed to the contract's final scheduled due date. ABSENT MEANS NOT REFUNDABLE: a charge earned when it was levied, such as a flat origination fee, must be left false. The assessed charge freezes this declaration, so revising the model never changes what is owed on a charge already levied.

Ejemplo:

false

Respuesta

Created

amount
string
requerido

Flat amount, decimal string.

Ejemplo:

"25.00"

chargeCode
string
requerido

Charge code.

Ejemplo:

"SERVICING_FEE"

chargeTemplateId
string
requerido

Operator-chosen key for this charge model.

Ejemplo:

"SERVICING_FEE"

chargeType
string
requerido

Charge type.

Ejemplo:

"fee"

currency
string
requerido

ISO 4217 currency code.

Ejemplo:

"BRL"

effectiveFrom
string
requerido

Date this revision takes effect (RFC3339, UTC).

Ejemplo:

"2026-04-01T00:00:00Z"

productVersionId
string
requerido

Product version this model belongs to (uuid).

Ejemplo:

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

rate
string
requerido

Rate component, decimal string.

Ejemplo:

"0"

refundable
boolean
requerido

Whether early payoff gives this charge back pro-rata.

Ejemplo:

false