Create a repayment

post

https://api.clc.solutions/v1/facilities/{facilityId}/repayments

Requires scope repayment:create.

Applied as a waterfall — interest, then fees, then principal — so a repayment smaller than the accrued interest moves no principal at all. Headroom for future draws is restored once it lands.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

facilityId

string

required

Body Params

margin_warning_number

integer

≥ 1

The margin warning this repayment is curing, by its number on this facility. Optional, and worth sending whenever it applies.
CLC can guess — a repayment that lands while a warning is open is probably the cure — but a borrower who repays for their own reasons during a warning window makes that guess wrong, and the guess decides whether a deadline was met. Say which one and there is nothing to infer.

amount

string

required

^\d+(\.\d+)?$

String decimal, never a float

asset

string

required

Headers

Idempotency-Key

string

required

length ≤ 255

Required on every mutation. Unique per (tenant, key). Stored 24 h; a replay returns the original response with Idempotent-Replay: true.

X-CLC-Timestamp

string

required

^[0-9]{10}$

Unix seconds. Requests outside a ±5 minute window are rejected, and the value is part of the signed canonical request.

X-CLC-Signature

string

required

length between 88 and 88

^[A-Za-z0-9+/]{86}==$

Base64 of the Ed25519 signature over the canonical request. Ed25519 signatures are always 64 bytes, so this is always 88 characters ending in ==.

Response

202Repayment accepted; application via repayment.applied webhook