Create dispute case content - Marqeta Docs

POST///

Upload and store evidentiary documents related to a dispute. The supported document formats are pdf, tiff, jpeg, and zip. A zip file must contain a pdf, tiff, or jpeg file. Each uploaded file is restricted to 2 MB.

URL path parameter

Fields	Description
token string Required	The token that identifies the dispute case. Send a `GET` request to `/cases` to retrieve dispute case tokens. Allowable Values: 36 char max

Request body

Fields	Description
document_category string Required	The category of the document. Allowable Values: `AFFIDAVIT_FRAUD`, `AUTHORIZATION_RECORD`, `BANK_STATEMENT`, `CANCELLED_CHECK`, `CARDHOLDER_LETTER`, `CREDIT_VOUCHER`, `FULFILLMENT`, `ISSUER_CERTIFICATION`, `MERCHANT_LETTER`, `NETWORK_DOCUMENT`, `NETWORK_EXHIBIT`, `OTHERS`, `RECEIPT`, `SALES_DRAFT`, `SECOND_OPTION`, `UPDATED_CARDHOLDER_LETTER`, `UPDATED_MERCHANT_LETTER`
document_name string Required	The name for the document. Must include the file extension, as appropriate for a supported file format: pdf, tiff, or jpeg. Allowable Values: 255 char max
document_data binary Required	Base64-encoded file. Allowable Values: 2 MB max size

Create content response body

Fields	Description
token string Returned	The token identifying the document. Allowable Values: 36 char max
case_token string Returned	The token identifying the dispute case you want to upload documents against. Allowable Values: 36 char max
document_name string Returned	The name of the document. Allowable Values: 255 char max
document_category string Returned	The type of document. Allowable Values: `AFFIDAVIT_FRAUD`, `AUTHORIZATION_RECORD`, `BANK_STATEMENT`, `CANCELLED_CHECK`, `CARDHOLDER_LETTER`, `CREDIT_VOUCHER`, `FULFILLMENT`, `ISSUER_CERTIFICATION`, `MERCHANT_LETTER`, `NETWORK_DOCUMENT`, `NETWORK_EXHIBIT`, `OTHERS`, `RECEIPT`, `SALES_DRAFT`, `SECOND_OPTION`, `UPDATED_CARDHOLDER_LETTER`, `UPDATED_MERCHANT_LETTER`
document_content_type string Returned	The content type of the document. Allowable Values: `application/pdf`, `image/tiff`, `image/jpeg`
network_processing_type string Returned	Indicates the current status of the document at the network: `SUBMITTED` – Indicates it has been submitted to the network using the Dispute Case Transition or Network Dispute Transition endpoint. `RECEIVED` – Indicates that the document has been downloaded from the network, which occurs when the acquirer uploaded a document to support their claim. Allowable Values: `SUBMITTED`, `RECEIVED`
network_processing_phase string Returned	Indicates the status of the document in the dispute lifecycle. Allowable Values: `INITIATED`, `REPRESENTMENT`, `PRE_ARBITRATION`
network_processing_time datetime Returned	The date and time when the document has either been submitted by the user or received from the network. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
created_time datetime Returned	The date and time when the dispute was created. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
updated_time datetime Returned	The date and time when the dispute was last modified. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
download_link string Returned	The link to download the file if it is included in the request. This only applies to the `GET` case content by token endpoint. Allowable Values: A valid URI.

Sample request body

JSON

Content-Type: multipart/form-data; boundary=marqeta_file_separator
Cache-Control: no-cache

--marqeta_file_separator
Content-Type: application/json; Content-Disposition: form-data; name="body"

{
  "document_category": "RECEIPT",
  "document_name": "receipt.pdf",
  "document_data": "string"
}

--marqeta_file_separator
Content-Type: image/jpeg; Content-Disposition: form-data; name="file"

file=@/Users/username/Downloads/online-receipt-location.jpg

--marqeta_file_separator--

Sample response body

JSON

{
  "token": "my_content_token",
  "case_token": "my_case_token",
  "document_name": "string",
  "document_category": "RECEIPT",
  "document_content_type": "application/pdf",
  "network_processing_type": "SUBMITTED",
  "network_processing_phase": "INITIATED",
  "network_processing_time": "2024-02-01T20:22:34.913Z",
  "created_time": "2024-02-01T20:22:34.913Z",
  "updated_time": "2024-02-01T20:22:34.913Z",
  "download_link": "download_link"
}