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 UserID and UserAccessKey (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

API field names do not always match the field names shown in the Merchant Portal. Use the Merchant Portal field name column to map fields between the API and the Merchant Portal in either direction.

Field Type Description Merchant Portal field name
DisputeType string

Channel where the dispute originated.

Values: ALERT, INTERNAL, EXTERNAL

 Dispute Type
DisputeOutcome string

The final resolution status for the dispute case.

Values: ACCEPTED, CANCELED_BY_BUYER, DENIED, RESOLVED_BUYER_FAVOUR, RESOLVED_SELLER_FAVOUR, RESOLVED_WITH_PAYOUT

 Dispute Outcome
Count string Total number of disputes in the group. Count
Currency string

The three-letter currency code used for the amount listed in the record.

Example: USD, GBP, EUR.

 Currency
Amount string

The total monetary value of all disputes in the group, formatted to two decimal places.

Example: 50539.36.

Amount

These values are subject to change. PayPal may add or update values at any time.

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: NotSet (no due date), TwentyFourHours, FortyEightHours, OneWeek, MoreThanOneWeek, BeforeNow (overdue)

Response

Returns an XML dataset. Each record is a single PayPal dispute due within the value selected.

Response Fields

API field names do not always match the field names shown in the Merchant Portal. Use the Merchant Portal field name column to map fields between the API and the Merchant Portal in either direction.

Field Type Description Merchant Portal field name
MerchantId integer Merchant account ID. Merchant ID
PurchaseId integer

The internal system identifier for the customer's purchase.

Example: 128023053

 Purchase ID
SaleTransactionId integer

The unique transaction ID generated for the original successful payment authorization.

Example: 231547809

 Sale Transaction ID
SaleTransactionDate dateTime

The date and time the customer purchase (sale) was processed.

Example: 2026-07-05T16:23:52.99+00:00

 Sale Transaction Date
SaleTransactionType string

The classification of the original sale.

Values: Sale, OneClick

 Sale Transaction Type
WebsiteUrl string

The website domain where the customer made the purchase.

Example: test.com

 URL
ConsumerFullName string

The first and last name of the customer who made the purchase and initiated the dispute.

Example: Jane Smith

 Consumer Name
ConsumerEmailAddress string

The email address associated with the customer's payment account.

Example: janesmith@gmail.com

 Consumer Email
RegionCode string

The geographic region code for the merchant.

Values: US, UK, EU

 Region
ExternalId string

The unique identifier assigned to the dispute by the external payment processor (PayPal).

Example: PP-R-BZQ-636016675

 Dispute ID
CreationDateTime dateTime

The exact date and time the dispute record was created.

Example: 2026-07-05T16:23:52.99+00:00

 Dispute Creation Date
Reason string

Reason the dispute was filed.

Values: CANCELED_RECURRING_BILLING, CREDIT_NOT_PROCESSED, DUPLICATE_TRANSACTION, INCORRECT_AMOUNT, MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED, MERCHANDISE_OR_SERVICE_NOT_RECEIVED, OTHER, PAYMENT_BY_OTHER_MEANS, UNAUTHORISED.

 Dispute Reason
Status string

Current status of the dispute.

Values: OPEN, RESOLVED, UNDER_REVIEW, WAITING_FOR_BUYER_RESPONSE, WAITING_FOR_SELLER_RESPONSE

 Dispute Status
LifeCycleStage string

The current stage in the dispute life cycle.

Values: CHARGEBACK, INQUIRY, PRE_ARBITRATION, ARBITRATION

 Dispute Stage
Channel string

Channel where the dispute originated.

Values: ALERT, INTERNAL, EXTERNAL

 Dispute Type
OutcomeCode string

The final resolution status for the dispute case.

Values: ACCEPTED, CANCELED_BY_BUYER, DENIED, RESOLVED_BUYER_FAVOUR, RESOLVED_SELLER_FAVOUR, RESOLVED_WITH_PAYOUT

 Dispute Outcome
SellerResponseDueDate dateTime Date a merchant response is due by (the dispute due date). Due Date
MerchantCurrencyCode string

The three-letter currency code used for the amount listed in the record.

Example: USD, GBP, EUR

 Currency
MerchantAmount decimal

The monetary value associated with the transaction, formatted to two decimal places.

Example: 39.97

 Transaction Amount

These values are subject to change. PayPal may add or update values at any time.

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>
    <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

API field names do not always match the field names shown in the Merchant Portal. Use the Merchant Portal field name column to map fields between the API and the Merchant Portal in either direction.

Field Type Description Merchant Portal field name
MerchantId integer Merchant account ID. MID
PurchaseId integer Purchase ID associated with the dispute. Purchase ID
WebsiteUrl string

The website domain where the customer made the purchase.

Example: test.com

URL
CustomerName string

The first and last name of the customer who made the purchase and initiated the dispute.

Example: Jane Smith

 Consumer Name
CustomerEmail string

The email address associated with the customer's payment account.

Example: janesmith@gmail.com.

 Consumer Email
MerchantAmount decimal

The monetary value associated with the transaction, formatted to two decimal places.

Example: 49.99

 Transaction Amount
MerchantCurrencyCode string

The three-letter currency code used for the amount listed in the record.

Example: USD, GBP, EUR.

Currency
SaleTransactionId integer

The unique transaction ID generated for the original successful payment authorization.

Example: 224160808

 Sale Transaction ID
SaleTransactionDate dateTime

The date and time the customer purchase (sale) was processed.

Example: 2026-04-06T00:00:00+00:00

 Sale Transaction Date
SaleTransactionType string

The classification of the original sale.

Values: Sale, OneClick

 Sale Transaction Type
ReversalTransactionId integer Unique ID assigned if money was moved back. Returns empty if no reversal applies. Reversal Transaction ID
ReversalTransactionDate dateTime The date and time a money reversal was started. Returns empty if no reversal applies. Reversal Transaction Date
ReversalTransactionType string

The classification type of the reversal process. Returns empty if no reversal applies.

Values: Chargeback, Revoke

Reversal Type
RegionCode string

The geographic region code for the merchant.

Values: US, UK, EU

 Region
ExternalId string Dispute ID assigned by PayPal. Dispute ID
CreationDateTime dateTime Date and time the dispute was created in PayPal. Dispute Creation Date
ResolutionDateTime dateTime Date and time the dispute was resolved. Dispute Resolution Date
Status string

Current status of the dispute.

Values: OPEN, RESOLVED, UNDER_REVIEW, WAITING_FOR_BUYER_RESPONSE, WAITING_FOR_SELLER_RESPONSE

 Dispute Status
Channel string

Dispute channel.

Values: ALERT, INTERNAL, EXTERNAL

 Dispute Type
LifeCycleStage string

Stage in the dispute life cycle.

Values: CHARGEBACK, INQUIRY, PRE_ARBITRATION, ARBITRATION

 Dispute Stage
Reason string

Reason the dispute was filed.

Values: CANCELED_RECURRING_BILLING, CREDIT_NOT_PROCESSED, DUPLICATE_TRANSACTION, INCORRECT_AMOUNT, MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED, MERCHANDISE_OR_SERVICE_NOT_RECEIVED, OTHER, PAYMENT_BY_OTHER_MEANS, UNAUTHORISED

 Dispute Reason
OutcomeCode string

Outcome of the dispute.

Values: ACCEPTED, CANCELED_BY_BUYER, DENIED, RESOLVED_BUYER_FAVOUR, RESOLVED_SELLER_FAVOUR, RESOLVED_WITH_PAYOUT

 Dispute Outcome
SellerResponseDueDate dateTime Date a merchant response is due by (the dispute due date). Dispute Due Date

These values are subject to change. PayPal may add or update values at any time.

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>
        <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

API field names do not always match the field names shown in the Merchant Portal. Use the Merchant Portal field name column to map fields between the API and the Merchant Portal in either direction.

Field Type Description Merchant Portal field name
DisputeType string

Channel where the dispute orginated.

Values: ALERT, INTERNAL, EXTERNAL

 Dispute Type
DisputeOutcome string

The final resolution status of the aggregated dispute cases within a specific grouping.

Values: ACCEPTED, CANCELED_BY_BUYER, DENIED, RESOLVED_BUYER_FAVOUR, RESOLVED_SELLER_FAVOUR, RESOLVED_WITH_PAYOUT

 Dispute Outcome
Count string

The total number of unique dispute cases matching the specific combination of criteria (DisputeType + Outcome + Currency).

Example: 48

 Count
Currency string

The three-letter currency code of the aggregated group.

Example: USD, GBP, EUR

 Currency
Amount string

The total monetary value of all disputes counted in the group, formatted to two decimal places.

Example: 1352.52. Can be negative.

 Amount

These values are subject to change. PayPal may add or update values at any time.

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

API field names do not always match the field names shown in the Merchant Portal. Use the Merchant Portal field name column to map fields between the API and the Merchant Portal in either direction.

Field Type Description Merchant Portal field name
MerchantId integer Merchant account ID. Merchant ID
SaleTransactionDateTime dateTime

The date and time the customer purchase (sale) was processed.

Example: 2026-03-03T22:22:13.09+00:00

 Sale Transaction Date
CreationDateTime dateTime

The exact date and time the dispute record was created.

Example: 2026-03-26T10:03:37.893+00:00

 Dispute Creation Date
ExternalId string

The unique identifier assigned to the dispute by the external payment processor (PayPal).

Example: PP-R-ZJW-987654321

 Dispute ID
LifeCycleStage string

The current stage in the dispute life cycle.

Values: CHARGEBACK, INQUIRY, PRE_ARBITRATION, ARBITRATION

 Dispute Stage
DisputeOutcome string

The final resolution status for the dispute case.

Values: ACCEPTED, CANCELED_BY_BUYER, DENIED, RESOLVED_BUYER_FAVOUR, RESOLVED_SELLER_FAVOUR, RESOLVED_WITH_PAYOUT

 Dispute Outcome
Status string

Current status of the dispute.

Values: OPEN, RESOLVED, UNDER_REVIEW, WAITING_FOR_BUYER_RESPONSE, WAITING_FOR_SELLER_RESPONSE

 Dispute Status
Reason string

Reason the dispute was filed.

Values:CANCELED_RECURRING_BILLING, CREDIT_NOT_PROCESSED, DUPLICATE_TRANSACTION, INCORRECT_AMOUNT, MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED, MERCHANDISE_OR_SERVICE_NOT_RECEIVED, OTHER, PAYMENT_BY_OTHER_MEANS, UNAUTHORISED.

 Dispute Reason
DisputeType string

Channel where the dispute originated.

Values: ALERT, INTERNAL, EXTERNAL

 Dispute Type
ConsumerFullName string

The first and last name of the customer who made the purchase and initiated the dispute.

Example: Jane Smith

 Consumer Name
ConsumerEmailAddress string

The email address associated with the customer's payment account.

Example: janesmith@gmail.com

 Consumer Email
PurchaseId integer

The internal system identifier for the customer's purchase.

Example: 123199873

 Purchase ID
SaleTransactionId integer

The unique transaction ID generated for the original successful payment authorization.

Example: 221493145

 Sale Transaction ID
SaleTransactionType string

The classification of the original sale.

Values: Sale, OneClick

 Sale Transaction Type
RefundTransactionId integer

The unique transaction identifier generated when the merchant issued the refund.

Example: 222181028

 Refund Transaction ID
RefundTransactionDateTime dateTime

The exact date and time the merchant processed the refund. In this scenario, this timestamp will be prior to the CreationDateTime.

Example: 2026-03-12T12:05:52.86+00:00

 Refund Transaction Date
ChargebackTransactionId integer

The unique transaction identifier generated by the processor when the dispute escalated into a chargeback.

Example: 223282633

 Chargeback Transaction ID
ChargebackTransactionDateTime dateTime

The exact date and time when the external processor initiated the chargeback action.

Example: 2026-03-26T10:10:08.747+00:00

 Chargeback Transaction Date
WebsiteUrl string

The website domain where the customer made the purchase.

Example: test.com

 URL
RegionCode string

The geographic region code for the merchant.

Values: US, UK, EU

 Region
Currency string

The three-letter currency code used for the amount listed in the record.

Example: USD, GBP, EUR.

Currency
Amount decimal

The monetary value associated with the transaction, formatted to two decimal places .

Example: 49.99

Transaction Amount

These values are subject to change. PayPal may add or update values at any time.

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>