Loans

A loan is a revolving facility a borrower draws against and repays. Its balances, the limit, what is used, what is available, what is reserved and what is pending, are always in one currency, so the currency is stated once.

Opening a loan takes two calls. POST with LoanCmdApply and you get an offer: the terms the platform will lend on, signed with an offerToken. Send that offer back with LoanCmdAcceptOffer and the loan opens. The two steps exist because a borrower has to be shown the terms and agree to them, and there is no way to skip the agreement.

Movements are not here a drawdown or a card charge is a /loan-transactions. This collection is the loan itself: its status, its terms, and what it currently owes.

A trading account carries a metadata template, the rules its card transactions' metadata must meet. It is set on the application, comes back in the offer, which signs it, and is read under the loan's specification. LoanUpdateTradingAccount replaces it whole. A template is checked when it is set, and one that fails is refused with 400 naming the path at fault.

A loan's statement settings are a sub-resource. GET /loans/{loanId}/statement-settings reads which documents its statements produce, who they are mailed to and how the attachment is encrypted. PATCH with LoanUpdateStatementSettings replaces them whole, and LoanUpdateClearStatementSettings deletes them. All three need Loans_Update; the transfer secret is write-only.