Update dispute status

POST

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

Important: This method is for sandbox use only.

Updates the status of a dispute, by ID, from UNDER_REVIEW to either:

WAITING_FOR_BUYER_RESPONSE
WAITING_FOR_SELLER_RESPONSE

This status change enables either the customer or merchant to submit evidence for the dispute. To make this call, the dispute status must be UNDER_REVIEW. Specify an action value in the JSON request body to indicate whether the status change enables the customer or merchant to submit evidence:

If `action` is	The `status` updates to
`BUYER_EVIDENCE`	`WAITING_FOR_BUYER_RESPONSE`
`SELLER_EVIDENCE`	`WAITING_FOR_SELLER_RESPONSE`

请求参数

Authorization

在 Header 添加参数

Authorization

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

示例：

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

Path 参数

Body 参数application/json

示例

{
    "action": "BUYER_EVIDENCE"
}

请求示例代码

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}}/require-evidence' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "BUYER_EVIDENCE"
}'

返回响应

🟠400400 Bad Request - Action Not Allowed In Current Dispute State

application/json

Body

示例

{
    "name": "INVALID_REQUEST",
    "message": "Request is not well-formed, syntactically incorrect, or violates schema.",
    "debug_id": "68732bcbfadc7",
    "information_link": "https://developer.paypal.com/docs/api/customer-disputes/v1/#errors",
    "details": [
        {
            "issue": "ACTION_NOT_ALLOWED_IN_CURRENT_DISPUTE_STATE"
        }
    ],
    "links": []
}

🟠401401 Unauthorized - Invalid Token

🟠403403 Forbidden - Insufficient Permissions

🟠404404 Not Found - Dispute Not Found

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

Settle dispute

Make offer to resolve dispute