Independently decide a return of actual unallocated forwarding money
/lending-servicing/payment-returns/{id}/reviewsBounded USD individual-loan servicing forwarding. Actual ledger receipt, approved transfer receiver and native payable source are immutable. Customer receipt initiation requires lending:write, verified borrower identity and fresh step-up, with the exact original single-owner DDA. Read requires that borrower with lending:read or dedicated servicing read. Recovery, notice-backed return proposal and execution require human lending:servicing:write and fresh step-up; return review requires independent human lending:servicing:approve. Cancellation atomically fences an absent journal or recovers committed money. No loan principal reduction or receiving-servicer application/timeliness claim. Forwarding and return do not end after 60 days; the separately recorded 60-day window alone does not establish contractual timeliness.
Path parameters
idstringRequiredHeaders
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
approvebooleanRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredreasonstringRequiredReturns
200 OK
actorstringRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddecisionobject or nullOptional5 child attributes
actorstringRequiredapprovebooleanRequiredatstring · date-timeRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredreasonstringRequiredidstringRequiredreceived_payment_idstringRequiredExample lpay_2tVh8nqLxq4GbDe0K1F6S9zRcWm
requestobjectRequired4 child attributes
amount_minorintegerRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredproper_recipient_noticeobjectRequiredProperRecipientNotice is actual retained notice evidence. Capturing it does not send a message or manufacture provider delivery confirmation.
5 child attributes
customer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
noticeobjectRequired3 child attributes
channelstringRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
sent_atstring · date-timeRequiredreceiving_servicer_contactstringRequiredreceiving_servicer_idstringRequiredreceiving_servicer_namestringRequiredreasonstringRequiredresultobject or nullOptional15 child attributes
actorstringRequiredamount_minorintegerRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddestination_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
evidence_referencestringRequiredidstringRequiredjournal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
journal_keystringRequiredobligation_idstringRequiredobligation_sha256stringRequiredreasonstringRequiredrequested_bystringRequiredsource_idstringRequiredsource_sha256stringRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503