Contents
4 October 2006 Order Management Integration Guide
IPN Notification Validation: Preventing Fraud . . . . . . . . . . . . . . . . . . . . . . . . 31
Shared Secret Per Transaction or by Profile Setting . . . . . . . . . . . . . . . . . . 32
Shared Secret Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Your HTTPS Postback to PayPal . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Using IPN with Multiple Currencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
mc_gross and mc_fee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
mc_currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
payment_gross and payment_fee . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Examples of Multi-currency IPN Variables. . . . . . . . . . . . . . . . . . . . . . . . 35
Chapter 4 Transaction History and Reporting Tools . . . . . . . . . .39
Monthly Account Statements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Online History Searching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Basic Search: Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Advanced Search: Key Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Download My History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Choosing a Date Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Selecting a File Format and Transaction Categories . . . . . . . . . . . . . . . . . . 42
Completed Transactions Since Last Download . . . . . . . . . . . . . . . . . . . . . 43
Customizing the Download: Selecting Transaction Fields. . . . . . . . . . . . . . . . 43
Transaction Reconciliation with the Balance Impact Column . . . . . . . . . . . . . . 45
Lifecycle of a Transaction: Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Net Amount Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Dispute Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Programmatic Access to Dispute Report . . . . . . . . . . . . . . . . . . . . . . . . 47
Appendix A IPN and PDT Variables. . . . . . . . . . . . . . . . . . . .51
About These Tables of Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Transaction-Specifc Variable Values. . . . . . . . . . . . . . . . . . . . . . . . . . . 51
test_ipn Variable in Sandbox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
IPN Variables in All Posts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
IPN Version: notify_version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Security Information: verify_sign. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Buyer Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Basic Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Advanced and Custom Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Website Payments Standard and Refund Information . . . . . . . . . . . . . . . . . . . . 55
Currency and Currency Exchange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60