Provide evidence

POST

/v1/customer/disputes/{dispute_id}/provide-evidence

Provides evidence for a dispute, by ID. A merchant can provide evidence for disputes with the WAITING_FOR_SELLER_RESPONSE status while customers can provide evidence for disputes with the WAITING_FOR_BUYER_RESPONSE status. Evidence can be a proof of delivery or proof of refund document or notes, which can include logs. A proof of delivery document includes a tracking number while a proof of refund document includes a refund ID. For other evidence type, notes and documents can be given. The following rules apply to document file types and sizes:

The merchant can upload up to 50 MB of files for a case.
Individual files must be smaller than 10 MB.
The supported file formats are JPG, GIF, PNG, and PDF.

To make this request, specify the dispute ID in the URI and specify the evidence in the JSON request body. For information about dispute reasons, see dispute reasons.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Path 参数

dispute_id

string

必需

示例值:

Header 参数

Content-Type

string

必需

示例值:

multipart/form-data

Body 参数multipart/form-data

evidence-file

file

必需

A file with evidence.

input

string

必需

示例值:

{"evidences":[{"evidence_type":"RECEIPT_OF_MERCHANDISE","evidence_info":{"tracking_info":[{"carrier_name":"FEDEX","tracking_number":"122533485"}]},"notes":"Test"}]}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://api-m.sandbox.paypal.com/v1/customer/disputes/{{dispute_id}}/provide-evidence' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Basic Og==' \
--form 'evidence-file=@""' \
--form 'input="{\"evidences\":[{\"evidence_type\":\"RECEIPT_OF_MERCHANDISE\",\"evidence_info\":{\"tracking_info\":[{\"carrier_name\":\"FEDEX\",\"tracking_number\":\"122533485\"}]},\"notes\":\"Test\"}]}"'

返回响应

🟢200200 - Provide Evidence

application/json

Body

links

array [object {3}]

必需

href

string

可选

rel

string

可选

method

string

可选

示例

{
  "links": [
    {
      "href": "https://api-m.sandbox.paypal.com/v1/customer/disputes/PP-R-EYZ-10065656",
      "rel": "detail",
      "method": "GET"
    }
  ]
}

🟠400400 Bad Request - Missing Or Invalid Request Body

🟠401401 Unauthorized - Invalid Token

修改于 2023-08-16 07:18:59

Make offer to resolve dispute

Acknowledge returned item