Retain authentic external cash before exact native settlement or return accounting
/ledger/payable-remittances/{id}/receiptsVerified svc_payments with existing ledger:post is required even locally. Authenticate the exact retained environment/provider/key and signed event, retain it before accounting, then apply supported partial settlement or actual partial return against its booked original. Cumulative allocation bounds and globally claimed native cash identities exclude reuse; prior independent line allocations also block duplicate booking. Unsupported fees or conflicting actual evidence remain retained with explicit refusal. The route accepts one strict8MiB JSON envelope, including at most4MiB raw evidence; complete responses are bounded16MiB. Exact event identity replay recovers one original journal. Production bank-statement date/amount/source proof remains required for cash readiness.
Path parameters
idstringRequiredHeaders
Idempotency-KeystringOptionalSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
allocationsarray of objectsRequired3 child attributes
amount_minorintegerRequiredobligation_idstringRequiredsource_sha256stringRequiredamount_minorintegerRequiredcurrencystringRequireddestinationobjectRequiredDestination is the exact reviewed beneficiary and domestic receiving account. A valid routing checksum does not establish actual bank or account ownership.
3 child attributes
account_numberstringRequiredlegal_namestringRequiredrouting_numberstringRequiredenvironmentstringRequiredevent_idstringRequiredevidencestring · byteRequiredevidence_formatstringRequiredevidence_sha256stringRequiredfee_minorintegerRequiredinstruction_sha256stringRequiredkey_idstringRequiredkindstringRequiredlegal_entitystringRequiredmaster_cash_external_account_referencestringRequiredmaster_cash_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
master_cash_statement_line_referencestringRequiredmaster_cash_statement_referencestringRequirednetwork_referencestringRequiredobserved_atstring · date-timeRequiredoriginal_network_referencestringOptionaloriginal_settlement_sha256stringOptionalpayee_sha256stringRequiredproviderstringRequiredrailstringRequiredremittance_idstringRequiredsettled_atstring · date-timeRequiredsettlement_datestring · dateRequiredA business date, YYYY-MM-DD
signaturestringRequiredversionstringRequiredReturns
200 OK
actorstringRequiredblockersarray of stringsOptionalcash_readybooleanRequiredcash_statement_idstringOptionalcash_statement_sha256stringOptionalcontent_sha256stringRequiredjournal_idstringOptionalExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
journal_keystringOptionalreceiptobjectRequiredCashReceipt records one actual external cash event, never an acceptance, cancellation request or simulator status. AmountMinor is payable principal; FeeMinor is a separately stated actual fee. Only zero fees are bookable in the current supported accounting scope. A trusted nonzero fee remains authentic.
30 child attributes
allocationsarray of objectsRequired3 child attributes
amount_minorintegerRequiredobligation_idstringRequiredsource_sha256stringRequiredamount_minorintegerRequiredcurrencystringRequireddestinationobjectRequiredDestination is the exact reviewed beneficiary and domestic receiving account. A valid routing checksum does not establish actual bank or account ownership.
3 child attributes
account_numberstringRequiredlegal_namestringRequiredrouting_numberstringRequiredenvironmentstringRequiredevent_idstringRequiredevidencestring · byteRequiredevidence_formatstringRequiredevidence_sha256stringRequiredfee_minorintegerRequiredinstruction_sha256stringRequiredkey_idstringRequiredkindstringRequiredlegal_entitystringRequiredmaster_cash_external_account_referencestringRequiredmaster_cash_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
master_cash_statement_line_referencestringRequiredmaster_cash_statement_referencestringRequirednetwork_referencestringRequiredobserved_atstring · date-timeRequiredoriginal_network_referencestringOptionaloriginal_settlement_sha256stringOptionalpayee_sha256stringRequiredproviderstringRequiredrailstringRequiredremittance_idstringRequiredsettled_atstring · date-timeRequiredsettlement_datestring · dateRequiredA business date, YYYY-MM-DD
signaturestringRequiredversionstringRequiredrecorded_atstring · date-timeRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503