Skip to main content

POST/payment_dispute/{payment_dispute_id}/upload_evidence_file

This method is used to upload an evidence file for a contested payment dispute. The unique identifier of the payment dispute is passed in as a path parameter, and unique identifiers for payment disputes can be retrieved with the getPaymentDisputeSummaries method.

Note: The uploadEvidenceFile only uploads an encrypted, binary image file (using multipart/form-data HTTP request header), and does not have a JSON-based request payload.

Use 'file' as the name of the key that you use to upload the image file. The upload will not be successful if a different key name is used.

The three image formats supported at this time are .JPEG, .JPG, and .PNG.


After the file is successfully uploaded, the seller will need to grab the fileId value in the response payload to add this file to a new evidence set using the addEvidence method, or to add this file to an existing evidence set using the updateEvidence method.

Input

Resource URI

POST https://apiz.ebay.com/sell/fulfillment/v1/payment_dispute/{payment_dispute_id}/upload_evidence_file

This method is supported in Sandbox environment. To access the endpoint, just replace the apiz.ebay.com root URI with apiz.sandbox.ebay.com

URI parameters

ParameterTypeDescription
payment_dispute_idstringThis parameter is used to specify the unique identifier of the contested payment dispute for which the user intends to upload an evidence file.

Use the getPaymentDisputeSummaries method to retrieve payment dispute IDs.

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.

HeaderTypeDescription
Content-TypestringThis header indicates the format of the request body provided by the client. Its value should be set to multipart/form-data.

For more information, refer to HTTP request headers.

Occurrence: Required

OAuth scope

This request requires an access token created with the client credentials grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.payment.dispute

See OAuth access tokens for more information.

Request payload

Note: The uploadEvidenceFile only uploads an encrypted, binary image file (using multipart/form-data HTTP request header), and does not have a JSON-based request payload.

Use 'file' as the name of the key that you use to upload the image file. The upload will not be successful if a different key name is used.

The three image formats supported at this time are .JPEG, .JPG, and .PNG.


Once the file is successfully uploaded, the seller will need to grab the fileId value in the response payload to add this file to a new evidence set using the addEvidence method, or to add this file to an existing evidence set using the updateEvidence method.

This call has no payload.

Request fields

This call has no field definitions.

Output

HTTP response headers

This call has no response headers.

Response payload

{ /* FileEvidence */ }

Response fields

Output container/fieldTypeDescription
fileIdstring

This field is used to identify the evidence file to be uploaded to the evidence set.

This file is created with the uploadEvidenceFile method and can be retrieved using the getPaymentDisputes method.

Occurrence: Always

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
200Success
400Bad Request
404Not Found
409Conflict
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
33000API_FULFILLMENTAPPLICATIONThere was a problem with an eBay internal system or process. Contact eBay developer support for assistance.
33001API_FULFILLMENTREQUESTInvalid Payment Dispute Id
33004API_FULFILLMENTREQUESTUpload file for evidence is not permitted for given payment dispute state.
33005API_FULFILLMENTREQUESTFile type is invalid.
33006API_FULFILLMENTREQUESTFile size should be 1.5 MB or less.
33105API_FULFILLMENTREQUESTYou reached the maximum number of files you can upload.
33106API_FULFILLMENTREQUESTThe file name should not be empty and should not exceed 255 characters.
33107API_FULFILLMENTREQUESTOnly one file can be uploaded per request.

Warnings

This call has no warnings.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Upload an evidence file

The seller uploads an evidence file (in .JPG format) using multipart/form-data HTTP request header. The unique identifier of the payment dispute (to associate the file with) is passed in as a path parameter.

Input

There is no request payload. A .JPG file is uploaded using multipart/form-data HTTP request header.

POSThttps://apiz.ebay.com/sell/fulfillment/v1/payment_dispute/5********2/upload_evidence_file

Output

With a successful call, the response payload shows the unique identifier of the evidence file that was successfully uploaded. This file ID will be used when adding this file to a new or existing evidence set.