Read exact retained action and posting evidence
/cards/schemes/actions/{id}Verified cards staff, fresh step-up on writes and independent operations:approve review. Network and cash proposals additionally require exact svc_issuerproc service authority and a versioned Ed25519 processor receipt under optional CARD_SCHEME_CONFIG. Actual original USD clearing is pinned without consuming settlement reconciliation ownership. Instructions retain dispatch deadlines; only signed exact sequence acknowledgements establish network facts. Case accounting uses 1310 receivable, 2310 payable and 2390 unallocated recovery; actual cash receipts separately move 1010. Allocation exclusively claims the actual completed final consumer dispute loss journal before recovering expense5500; it does not credit the customer again. One live case per original clearing and one pending command per case reserve capacity. Closed network cases do not admit protocol reopening; partial unused original/loss amounts are explicit. Scheme eligibility, licensed reason-specific rules, external cash sourcing and certified transport remain adapter responsibilities.
Path parameters
idstringRequiredReturns
200 OK
afterobjectRequired15 child attributes
allocated_minorintegerRequiredallowed_actionsarray of stringsOptionalnet_recovery_minorintegerRequirednetwork_case_referencestringOptionalnetwork_effective_atstring · date-timeOptionalnetwork_sequenceintegerRequiredoutcomestringOptionalpayable_minorintegerRequiredpending_instruction_idstringOptionalpending_instruction_sha256stringOptionalreceivable_minorintegerRequiredrespond_bystring · date-timeOptionalsettled_cash_minorintegerRequiredstagestringRequiredunallocated_recovery_minorintegerRequiredbeforeobjectRequired15 child attributes
allocated_minorintegerRequiredallowed_actionsarray of stringsOptionalnet_recovery_minorintegerRequirednetwork_case_referencestringOptionalnetwork_effective_atstring · date-timeOptionalnetwork_sequenceintegerRequiredoutcomestringOptionalpayable_minorintegerRequiredpending_instruction_idstringOptionalpending_instruction_sha256stringOptionalreceivable_minorintegerRequiredrespond_bystring · date-timeOptionalsettled_cash_minorintegerRequiredstagestringRequiredunallocated_recovery_minorintegerRequiredcase_idstringRequiredExample case_2tVh8nqLxq4GbDe0K1F6S9zRcWm
content_sha256stringRequiredcreated_atstring · date-timeRequiredidstringRequiredlossobject or nullOptionalFinalCardDisputeLoss is a source observation, not a reservation or a customer credit instruction. A recovery consumer must permanently claim the actual loss journal before allocating any network recovery against it.
14 child attributes
account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
action_idstringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
dispute_idstringRequiredexpense_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
expense_minorintegerRequiredloss_journalobjectRequired18 child attributes
adjusts_periodstringOptionalA sealed period this journal corrects, YYYY-MM
approved_bystringOptionalbackdatedbooleanOptionalEffective_date is before posting_date (read only)
committed_atstring · date-timeOptionaleffective_datestring · dateRequiredA business date, YYYY-MM-DD
entriesarray of objectsRequired4 child attributes
amountintegerRequiredMinor units of the currency (cents for USD)
currency_codestringRequiredISO 4217 code
directionstringRequiredledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
fx_legsarray of objectsOptionalFXLegs is read only: the legs of a cross-currency journal the ledger's own conversion and close commands posted. A caller's posting never carries them.
7 child attributes
currency_codestringRequiredequivalent_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
native_amountintegerRequiredposition_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
rate_sheet_idstringRequiredusd_equivalent_amountintegerRequiredusd_per_foreign_majorstringRequiredidstringOptionalkindstringRequiredposted_bystringOptionalposting_datestring · dateOptionalA business date, YYYY-MM-DD
protected_command_idstringOptionalreasonstringOptionalRequired on a backdated journal
release_hold_idstringOptionalExample hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm
require_availablebooleanOptionalreversal_ofstringOptionalsource_refstringRequiredsource_servicestringRequiredloss_journal_keystringRequiredobserved_atstring · date-timeRequiredoriginal_journalobjectRequired18 child attributes
adjusts_periodstringOptionalA sealed period this journal corrects, YYYY-MM
approved_bystringOptionalbackdatedbooleanOptionalEffective_date is before posting_date (read only)
committed_atstring · date-timeOptionaleffective_datestring · dateRequiredA business date, YYYY-MM-DD
entriesarray of objectsRequired4 child attributes
amountintegerRequiredMinor units of the currency (cents for USD)
currency_codestringRequiredISO 4217 code
directionstringRequiredledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
fx_legsarray of objectsOptionalFXLegs is read only: the legs of a cross-currency journal the ledger's own conversion and close commands posted. A caller's posting never carries them.
7 child attributes
currency_codestringRequiredequivalent_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
native_amountintegerRequiredposition_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
rate_sheet_idstringRequiredusd_equivalent_amountintegerRequiredusd_per_foreign_majorstringRequiredidstringOptionalkindstringRequiredposted_bystringOptionalposting_datestring · dateOptionalA business date, YYYY-MM-DD
protected_command_idstringOptionalreasonstringOptionalRequired on a backdated journal
release_hold_idstringOptionalExample hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm
require_availablebooleanOptionalreversal_ofstringOptionalsource_refstringRequiredsource_servicestringRequiredoriginal_journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
original_journal_keystringRequiredprincipal_minorintegerRequiredsource_sha256stringRequiredordinalintegerRequiredpostingobject or nullOptional3 child attributes
created_atstring · date-timeRequiredjournalobjectRequired18 child attributes
adjusts_periodstringOptionalA sealed period this journal corrects, YYYY-MM
approved_bystringOptionalbackdatedbooleanOptionalEffective_date is before posting_date (read only)
committed_atstring · date-timeOptionaleffective_datestring · dateRequiredA business date, YYYY-MM-DD
entriesarray of objectsRequired4 child attributes
amountintegerRequiredMinor units of the currency (cents for USD)
currency_codestringRequiredISO 4217 code
directionstringRequiredledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
fx_legsarray of objectsOptionalFXLegs is read only: the legs of a cross-currency journal the ledger's own conversion and close commands posted. A caller's posting never carries them.
7 child attributes
currency_codestringRequiredequivalent_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
native_amountintegerRequiredposition_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
rate_sheet_idstringRequiredusd_equivalent_amountintegerRequiredusd_per_foreign_majorstringRequiredidstringOptionalkindstringRequiredposted_bystringOptionalposting_datestring · dateOptionalA business date, YYYY-MM-DD
protected_command_idstringOptionalreasonstringOptionalRequired on a backdated journal
release_hold_idstringOptionalExample hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm
require_availablebooleanOptionalreversal_ofstringOptionalsource_refstringRequiredsource_servicestringRequiredjournal_sha256stringRequiredproposed_bystringRequiredrequestobjectRequired8 child attributes
amount_minorintegerOptionaldispute_action_idstringOptionaldispute_idstringOptionalevidencearray of objectsOptional2 child attributes
referencestringRequiredsha256stringRequiredexpected_sequenceintegerRequiredkindstringRequiredoperationstringOptionalreceiptobject or nullOptional2 child attributes
payloadobjectRequiredSigningBytes is normative. The processor signs actual facts from its network adapter; current issued_at attests an independently retained effective_at.
27 child attributes
acknowledged_instruction_idstringOptionalacknowledged_instruction_sha256stringOptionalallowed_actionsarray of stringsOptionalamount_minorintegerRequiredEligibility amount or signed actual movement
authorization_idstringRequiredExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
case_idstringOptionalExample case_2tVh8nqLxq4GbDe0K1F6S9zRcWm
case_sha256stringOptionalcurrencystringRequiredeffective_atstring · date-timeRequiredevidenceobjectRequiredissued_atstring · date-timeRequiredkey_idstringRequiredkindstringRequiredEligibility, network, cash
networkstringRequirednetwork_case_referencestringOptionaloriginal_journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
outcomestringOptionalreason_codestringOptionalreceipt_referencestringRequiredrespond_bystring · date-timeOptionalrules_evidenceobjectRequiredrules_versionstringRequiredsequenceintegerRequiredsettlement_referencestringOptionalstagestringOptionalsubmit_bystring · date-timeOptionalversionstringRequiredsignaturestringRequiredresultobject or nullOptional8 child attributes
claimobject or nullOptional25 child attributes
actorstringRequiredassessment_idstringOptionalExample cpas_2tVh8nqLxq4GbDe0K1F6S9zRcWm
complaint_idstringOptionalExample cmpl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
content_sha256stringRequiredcreated_atstring · date-timeRequiredexecution_sha256stringOptionalinstruction_sha256stringOptionalinvestment_distribution_idstringOptionalinvestment_order_idstringOptionaljournal_sha256stringOptionaljournalsarray of objectsRequired2 child attributes
journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
keystringRequiredplacement_idstringOptionalproposed_bystringRequiredreceipt_sha256stringOptionalreconciliation_idstringOptionalredemption_idstringOptionalredemption_request_sha256stringOptionalredemption_requested_bystringOptionalreviewed_bystringRequiredscheme_action_idstringOptionalscheme_amount_minorintegerOptionalSigned network/cash movement; positive loss/allocation
scheme_case_idstringOptionalExample case_2tVh8nqLxq4GbDe0K1F6S9zRcWm
scheme_claim_kindstringOptionalNetwork, cash, loss or allocation
scheme_dispute_idstringOptionalscheme_loss_action_idstringOptionalcompleted_atstring · date-timeRequireddispositionstringRequiredinstruction_sha256stringOptionaljournalobject or nullOptional18 child attributes
adjusts_periodstringOptionalA sealed period this journal corrects, YYYY-MM
approved_bystringOptionalbackdatedbooleanOptionalEffective_date is before posting_date (read only)
committed_atstring · date-timeOptionaleffective_datestring · dateRequiredA business date, YYYY-MM-DD
entriesarray of objectsRequired4 child attributes
amountintegerRequiredMinor units of the currency (cents for USD)
currency_codestringRequiredISO 4217 code
directionstringRequiredledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
fx_legsarray of objectsOptionalFXLegs is read only: the legs of a cross-currency journal the ledger's own conversion and close commands posted. A caller's posting never carries them.
7 child attributes
currency_codestringRequiredequivalent_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
native_amountintegerRequiredposition_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
rate_sheet_idstringRequiredusd_equivalent_amountintegerRequiredusd_per_foreign_majorstringRequiredidstringOptionalkindstringRequiredposted_bystringOptionalposting_datestring · dateOptionalA business date, YYYY-MM-DD
protected_command_idstringOptionalreasonstringOptionalRequired on a backdated journal
release_hold_idstringOptionalExample hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm
require_availablebooleanOptionalreversal_ofstringOptionalsource_refstringRequiredsource_servicestringRequiredjournal_keystringOptionalstateobjectRequired15 child attributes
allocated_minorintegerRequiredallowed_actionsarray of stringsOptionalnet_recovery_minorintegerRequirednetwork_case_referencestringOptionalnetwork_effective_atstring · date-timeOptionalnetwork_sequenceintegerRequiredoutcomestringOptionalpayable_minorintegerRequiredpending_instruction_idstringOptionalpending_instruction_sha256stringOptionalreceivable_minorintegerRequiredrespond_bystring · date-timeOptionalsettled_cash_minorintegerRequiredstagestringRequiredunallocated_recovery_minorintegerRequiredunallocated_loss_minorintegerOptionalreviewobject or nullOptional5 child attributes
actorstringRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddecisionstringRequiredreasonstringRequiredverified_receiptobject or nullOptional4 child attributes
config_sha256stringRequiredkeyobjectRequired5 child attributes
idstringRequirednetworkstringRequiredpublic_keystringRequiredvalid_fromstring · date-timeRequiredvalid_throughstring · date-timeRequiredreceiptobjectRequired2 child attributes
payloadobjectRequiredSigningBytes is normative. The processor signs actual facts from its network adapter; current issued_at attests an independently retained effective_at.
27 child attributes
acknowledged_instruction_idstringOptionalacknowledged_instruction_sha256stringOptionalallowed_actionsarray of stringsOptionalamount_minorintegerRequiredEligibility amount or signed actual movement
authorization_idstringRequiredExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
case_idstringOptionalExample case_2tVh8nqLxq4GbDe0K1F6S9zRcWm
case_sha256stringOptionalcurrencystringRequiredeffective_atstring · date-timeRequiredevidenceobjectRequiredissued_atstring · date-timeRequiredkey_idstringRequiredkindstringRequiredEligibility, network, cash
networkstringRequirednetwork_case_referencestringOptionaloriginal_journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
outcomestringOptionalreason_codestringOptionalreceipt_referencestringRequiredrespond_bystring · date-timeOptionalrules_evidenceobjectRequiredrules_versionstringRequiredsequenceintegerRequiredsettlement_referencestringOptionalstagestringOptionalsubmit_bystring · date-timeOptionalversionstringRequiredsignaturestringRequiredreceived_atstring · date-timeRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503