- Authorization
- Orders
- Payments
- Invoices
- Subscriptions
- Payouts
- Webhooks
- Shipment Tracking
- Transaction Search
- Disputes
- List disputesGET
- Show dispute detailsGET
- Accept claimPOST
- Appeal disputePOST
- Settle disputePOST
- Update dispute statusPOST
- Make offer to resolve disputePOST
- Provide evidencePOST
- Acknowledge returned itemPOST
- Provide supporting information for disputePOST
- Escalate dispute to claimPOST
- Accept offer to resolve disputePOST
- Send message about dispute to other partyPOST
- Deny offer to resolve disputePOST
- Partially update disputePATCH
- Onboarding (Limited Release)
Show dispute details
GET
/v1/customer/disputes/{dispute_id}
Note: The fields that appear in the response depend on whether you access this call through first- or third-party access. For example, if the merchant shows dispute details through third-party access, the customer's email ID does not appear.
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Path 参数
dispute_id
string
必需
示例值:
{{dispute_id}}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api-m.sandbox.paypal.com/v1/customer/disputes/{{dispute_id}}' \
--header 'Authorization: Basic Og=='
返回响应
🟢200200 - Show Dispute Details
application/json
Body
dispute_id
string
必需
create_time
string
必需
update_time
string
必需
disputed_transactions
array [object {11}]
必需
buyer_transaction_id
string
可选
seller_transaction_id
string
可选
create_time
string
可选
transaction_status
string
可选
gross_amount
object
可选
buyer
object
可选
seller
object
可选
items
array [object {5}]
可选
seller_protection_eligible
boolean
可选
regulation_info
object
可选
provisional_credit_status
string
可选
reason
string
必需
status
string
必需
dispute_amount
object
必需
currency_code
string
必需
value
string
必需
dispute_state
string
必需
fee_policy
object
必需
transaction_fee
string
必需
dispute_outcome
object
必需
outcome_code
string
必需
amount_refunded
object
必需
money_movements
array [object {5}]
必需
affected_party
string
必需
amount
object
必需
initiated_time
string
必需
type
string
必需
reason
string
必需
dispute_life_cycle_stage
string
必需
dispute_channel
string
必需
messages
array [object {3}]
必需
posted_by
string
可选
time_posted
string
可选
content
string
可选
extensions
object
必需
merchant_contacted
boolean
必需
merchant_contacted_outcome
string
必需
buyer_contacted_time
string
必需
buyer_contacted_channel
string
必需
evidences
array [object {6}]
必需
evidence_type
string
必需
notes
string
必需
source
string
必需
date
string
必需
dispute_life_cycle_stage
string
必需
action_info
object
可选
history
array [object {4}]
必需
date
string
必需
actor
string
必需
event_type
string
必需
dispute_life_cycle_stage
string
必需
offer
object
必需
buyer_requested_amount
object
必需
seller_offered_amount
object
必需
offer_type
string
必需
history
array [object {5}]
必需
refund_details
object
必需
allowed_refund_amount
object
必需
links
array [object {3}]
必需
href
string
可选
rel
string
可选
method
string
可选
示例
{
"dispute_id": "PP-R-GSS-10059837",
"create_time": "2023-03-27T09:06:12.409Z",
"update_time": "2023-03-29T17:45:30.974Z",
"disputed_transactions": [
{
"buyer_transaction_id": "4DV78168SM660625N",
"seller_transaction_id": "47987518DF175504N",
"create_time": "2023-03-27T09:00:52.000Z",
"transaction_status": "REFUNDED",
"gross_amount": {
"currency_code": "EUR",
"value": "10.00"
},
"buyer": {
"email": "pp-personal01@otto-payments.de",
"name": "John Doe"
},
"seller": {
"email": "john_merchant@example.com",
"merchant_id": "C7CYMKZDG8D6E",
"name": "John Merchant's Test Store"
},
"items": [
{
"item_name": "T-Shirt",
"item_description": "T-Shirt",
"item_quantity": "1",
"reason": "MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED",
"item_type": "PRODUCT"
}
],
"seller_protection_eligible": false,
"regulation_info": {
"regulation_covered": "PPBP"
},
"provisional_credit_status": "NOT_APPLICABLE"
}
],
"reason": "MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED",
"status": "RESOLVED",
"dispute_amount": {
"currency_code": "EUR",
"value": "10.00"
},
"dispute_state": "RESOLVED",
"fee_policy": {
"transaction_fee": "RETAIN_ALL_FEE"
},
"dispute_outcome": {
"outcome_code": "RESOLVED_BUYER_FAVOUR",
"amount_refunded": {
"currency_code": "EUR",
"value": "10.00"
}
},
"money_movements": [
{
"affected_party": "BUYER",
"amount": {
"currency_code": "EUR",
"value": "10.00"
},
"initiated_time": "2023-03-29T17:42:21.219Z",
"type": "CREDIT",
"reason": "DISPUTE_SETTLEMENT"
},
{
"affected_party": "SELLER",
"amount": {
"currency_code": "EUR",
"value": "10.00"
},
"initiated_time": "2023-03-29T17:42:21.219Z",
"type": "DEBIT",
"reason": "DISPUTE_SETTLEMENT"
}
],
"dispute_life_cycle_stage": "CHARGEBACK",
"dispute_channel": "INTERNAL",
"messages": [
{
"posted_by": "SELLER",
"time_posted": "2023-03-27T10:21:24.228Z",
"content": "Full refund to the customer."
}
],
"extensions": {
"merchant_contacted": true,
"merchant_contacted_outcome": "NO_RESPONSE",
"buyer_contacted_time": "2023-03-27T10:34:52.293Z",
"buyer_contacted_channel": "RESOLUTION_CENTER"
},
"evidences": [
{
"evidence_type": "CREATE",
"notes": "war nicht schön",
"source": "SUBMITTED_BY_BUYER",
"date": "2023-03-27T09:06:12.409Z",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"evidence_type": "OTHER",
"notes": "Full refund to the customer.",
"source": "SUBMITTED_BY_SELLER",
"date": "2023-03-29T17:42:21.219Z",
"action_info": {
"action": "ACCEPT_CLAIM",
"response_option": "REFUND"
},
"dispute_life_cycle_stage": "CHARGEBACK"
}
],
"history": [
{
"date": "2023-03-27T09:06:12.409Z",
"actor": "BUYER",
"event_type": "CREATED",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T09:07:38.283Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T09:08:12.330Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T09:16:33.552Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T09:18:15.332Z",
"actor": "PAYPAL",
"event_type": "WAITING_FOR_SELLER_RESPONSE",
"dispute_life_cycle_stage": "INQUIRY"
},
{
"date": "2023-03-27T09:19:33.588Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_BUYER"
},
{
"date": "2023-03-27T09:19:33.588Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_SELLER"
},
{
"date": "2023-03-27T10:21:24.228Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "INQUIRY"
},
{
"date": "2023-03-27T10:21:24.810Z",
"actor": "PAYPAL",
"event_type": "WAITING_FOR_BUYER_RESPONSE",
"dispute_life_cycle_stage": "INQUIRY"
},
{
"date": "2023-03-27T10:24:04.191Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_SELLER"
},
{
"date": "2023-03-27T10:24:04.386Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_BUYER"
},
{
"date": "2023-03-27T10:34:52.841Z",
"actor": "BUYER",
"event_type": "CREATED",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:34:52.841Z",
"actor": "BUYER",
"event_type": "REASON_CHANGED",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:36:03.432Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_BUYER"
},
{
"date": "2023-03-27T10:36:19.052Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:36:52.847Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:45:56.358Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:47:38.940Z",
"actor": "PAYPAL",
"event_type": "WAITING_FOR_SELLER_RESPONSE",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-27T10:49:03.642Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_SELLER"
},
{
"date": "2023-03-29T17:42:21.219Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-29T17:42:21.219Z",
"actor": "SELLER",
"event_type": "ACCEPTED_CLAIM",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-29T17:42:39.451Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-29T17:43:34.234Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_SELLER"
},
{
"date": "2023-03-29T17:44:03.843Z",
"actor": "PAYPAL",
"event_type": "UNDER_REVIEW",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-29T17:45:30.974Z",
"actor": "PAYPAL",
"event_type": "RESOLVED",
"dispute_life_cycle_stage": "CHARGEBACK"
},
{
"date": "2023-03-29T17:45:34.459Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_SELLER"
},
{
"date": "2023-03-29T17:47:03.728Z",
"actor": "PAYPAL",
"event_type": "EMAIL_SENT_TO_BUYER"
}
],
"offer": {
"buyer_requested_amount": {
"currency_code": "EUR",
"value": "10.00"
},
"seller_offered_amount": {
"currency_code": "EUR",
"value": "3.00"
},
"offer_type": "REFUND",
"history": [
{
"offer_time": "2023-03-27T10:21:24.228Z",
"actor": "SELLER",
"event_type": "PROPOSED",
"offer_type": "REFUND",
"offer_amount": {
"currency_code": "EUR",
"value": "3.00"
}
}
]
},
"refund_details": {
"allowed_refund_amount": {
"currency_code": "EUR",
"value": "10.00"
}
},
"links": [
{
"href": "https://api-m.sandbox.paypal.com/v1/customer/disputes/PP-R-GSS-10059837",
"rel": "self",
"method": "GET"
}
]
}
🟠401401 Unauthorized - Invalid Token
🟠403403 Forbidden - Insufficient Permissions
🟠404404 Not Found - Dispute Not Found