Corgi BankDocumentation
OpenAPI

Independently decide a return of actual unallocated forwarding money

POST/lending-servicing/payment-returns/{id}/reviews

Bounded 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

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

approvebooleanRequired
evidenceobjectRequired

Evidence identifies the actual reviewed input, never an inferred geocode or identity.

2 child attributes
referencestringRequired
sha256stringRequired
reasonstringRequired

Returns

200 OK

actorstringRequired
content_sha256stringRequired
created_atstring · date-timeRequired
decisionobject or nullOptional
5 child attributes
actorstringRequired
approvebooleanRequired
atstring · date-timeRequired
evidenceobjectRequired

Evidence identifies the actual reviewed input, never an inferred geocode or identity.

2 child attributes
referencestringRequired
sha256stringRequired
reasonstringRequired
idstringRequired
received_payment_idstringRequired

Example lpay_2tVh8nqLxq4GbDe0K1F6S9zRcWm

requestobjectRequired
4 child attributes
amount_minorintegerRequired
evidenceobjectRequired

Evidence identifies the actual reviewed input, never an inferred geocode or identity.

2 child attributes
referencestringRequired
sha256stringRequired
proper_recipient_noticeobjectRequired

ProperRecipientNotice is actual retained notice evidence. Capturing it does not send a message or manufacture provider delivery confirmation.

5 child attributes
customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

noticeobjectRequired
3 child attributes
channelstringRequired
evidenceobjectRequired

Evidence identifies the actual reviewed input, never an inferred geocode or identity.

sent_atstring · date-timeRequired
receiving_servicer_contactstringRequired
receiving_servicer_idstringRequired
receiving_servicer_namestringRequired
reasonstringRequired
resultobject or nullOptional
15 child attributes
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

to move to open esc to close