PayPal Dispute Reporting
All PayPal Disputes operations share the base path https://srs.segpay.com/paypal.asmx/
-
Each operation appends its name to that base path to form the endpoint you call.
-
Every request requires
UserIDandUserAccessKey(see Authentication).
Dispute Outcome Report
Returns a summary of PayPal disputes, grouped by type, outcome, and currency, for the specified date range. The date range is based on the date the dispute outcome was updated in PayPal.
Endpoint: https://srs.segpay.com/paypal.asmx/DisputeOutcomeReport
Request
GET
https://srs.segpay.com/PayPal.asmx/DisputeOutcomeReport?UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
POST
POST /PayPal.asmx/DisputeOutcomeReport HTTP/1.1
Host: srs.segpay.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
UserID
|
string | Yes | Your username to access Segpay Reporting Service (SRS). |
UserAccessKey
|
string | Yes | Your unique key to access Segpay Reporting Service (SRS). |
BegDate
|
string | No | Beginning date of the range for the report using mmddyyyy. Leave blank to default to today. |
EndDate
|
string | No | End date of the range for the report using mmddyyyy. Leave blank to default to today. |
Response
Returns an XML dataset. Each record is an aggregated group, not an individual dispute.
Response fields
| Field | Type | Description |
|---|---|---|
DisputeType
|
string |
Channel where the dispute originated. Values: |
DisputeOutcome
|
string |
The final resolution status for the dispute case. Values: |
Count
|
string | Total number of disputes in the group. |
Currency
|
string |
The three-letter currency code used for the amount listed in the record. Example: |
Amount
|
string |
The monetary value associated with the transaction, formatted to two decimal places. Example: |
Sample Response
<DataSet xmlns="http://srs.segpay.com/PayPal.asmx">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<DisputeOutcomeReport diffgr:id="DisputeOutcomeReport2" msdata:rowOrder="1" diffgr:hasChanges="inserted">
<DisputeType>INTERNAL</DisputeType>
<DisputeOutcome>RESOLVED_SELLER_FAVOUR</DisputeOutcome>
<Count>734</Count>
<Currency>USD</Currency>
<Amount>51830.15</Amount>
</DisputeOutcomeReport>
<DisputeOutcomeReport diffgr:id="DisputeOutcomeReport5" msdata:rowOrder="4" diffgr:hasChanges="inserted">
<DisputeType>EXTERNAL</DisputeType>
<DisputeOutcome>RESOLVED_WITH_PAYOUT</DisputeOutcome>
<Count>565</Count>
<Currency>USD</Currency>
<Amount>50539.36</Amount>
</DisputeOutcomeReport>
</NewDataSet>
</diffgr:diffgram>
</DataSet>
Disputes by Due Date Report
Returns open PayPal disputes filtered by seller response due date.
Endpoint: https://srs.segpay.com/PayPal.asmx/DisputesByDueDateReport
Request
GET
https://srs.segpay.com/PayPal.asmx/DisputesByDueDateReport?UserID=string&UserAccessKey=string&DueWithin=string
POST
POST /PayPal.asmx/DisputesByDueDateReport HTTP/1.1
Host: srs.segpay.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserID=string&UserAccessKey=string&DueWithin=string
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
UserID
|
string | Yes | Your username to access Segpay Reporting Service (SRS). |
UserAccessKey
|
string | Yes | Your unique key to access Segpay Reporting Service (SRS). |
DueWithin
|
string | Yes |
Lists all disputes due related to the selected value. Values: |
Response
Returns an XML dataset. Each record is a single PayPal dispute due within the value selected.
Response Fields
| Field | Type | Description |
|---|---|---|
MerchantId
|
integer | Merchant account ID. |
PurchaseId
|
integer |
The internal system identifier for the customer's purchase. Example: |
SaleTransactionId
|
integer |
The unique transaction ID generated for the original successful payment authorization. Example: |
SaleTransactionDate
|
dateTime |
The date and time the customer purchase (sale) was processed. Example: |
SaleTransactionType
|
string |
The classification of the original sale. Values: |
WebsiteURL
|
string |
The website domain where the customer made the purchase. Example: |
ConsumerFullName
|
string |
The first and last name of the customer who made the purchase and initiated the dispute. Example: |
ConsumerEmailAddress
|
string |
The email address associated with the customer's payment account. Example: |
RegionCode
|
string |
The geographic region code where processing occurred. Values: |
ExternalId
|
string |
The unique identifier assigned to the dispute by the external payment processor (PayPal). Example: |
CreationDateTime
|
dateTime |
The exact date and time the dispute record was created. Example: |
Reason
|
string |
Reason the dispute was filed. Values: |
Status
|
string |
Current status of the dispute. Values: |
LifeCycleStage
|
string |
The current stage in the dispute life cycle. Values: |
Channel
|
string |
Channel where the dispute originated. Values: |
OutcomeCode
|
string |
The final resolution status for the dispute case. Values: |
SellerResponseDueDate
|
dateTime | Date a merchant response is due by (the dispute due date). |
MerchantCurrencyCode
|
string |
The three-letter currency code used for the amount listed in the record. Example: |
MerchantAmount
|
decimal |
The monetary value associated with the transaction, formatted to two decimal places. Example: |
Sample response
<DataSet xmlns="http://srs.segpay.com/PayPal.asmx">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<DisputesByDueDateReport diffgr:id="DisputesByDueDateReport2" msdata:rowOrder="1" diffgr:hasChanges="inserted">
<MerchantId>12345</MerchantId>
<PurchaseId>128023053</PurchaseId>
<SaleTransactionId>231547809</SaleTransactionId>
<SaleTransactionDate>2026-07-05T16:23:52.99+00:00</SaleTransactionDate>
<SaleTransactionType>Sale</SaleTransactionType>
<WebsiteUrl>www.test.com</WebsiteUrl>
<WebsiteCategoryGroupName>Adult Other</WebsiteCategoryGroupName>
<ConsumerFullName>Jane Smith</ConsumerFullName>
<ConsumerEmailAddress>janesmitht@gmail.com</ConsumerEmailAddress>
<RegionCode>US</RegionCode>
<ExternalId>PP-R-BZQ-636016675</ExternalId>
<CreationDateTime>2026-07-05T17:43:45.427+00:00</CreationDateTime>
<Reason>UNAUTHORISED</Reason>
<Status>WAITING_FOR_SELLER_RESPONSE</Status>
<LifeCycleStage>CHARGEBACK</LifeCycleStage>
<Channel>INTERNAL</Channel>
<OutcomeCode/>
<SellerResponseDueDate>2026-07-15T22:59:59+00:00</SellerResponseDueDate>
<MerchantCurrencyCode>USD</MerchantCurrencyCode>
<MerchantAmount>39.97</MerchantAmount>
</DisputesByDueDateReport>
</NewDataSet>
</diffgr:diffgram>
</DataSet>
Disputes Report
Returns individual transaction-level dispute records. This report maps the complete lifecycle of a dispute, including original sales data, systemic tracking updates, final adjudication outcomes, and critical action deadlines.
PayPal dispute details, one row per dispute, for the specified date range. The date range is based on dispute creation date.
Endpoint: https://srs.segpay.com/PayPal.asmx/DisputesReport
Request
GET
https://srs.segpay.com/PayPal.asmx/DisputesReport?UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
POST
POST /PayPal.asmx/DisputesReport HTTP/1.1
Host: srs.segpay.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
UserID
|
string | Yes | Your username to access Segpay Reporting Service (SRS). |
UserAccessKey
|
string | Yes | Your unique key to access Segpay Reporting Service (SRS). |
BegDate
|
string | No | Beginning date of the range for the report using mmddyyyy. Leave blank to default to today. |
EndDate
|
string | No | End date of the range for the report using mmddyyyy. Leave blank to default to today. |
Response
Returns an XML dataset. Each record is a single PayPal dispute.
Response Fields
| Field | Type | Description |
|---|---|---|
MerchantId
|
integer | Merchant account ID. |
PurchaseId
|
integer | Purchase ID associated with the dispute. |
WebsiteURL
|
string |
The website domain where the customer made the purchase. Example: |
CustomerName
|
string |
The first and last name of the customer who made the purchase and initiated the dispute. Example: |
CustomerEmail
|
string |
The email address associated with the customer's payment account. Example: |
MerchantAmount
|
decimal |
The monetary value associated with the transaction, formatted to two decimal places. Example: |
MerchantCurrencyCode
|
string |
The three-letter currency code used for the amount listed in the record. Example: |
SaleTransactionId
|
integer |
The unique transaction ID generated for the original successful payment authorization. Example: |
SaleTransactionDate
|
dateTime |
The date and time the customer purchase (sale) was processed. Example: |
SaleTransactionType
|
string |
The classification of the original sale. Value: |
ReversalTransactionId
|
integer | Unique ID assigned if money was moved back. Returns empty if no reversal applies. |
ReversalTransactionDate
|
dateTime | The date and time a money reversal was started. Returns empty if no reversal applies. |
ReversalTransactionType
|
string |
The classification type of the reversal process. Returns empty if no reversal applies. Values: |
RegionCode
|
string |
The geographic region code where the processing occurred. Values: |
ExternalId
|
string | Dispute ID assigned by PayPal. |
CreationDateTime
|
dateTime | Date and time the dispute was created in PayPal. |
ResolutionDateTime
|
dateTime | Date and time the dispute was resolved. |
Status
|
string |
Current status of the dispute. Values: |
Channel
|
string |
Dispute channel. Values: |
LifeCycleStage
|
string |
Stage in the dispute life cycle. Values: |
Reason
|
string |
Reason the dispute was filed. Values: |
OutcomeCode
|
string |
Outcome of the dispute. Values: |
SellerResponseDueDate
|
dateTime | Date a merchant response is due by (the dispute due date). |
Sample response
<DataSet xmlns="http://srs.segpay.com/PayPal.asmx">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<DisputesReport diffgr:id="DisputesReport1" msdata:rowOrder="3" diffgr:hasChanges="inserted">
<MerchantId>12345</MerchantId>
<PurchaseId>124430079</PurchaseId>
<WebsiteUrl>www.test.com</WebsiteUrl>
<CustomerName>Bill Smith</CustomerName>
<CustomerEmail>billsmith8@gmail.com</CustomerEmail>
<MerchantAmount>39.97</MerchantAmount>
<MerchantCurrencyCode>USD</MerchantCurrencyCode>
<SaleTransactionId>224160808</SaleTransactionId>
<SaleTransactionDate>2026-04-06T00:00:00+00:00</SaleTransactionDate>
<SaleTransactionType>Sale</SaleTransactionType>
<ReversalTransactionType/>
<RegionCode>EU</RegionCode>
<ExternalId>PP-R-DJM-626697643</ExternalId>
<CreationDateTime>2026-04-30T09:53:32.697+00:00</CreationDateTime>
<ResolutionDateTime>2026-05-16T09:55:14.527+00:00</ResolutionDateTime>
<Status>RESOLVED</Status>
<Channel>EXTERNAL</Channel>
<LifeCycleStage>PRE_ARBITRATION</LifeCycleStage>
<Reason>CANCELED_RECURRING_BILLING</Reason>
<OutcomeCode>RESOLVED_BUYER_FAVOUR</OutcomeCode>
</DisputesReport>
<DisputesReport diffgr:id="DisputesReport2" msdata:rowOrder="4" diffgr:hasChanges="inserted">
<MerchantId>12345</MerchantId>
<PurchaseId>126172101</PurchaseId>
<WebsiteUrl>www.test.com</WebsiteUrl>
<CustomerName>Sabine Schiller</CustomerName>
<CustomerEmail>sabine321@web.de</CustomerEmail>
<MerchantAmount>1.00</MerchantAmount>
<MerchantCurrencyCode>EUR</MerchantCurrencyCode>
<SaleTransactionId>227603776</SaleTransactionId>
<SaleTransactionDate>2026-05-18T00:00:00+00:00</SaleTransactionDate>
<SaleTransactionType>Sale</SaleTransactionType>
<ReversalTransactionType/>
<RegionCode>EU</RegionCode>
<WebsiteCategoryGroupName>Adult Other</WebsiteCategoryGroupName>
<ExternalId>PP-R-VRP-629568821</ExternalId>
<CreationDateTime>2026-05-19T22:34:22.923+00:00</CreationDateTime>
<ResolutionDateTime>2026-05-30T22:10:24.71+00:00</ResolutionDateTime>
<Status>RESOLVED</Status>
<Channel>INTERNAL</Channel>
<LifeCycleStage>CHARGEBACK</LifeCycleStage>
<Reason>UNAUTHORISED</Reason>
<OutcomeCode>RESOLVED_SELLER_FAVOUR</OutcomeCode>
</DisputesReport>
</NewDataSet>
</diffgr:diffgram>
</DataSet>
Internal To External Dispute Report
Returns a summary of PayPal disputes escalated from internal to external channel, grouped by type, outcome, and currency, for the specified date range. The date range is based on dispute creation date.
Endpoint: https://srs.segpay.com/PayPal.asmx/InternalToExternalDisputeReport
Request
GET
https://srs.segpay.com/PayPal.asmx/InternalToExternalDisputeReport?UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
POST
POST /PayPal.asmx/InternalToExternalDisputeReport HTTP/1.1
Host: srs.segpay.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
UserID
|
string | Yes | Your username to access Segpay Reporting Service (SRS). |
UserAccessKey
|
string | Yes | Your unique key to access Segpay Reporting Service (SRS). |
BegDate
|
string | No | Beginning date of the range for the report using mmddyyyy. Leave blank to default to today. |
EndDate
|
string | No | End date of the range for the report using mmddyyyy. Leave blank to default to today. |
Response
Returns an XML dataset with the same six aggregated fields as DisputeOutcomeReport. Each record is an aggregated group, not an individual dispute.
Response fields
| Field | Type | Description |
|---|---|---|
DisputeType
|
string |
Channel where the dispute orginated. Values: |
DisputeOutcome
|
string |
The final resolution status of the aggregated dispute cases within a specific grouping. Values: |
Count
|
string |
The total number of unique dispute cases matching the specific combination of criteria (DisputeType + Outcome + Currency). Example: |
Currency
|
string |
The three-letter currency code of the aggregated group. Example: |
Amount
|
string |
The total monetary value of all disputes counted in the group, formatted to two decimal places. Example: |
Sample response
<DataSet xmlns="http://srs.segpay.com/PayPal.asmx">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<InternalToExternalDisputeReport diffgr:id="InternalToExternalDisputeReport1" msdata:rowOrder="0" diffgr:hasChanges="inserted">
<DisputeType>EXTERNAL</DisputeType>
<DisputeOutcome>RESOLVED_BUYER_FAVOUR</DisputeOutcome>
<Count>48</Count>
<Currency>EUR</Currency>
<Amount>1352.52</Amount>
</InternalToExternalDisputeReport>
</NewDataSet>
</diffgr:diffgram>
</DataSet>
Refunds Resulting In Dispute Report
Returns PayPal disputes where a refund occurred before the dispute was created. Date range is based on the dispute creation date in PayPal.
Endpoint: https://srs.segpay.com/PayPal.asmx/RefundsResultingInDisputeReport
Request
GET
https://srs.segpay.com/PayPal.asmx/RefundsResultingInDisputeReport?UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
POST
POST /PayPal.asmx/RefundsResultingInDisputeReport HTTP/1.1
Host: srs.segpay.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserID=string&UserAccessKey=string&BegDate=string&EndDate=string
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
UserID
|
string | Yes | Your username to access Segpay Reporting Service (SRS). |
UserAccessKey
|
string | Yes | Your unique key to access Segpay Reporting Service (SRS). |
BegDate
|
string | No | Beginning date of the range for the report using mmddyyyy. Leave blank to default to today. |
EndDate
|
string | No | End date of the range for the report using mmddyyyy. Leave blank to default to today. |
Response
Returns an XML dataset
Response Fields
| Field | Type | Description |
|---|---|---|
MerchantId
|
integer | Merchant account ID. |
SaleTransactionDateTime
|
dateTime |
The date and time the customer purchase (sale) was processed. Example: |
CreationDateTime
|
dateTime |
The exact date and time the dispute record was created. Example: |
ExternalId
|
string |
The unique identifier assigned to the dispute by the external payment processor (PayPal). Example: |
LifeCycleStage
|
string |
The current stage in the dispute life cycle. Values: |
DisputeOutcome
|
string |
The final resolution status for the dispute case. Values: |
Status
|
string |
Current status of the dispute. Values: |
Reason
|
string |
Reason the dispute was filed. Values: |
DisputeType
|
string |
Channel where the dispute originated. Values: |
ConsumerFullName
|
string |
The first and last name of the customer who made the purchase and initiated the dispute. Example: |
ConsumerEmailAddress
|
string |
The email address associated with the customer's payment account. Example: |
PurchaseId
|
integer |
The internal system identifier for the customer's purchase. Example: |
SaleTransactionId
|
integer |
The unique transaction ID generated for the original successful payment authorization. Example: |
SaleTransactionType
|
string |
The classification of the original sale. Values: |
RefundTransactionID
|
integer |
The unique transaction identifier generated when the merchant issued the refund. Example: |
RefundTransactionDateTime
|
dateTime |
The exact date and time the merchant processed the refund. In this scenario, this timestamp will be prior to the Example: |
ChargebackTransactionId
|
integer |
The unique transaction identifier generated by the processor when the dispute escalated into a chargeback. Example: |
ChargebackTransactionDateTime
|
dateTime |
The exact date and time when the external processor initiated the chargeback action. Example: |
WebsiteURL
|
string |
The website domain where the customer made the purchase. Example: |
RegionCode
|
string |
The geographic region code where processing occurred. Values: |
Currency
|
string |
The three-letter currency code used for the amount listed in the record. Example: |
Amount
|
decimal |
The monetary value associated with the transaction, formatted to two decimal places . Example: |
Sample Response
<DataSet xmlns="http://srs.segpay.com/PayPal.asmx">
<xs:schema xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" id="NewDataSet">
...
</xs:schema>
<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
<NewDataSet xmlns="">
<RefundsResultingInDisputeReport diffgr:id="RefundsResultingInDisputeReport1" msdata:rowOrder="0" diffgr:hasChanges="inserted">
<MerchantId>12345</MerchantId>
<SaleTransactionDateTime>2026-03-03T22:22:13.09+00:00</SaleTransactionDateTime>
<CreationDateTime>2026-03-26T10:03:37.893+00:00</CreationDateTime>
<ExternalId>PP-R-ZJW-987654321</ExternalId>
<LifeCycleStage>CHARGEBACK</LifeCycleStage>
<DisputeOutcome>RESOLVED_SELLER_FAVOUR</DisputeOutcome>
<Status>RESOLVED</Status>
<Reason>MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED</Reason>
<DisputeType>EXTERNAL</DisputeType>
<ConsumerFullName>Jane Smith</ConsumerFullName>
<ConsumerEmailAddress>janesmith@gmail.com</ConsumerEmailAddress>
<PurchaseId>123199873</PurchaseId>
<SaleTransactionId>221493145</SaleTransactionId>
<SaleTransactionType>Sale</SaleTransactionType>
<RefundTransactionId>222181028</RefundTransactionId>
<RefundTransactionDateTime>2026-03-12T12:05:52.86+00:00</RefundTransactionDateTime>
<ChargebackTransactionId>223282633</ChargebackTransactionId>
<ChargebackTransactionDateTime>2026-03-26T10:10:08.747+00:00</ChargebackTransactionDateTime>
<WebsiteUrl>test.com</WebsiteUrl>
<RegionCode>EU</RegionCode>
<Currency>EUR</Currency>
<Amount>49.99</Amount>
</RefundsResultingInDisputeReport>
</NewDataSet>
</diffgr:diffgram>
</DataSet>