@spec get(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific loan.

@spec get_credit_line_mandate(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Returns the active SDD mandate for a credit line.

@spec get_dunning_case(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Retrieves a specific dunning case.

@spec get_repayment_history(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Returns the full repayment history for a loan.

Includes all past SDD/SCT transactions.

@spec get_repayment_schedule(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Solaris.Error.t()}

Returns the full repayment schedule for a loan.

Includes balance, fees, penalties, interest, and installment breakdown.

Examples

{:ok, schedule} = Solaris.Lending.Loans.get_repayment_schedule("cloan_123")

Enum.each(schedule["installments"], fn i ->
  IO.puts("Due: #{i["due_date"]} — #{i["amount"]["amount"]} #{i["amount"]["currency"]}")
end)

@spec list(keyword()) :: {:ok, map()} | {:error, Solaris.Error.t()}

Lists all loans across all customers.

Options

• :page, :per_page, :after, :before
• :status — filter by loan status

@spec list_dunning_cases(keyword()) :: {:ok, map()} | {:error, Solaris.Error.t()}

Lists all dunning cases across all customers.

@spec list_dunning_notifications(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, Solaris.Error.t()}

Lists notifications for a dunning case.