Create dispute evidence file

POST /v2/disputes/{dispute_id}/evidence-files

Uploads a file to use as evidence in a dispute challenge.

Open in API Reference

Access Tokens Sign in to populate your access tokens from the Developer Console Sign In

Parameters

dispute_id

The ID of the dispute for which you want to upload evidence.

string

Body

file

File to upload for this request.

binary

Select a file

idempotency_key

A unique key identifying the request. For more information, see Idempotency.

Min Length 1 Max Length 45

string

content_type

The MIME type of the uploaded file. The type can be image/heic, image/heif, image/jpeg, application/pdf, image/png, or image/tiff.

Min Length 1 Max Length 40

string

evidence_type

The type of evidence you are uploading.

string

Select evidence_type

GENERIC_EVIDENCE Square assumes this evidence type if you do not provide a type when uploading evidence. Use when uploading evidence as a file or string.
ONLINE_OR_APP_ACCESS_LOG Server or activity logs that show proof of the cardholders identity and that the cardholder successfully ordered and received the goods digitally or otherwise. Example evidence includes IP addresses, corresponding timestampsdates, cardholders name and email address linked to a cardholder profile held by the seller, proof the same device and card used in dispute were previously used in prior undisputed transaction, and any related detailed activity. Use when uploading evidence as a file or string.
AUTHORIZATION_DOCUMENTATION Evidence that the cardholder did provide authorization for the charge. Example evidence includes a signed credit card authorization. Use when uploading evidence as a file.
CANCELLATION_OR_REFUND_DOCUMENTATION Evidence that the cardholder acknowledged your refund or cancellation policy. Example evidence includes a signature or checkbox showing the cardholders acknowledgement of your refund or cancellation policy. Use when uploading evidence as a file or string.
CARDHOLDER_COMMUNICATION Evidence that shows relevant communication with the cardholder. Example evidence includes emails or texts that show the cardholder received goodsservices or demonstrate cardholder satisfaction. Use when uploading evidence as a file.
CARDHOLDER_INFORMATION Evidence that validates the customer's identity. Example evidence includes personally identifiable details such as name, email address, purchaser IP address, and a copy of the cardholder ID. Use when uploading evidence as a file or string.
PURCHASE_ACKNOWLEDGEMENT Evidence that shows proof of the saletransaction. Example evidence includes an invoice, contract, or other item showing the customers acknowledgement of the purchase and your terms. Use when uploading evidence as a file or string.
DUPLICATE_CHARGE_DOCUMENTATION Evidence that shows the charges in question are valid and distinct from one another. Example evidence includes receipts, shipping labels, and invoices along with their distinct payment IDs. Use when uploading evidence as a file.
PRODUCT_OR_SERVICE_DESCRIPTION A description of the product or service sold. Use when uploading evidence as a file or string.
RECEIPT A receipt or message sent to the cardholder detailing the charge. Note: You do not need to upload the Square receipt Square submits the receipt on your behalf. Use when uploading evidence as a file or string.
SERVICE_RECEIVED_DOCUMENTATION Evidence that the service was provided to the cardholder or the expected date that services will be rendered. Example evidence includes a signed delivery form, work order, expected delivery date, or other written agreements. Use when uploading evidence as a file or string.
PROOF_OF_DELIVERY_DOCUMENTATION Evidence that shows the product was provided to the cardholder or the expected date of delivery. Example evidence includes a signed delivery form or written agreement acknowledging receipt of the goods or services. Use when uploading evidence as a file or string.
RELATED_TRANSACTION_DOCUMENTATION Evidence that shows the cardholder previously processed transactions on the same card and did not dispute them. Note: Square automatically provides up to five distinct Square receipts for related transactions, when available. Use when uploading evidence as a file or string.
REBUTTAL_EXPLANATION An explanation of why the cardholders claim is invalid. Example evidence includes an explanation of why each distinct charge is a legitimate purchase, why the cardholders claim for credit owed due to their attempt to cancel, return, or refund is invalid per your stated policy and cardholder agreement, or an explanation of how the cardholder did not attempt to remedy the issue with you first to receive credit. Use when uploading evidence as a file or string.
TRACKING_NUMBER The tracking number for the order provided by the shipping carrier. If you have multiple numbers, they need to be submitted individually as separate pieces of evidence. Use when uploading evidence as a string.

You are viewing an old version of the API

All Versions

Request

cURL

Ruby

Python

Java

PHP

Node.js

Response

// No response received yet.

Thanks for the feedback. For more help, check out our support resources.

Developer Support Developer Forums

There was an error submitting feedback. Try again later.

Developer Support Developer Forums