Return only unallocated loan-forwarding funds to the actual original borrower debit DDA

POST/ledger/payable-obligations/{id}/refunds

Only verified svc_lending with existing ledger:post may refund an exact loan_forwarding obligation. The caller supplies retained lender request/notice evidence and actual requesting identity. Native accounting resolves only the original two-entry loan receipt's borrower-owned open USD DDA, bounds the amount by still-held unallocated funds, atomically debits2365 and credits that original DDA, and pins the refund against generic reversal. Exact key and source identity replay returns the original journal; no caller-selected destination exists.

Path parameters

idstringRequired

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

amount_minorintegerRequired

evidence_referencestringRequired

obligation_idstringRequired

obligation_sha256stringRequired

reasonstringRequired

requested_bystringRequired

source_idstringRequired

source_sha256stringRequired

Returns

200 OK

actorstringRequired

amount_minorintegerRequired

content_sha256stringRequired

created_atstring · date-timeRequired

destination_ledger_account_idstringRequired

Example lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm

evidence_referencestringRequired

idstringRequired

journal_idstringRequired

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

journal_keystringRequired

obligation_idstringRequired

obligation_sha256stringRequired

reasonstringRequired

requested_bystringRequired

source_idstringRequired

source_sha256stringRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503