Screenshot upload guide

In chargeback representation, providing visual evidence is crucial. This guide will walk you through the process of uploading screenshots to the files-API, ensuring they are accurately linked to your chargeback cases.

Endpoint URL

Upload your screenshot to the following endpoint:

https://api.justt.ai/v1/files

Parameters to provide

Headers

• Authorization: see authentication documentation
• Content-Type: multipart/form-data

Body

• purpose: evidence_image
• metadata: JSON object with the following keys:
  • internalId: Justt chargeback ID.
  • tag: a UUID that identifies the screenshot type that you wish to append the image to (eg. checkout screen, customer invoice).

File

file: The screenshot image file in a supported format (PNG, JPEG). Ensure the file size does not exceed the maximum limit of 6MB.

Example Request

POST /v1/files HTTP/1.1
Host: api.justt.ai
Authorization: Bearer your_token_here
Content-Type: multipart/form-data

purpose: ״evidence_image״
metadata: {
   "internalId": "abcde",
   "tag": "uuid-1234-5678"
}
file: <file_binary_data> 

Response Handling

Upon successful upload, the API will return a response with the file ID. Handle this response to verify the upload and associate the file ID with your chargeback records.

Successful Response

{
  "fileId": "1234567890",
 }

Error Response

If an error occurs, the response will contain an error message and code. Common errors include invalid parameters, authentication failures, or exceeding file size limits. See error handling documentation.