Paypal API
  1. Disputes
Paypal API
  • Authorization
    • Generate access_token
      POST
    • Terminate access_token
      POST
    • User Info
      GET
    • Generate client_token
      POST
  • Orders
    • Create order
      POST
    • Show order details
      GET
    • Update order
      PATCH
    • Authorize payment for order
      POST
    • Capture payment for order
      POST
  • Payments
    • Show details for authorized payment
      GET
    • Reauthorize authorized payment
      POST
    • Void authorized payment
      POST
    • Capture authorized payment
      POST
    • Show captured payment details
      GET
    • Refund captured payment
      POST
    • Show refund details
      GET
  • Invoices
    • Invoices
      • Generate invoice number
      • Create draft invoice
      • Show invoice details
      • List invoices
      • Generate QR code
      • Fully update invoice
      • Send invoice
      • Send invoice reminder
      • Cancel sent invoice
      • Delete invoice
      • Search for invoices
      • Record payment for invoice
      • Delete external payment
      • Record refund for invoice
      • Delete external refund
    • Templates
      • List templates
      • Create template
      • Show template details
      • Fully update template
      • Delete template
  • Subscriptions
    • Catalog Products
      • Create product
      • List products
      • Show product details
      • Update product
    • Plans
      • Create plan
      • List plans
      • Show plan details
      • Update plan
      • Deactivate plan
      • Activate plan
      • Update pricing
    • Subscriptions
      • Create subscription
      • Show subscription details
      • Update subscription
      • Revise plan or quantity of subscription
      • Suspend subscription
      • Activate subscription
      • Cancel subscription
      • Capture authorized payment on subscription
      • List transactions for subscription
  • Payouts
    • Create batch payout
    • Show payout batch details
    • Show payout item details
    • Cancel unclaimed payout item
  • Webhooks
    • List available events
    • Create webhook
    • List webhooks
    • Show webhook details
    • List event notifications
    • List event subscriptions for webhook
    • Show event notification details
    • Trigger a sample event
    • Verify webhook signature
    • Resend event notification
    • Simulate webhook event
    • Update webhook
    • Delete webhook
  • Shipment Tracking
    • Add tracking information for multiple PayPal transactions
    • Show tracking information
    • Update or cancel tracking information for PayPal transaction
  • Transaction Search
    • List transactions
    • List all balances
  • Disputes
    • List disputes
      GET
    • Show dispute details
      GET
    • Accept claim
      POST
    • Appeal dispute
      POST
    • Settle dispute
      POST
    • Update dispute status
      POST
    • Make offer to resolve dispute
      POST
    • Provide evidence
      POST
    • Acknowledge returned item
      POST
    • Provide supporting information for dispute
      POST
    • Escalate dispute to claim
      POST
    • Accept offer to resolve dispute
      POST
    • Send message about dispute to other party
      POST
    • Deny offer to resolve dispute
      POST
    • Partially update dispute
      PATCH
  • Onboarding (Limited Release)
    • Manage Accounts
      • Create managed account
      • Search managed account through external id
      • Search managed account by Seller Id
      • Partially updates information for a managed account
      • Shows collection of registered wallet domains
  1. Disputes

Show dispute details

GET
/v1/customer/disputes/{dispute_id}
Shows details for a dispute, by 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
上一页
List disputes
下一页
Accept claim
Built with