Integration Guide
Table Of Contents
- Order Management Integration Guide
- Preface
- Introduction
- Payment Data Transfer
- Instant Payment Notification (IPN)
- Transaction History and Reporting Tools
- IPN and PDT Variables
- About These Tables of Variables
- test_ipn Variable in Sandbox
- IPN Variables in All Posts
- Buyer Information
- Basic Information
- Advanced and Custom Information
- Website Payments Standard and Refund Information
- Currency and Currency Exchange
- Auctions
- Mass Payment
- Dispute Notification Variables
- PDT-Specific Variables
- Downloadable History Log Columns and Values
- Index
Transaction History and Reporting Tools
Dispute Report
46 October 2006 Order Management Integration Guide
If you are found in favor in a dispute, the transaction will be updated with a new line-item to
indicate a Credit. However, if the opposite is true, the Balance Impact column will not change
from the Debit status for that transaction.
You can generate a dispute report that correlates the transaction to the customer and the reason
for the dispute. For more information, see “Dispute Report” on page 46.
Net Amount Column
The Net Amount of a transaction can aid in faster reconciliation.
In most cases, the Net Amount is the Gross minus Fee. When a History entry is updated (for
example, in the case of a refund), the Net Amount column indicates the current net value of the
transaction on a separate line-item.
FIGURE 4.4 Gross, Fee and Net Amount Calculations from History Log
Dispute Report
Buyers can register claims about payments; such claims are called cases. PayPal notifies
merchants about new cases with email and with IPN.
There are two kinds of cases:
z Complaint: A buyer has used the PayPal Resolution Center to register a claim about a
payment to a merchant.
NOTE: After notification about a complaint claim, merchants must log in to PayPal to use
the Resolution Center to respond to the case.
z Chargeback: A buyer has filed a complaint with a credit card company that has resulted in
a chargeback. The credit card company notifies PayPal about the reason for the
chargeback. After investigating the case, PayPal notifies the merchant of any action
required.
NOTE: The IPN messages for chargebacks resulting from a complaint are asynchronous:
the IPN message for the chargeback can be sent to the merchant before the IPN
message relating to the complaint. You should compare the IPN variable
parent_txn_id of all IPN messages to match the chargeback with the complaint.