Propose a source-bound card scheme dispute with signed eligibility evidence
/cards/schemes/casesVerified 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.
Headers
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
authorization_idstringRequiredExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
claim_minorintegerRequiredeligibilityobjectRequired2 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-timeRequiredevidenceobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredissued_atstring · date-timeRequiredkey_idstringRequiredkindstringRequiredEligibility, network, cash
networkstringRequirednetwork_case_referencestringOptionaloriginal_journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
outcomestringOptionalreason_codestringOptionalreceipt_referencestringRequiredrespond_bystring · date-timeOptionalrules_evidenceobjectRequired2 child attributes
referencestringRequiredsha256stringRequiredrules_versionstringRequiredsequenceintegerRequiredsettlement_referencestringOptionalstagestringOptionalsubmit_bystring · date-timeOptionalversionstringRequiredsignaturestringRequiredevidencearray of objectsRequired2 child attributes
referencestringRequiredsha256stringRequiredReturns
200 OK
activationobject or nullOptional4 child attributes
activated_atstring · date-timeRequiredinstruction_sha256stringRequiredpinobject or nullOptional13 child attributes
actorstringRequiredamount_minorintegerRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddebit_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
journalobjectRequired2 child attributes
journal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
keystringRequiredjournal_sha256stringRequiredproposed_bystringRequiredpurposestringRequiredreference_idstringRequiredreviewed_bystringRequiredsource_idstringRequiredsource_refstringRequiredstateobjectRequired15 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_minorintegerRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequiredeligibilityobjectRequired4 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-timeRequiredidstringRequiredproposed_bystringRequiredrequestobjectRequired4 child attributes
authorization_idstringRequiredExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
claim_minorintegerRequiredeligibilityobjectRequired2 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-timeOptionalversionstringRequiredsignaturestringRequiredevidencearray of objectsRequired2 child attributes
referencestringRequiredsha256stringRequiredreviewobject or nullOptional5 child attributes
actorstringRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddecisionstringRequiredreasonstringRequiredsourceobjectRequired12 child attributes
account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
amount_minorintegerRequiredcard_idstringRequiredExample card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
card_kindstringRequiredclearing_operation_keystringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
debit_ledger_account_idstringRequiredExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
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_servicestringRequiredjournal_keystringRequiredjournal_sha256stringRequirednetworkstringRequirednetwork_refstringRequiredstateobject or nullOptional15 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_minorintegerRequiredunclaimed_original_minorintegerRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503