Apply inherited loan product charge

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "chargeTemplateId": "<string>",
  "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
  "productVersionId": "550e8400-e29b-41d4-a716-446655440001",
  "accountCreatedAt": "2026-06-14T12:00:00Z",
  "chargeEffectiveAt": "2026-06-14T12:00:00Z"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges"

	payload := strings.NewReader("{\n  \"chargeTemplateId\": \"<string>\",\n  \"loanAccountId\": \"550e8400-e29b-41d4-a716-446655440005\",\n  \"productVersionId\": \"550e8400-e29b-41d4-a716-446655440001\",\n  \"accountCreatedAt\": \"2026-06-14T12:00:00Z\",\n  \"chargeEffectiveAt\": \"2026-06-14T12:00:00Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    chargeTemplateId: '<string>',
    loanAccountId: '550e8400-e29b-41d4-a716-446655440005',
    productVersionId: '550e8400-e29b-41d4-a716-446655440001',
    accountCreatedAt: '2026-06-14T12:00:00Z',
    chargeEffectiveAt: '2026-06-14T12:00:00Z'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges"

payload = {
    "chargeTemplateId": "<string>",
    "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
    "productVersionId": "550e8400-e29b-41d4-a716-446655440001",
    "accountCreatedAt": "2026-06-14T12:00:00Z",
    "chargeEffectiveAt": "2026-06-14T12:00:00Z"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "accountCreatedAt": "2026-06-14T12:00:00Z",
  "amount": "1234.56",
  "assessedAt": "2026-06-14T12:00:00Z",
  "chargeCode": "LATE_FEE",
  "chargeTemplateId": "<string>",
  "chargeType": "<string>",
  "currency": "BRL",
  "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
  "rate": "0.015",
  "sourceProductVersionId": "550e8400-e29b-41d4-a716-446655440001",
  "billedDueDate": "2026-07-15",
  "billedInstallmentNumber": 3,
  "regulatoryWarnings": [
    "<string>"
  ]
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

POST

api

loan-products

{id}

charges

Apply inherited loan product charge

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "chargeTemplateId": "<string>",
  "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
  "productVersionId": "550e8400-e29b-41d4-a716-446655440001",
  "accountCreatedAt": "2026-06-14T12:00:00Z",
  "chargeEffectiveAt": "2026-06-14T12:00:00Z"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges"

	payload := strings.NewReader("{\n  \"chargeTemplateId\": \"<string>\",\n  \"loanAccountId\": \"550e8400-e29b-41d4-a716-446655440005\",\n  \"productVersionId\": \"550e8400-e29b-41d4-a716-446655440001\",\n  \"accountCreatedAt\": \"2026-06-14T12:00:00Z\",\n  \"chargeEffectiveAt\": \"2026-06-14T12:00:00Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    chargeTemplateId: '<string>',
    loanAccountId: '550e8400-e29b-41d4-a716-446655440005',
    productVersionId: '550e8400-e29b-41d4-a716-446655440001',
    accountCreatedAt: '2026-06-14T12:00:00Z',
    chargeEffectiveAt: '2026-06-14T12:00:00Z'
  })
};

fetch('https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://lender.sandbox.lerian.net/api/v1/loan-products/{id}/charges"

payload = {
    "chargeTemplateId": "<string>",
    "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
    "productVersionId": "550e8400-e29b-41d4-a716-446655440001",
    "accountCreatedAt": "2026-06-14T12:00:00Z",
    "chargeEffectiveAt": "2026-06-14T12:00:00Z"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "accountCreatedAt": "2026-06-14T12:00:00Z",
  "amount": "1234.56",
  "assessedAt": "2026-06-14T12:00:00Z",
  "chargeCode": "LATE_FEE",
  "chargeTemplateId": "<string>",
  "chargeType": "<string>",
  "currency": "BRL",
  "loanAccountId": "550e8400-e29b-41d4-a716-446655440005",
  "rate": "0.015",
  "sourceProductVersionId": "550e8400-e29b-41d4-a716-446655440001",
  "billedDueDate": "2026-07-15",
  "billedInstallmentNumber": 3,
  "regulatoryWarnings": [
    "<string>"
  ]
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

requerido

Canonical idempotency key for safe retries.

Ejemplo:

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

Parámetros de ruta

string<uuid>

requerido

Loan product identifier.

Ejemplo:

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

Cuerpo

application/json

chargeTemplateId

string

requerido

Charge template identifier.

loanAccountId

string<uuid>

requerido

Loan account identifier.

Ejemplo:

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

productVersionId

string<uuid>

requerido

Product version identifier.

Ejemplo:

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

accountCreatedAt

string

Loan account creation instant (RFC 3339). A bare calendar date is refused with LENDER-0103: this value is compared for exact equality against the stored account fact.

Ejemplo:

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

chargeEffectiveAt

string

RFC 3339 instant the charge was levied. A bare calendar date is refused with LENDER-0103: this value is the moment a fee was assessed and it also decides which charge template was in force. Omit it and Lender stamps the tenant's business now.

Ejemplo:

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

Respuesta

Created

accountCreatedAt

string

requerido

Loan account creation timestamp (RFC3339, UTC).

Ejemplo:

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

amount

string

requerido

Charge amount as a decimal string in major currency units, fixed scale of 2 decimal places.

Ejemplo:

"1234.56"

assessedAt

string

requerido

Timestamp the charge was assessed (RFC3339, UTC).

Ejemplo:

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

chargeCode

string

requerido

Charge code resolved from the template.

Ejemplo:

"LATE_FEE"

chargeTemplateId

string

requerido

Charge template the fact was derived from.

chargeType

string

requerido

Charge type resolved from the template.

currency

string

requerido

ISO 4217 currency code of the amount.

Ejemplo:

"BRL"

loanAccountId

string

requerido

Loan account the charge was applied to (uuid).

Ejemplo:

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

rate

string

requerido

Charge rate as a decimal string (fractional, e.g. "0.015" for 1.5%).

Ejemplo:

"0.015"

sourceProductVersionId

string

requerido

Product version whose template produced this charge (uuid).

Ejemplo:

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

billedDueDate

string

ISO-8601 due date of the instalment the charge is billed on. Absent with billedInstallmentNumber.

Ejemplo:

"2026-07-15"

billedInstallmentNumber

integer<int64>

Instalment the charge is billed on: the first, in schedule order, due on a São Paulo civil day after the later of the charge's day and today, still owing something and promised to no automatic prepayment. Absent on a charge recorded before charges were billed.

Ejemplo:

3

regulatoryWarnings

string[] | null

Non-blocking regulatory warnings raised while assessing the charge.

Productos de préstamo de Brasil

Operaciones de consignado

Ciclo de vida del producto

Versiones del producto

Configuración del producto

Tablas de tasa flotante

Plantillas de documento

Solicitudes de Préstamo

Garantías

Instrumentos de crédito

Divulgaciones regulatorias y riesgo

Liquidación y prepago

Bajas contables y recuperación de crédito

Resumen y auditoría de cuenta

Cargos y calendario

Pagos

Transacciones

Cuentas por cobrar de pago devuelto

Fondos de cesión

Lotes de cesión

Excepciones y dossiers de la cesión

Contabilidad

Paneles de cartera

Jurisdicciones

Impuestos

Acceso de socios

Sesión

Fecha de negocio

Streaming

Manejo de errores

Eventos

Apply inherited loan product charge

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta