Independently review a clearing exception resolution
/cards/clearing/resolutions/{id}/reviewsVerified staff on the card clearing desk's narrow scopes only: cards:clearing:read for reads, cards:clearing:write with a step-up within five minutes for writes; cards:write does not reach these routes and no service token or API key does. The file formats are bank-defined approximations of the proprietary Visa BASE II, Mastercard IPM and Discover clearing specifications (services/cards/clearing/README.md); a file from the card clearing simulator is simulated, not network traffic. Requires cards:clearing:write, cards:clearing:approve and a step-up within five minutes; the reviewer differs from the maker and decides the exact content SHA-256. The same review by the same reviewer under the same key replays; a changed one is 422 idempotency_key_reused. An approval requires the exception still open with this proposal its latest.
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
content_sha256stringRequireddecisionstringRequiredreasonstringRequiredReturns
200 OK
amount_minorintegerRequiredcard_account_idstringOptionalExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
content_sha256stringRequiredcreated_atstring · date-timeRequireddirectionstringRequiredexception_idstringRequiredexception_kindstringRequiredidstringRequiredordinalintegerRequiredproposed_bystringRequiredrecord_sha256stringRequiredrequestobjectRequiredResolutionRequest proposes how an exception ends.
4 child attributes
actionstringRequiredcard_idstringOptionalPost: the card the record belongs to
Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm
evidencearray of objectsRequired2 child attributes
referencestringRequiredsha256stringRequiredreasonstringRequiredresultobject or nullOptionalResolutionResult is what applying a resolution did.
7 child attributes
actorstringRequiredauthorization_idstringOptionalExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
completed_atstring · date-timeRequireddetailstringOptionaljournal_idsarray of stringsRequiredoutcomestringRequiredPosted, returned, written_off, refused
returnobject or nullOptionalReturnReceipt is the network's acknowledgement of a return instruction. An acknowledgement is not the money: the later return credit or debit in a clearing file is.
3 child attributes
accepted_atstring · date-timeRequiredreferencestringRequiredsourcestringRequiredreviewobject or nullOptionalReview is a retained independent decision.
5 child attributes
actorstringRequiredcontent_sha256stringRequiredcreated_atstring · date-timeRequireddecisionstringRequiredreasonstringRequiredsettled_at_proposalbooleanRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503