PayPal Order Management - 2005 User's Guide

Last Updated: August 2005For Professional Use OnlyCurrently only available in English.A usage Professional UniquementDisponible en Anglais uniquement

Preface10 August 2005 Order Management Integration GuideTo convey additional information, this document may also apply color and underlining to words

Order Management Integration Guide August 2005 111IntroductionPayPal offers four payment notification methods for backend integration:z Emailz Reporti

IntroductionDifferences between Instant Payment Notification (IPN) and Payment Data Transfer (PDT)12 August 2005 Order Management Integration Guidez D

Order Management Integration Guide August 2005 13IntroductionPayPal-Supported CurrenciesPayPal-Supported CurrenciesThe following currencies are suppor

IntroductionPayPal-Supported Currencies14 August 2005 Order Management Integration Guide

Order Management Integration Guide August 2005 152Payment Data TransferPayment Data Transfer (PDT) provides merchants with the ability to display tran

Payment Data TransferHow PDT Works16 August 2005 Order Management Integration GuideStep 2: Bob is taken to a PayPal Payment Details page which display

Order Management Integration Guide August 2005 17Payment Data TransferHow PDT WorksStep 5: A payment confirmation page appears that informs Bob that h

Payment Data TransferEnabling Payment Data Transfer18 August 2005 Order Management Integration GuideStep 8: Bob receives an email receipt for this tra

Order Management Integration Guide August 2005 19Payment Data TransferPDT and PayPal Account Optional4. Click the Payment Data Transfer On radio butto

© 2006 PayPal Inc. All rights reserved. PayPal and the PayPal logo are registered trademarks of PayPal, Inc. Designated trademarks and brands are the

Payment Data TransferPDT Notification Synch20 August 2005 Order Management Integration GuidePayPal Account Optional is enabled by default. If the merc

Order Management Integration Guide August 2005 21Payment Data TransferPDT Notification SynchPayPal Response to POSTPayPal responds to the post with a

Payment Data TransferPreventing Fraud22 August 2005 Order Management Integration GuidePreventing FraudIn order to prevent fraud, PayPal recommends tha

Order Management Integration Guide August 2005 233Instant Payment Notification (IPN) Instant Payment Notification (IPN) allows you to integrate PayPal

Instant Payment Notification (IPN) How IPN POSTs Are Sent24 August 2005 Order Management Integration GuideHow IPN POSTs Are SentStep 1: Your buyer com

Order Management Integration Guide August 2005 25Instant Payment Notification (IPN) Setting Up IPNStep 5: After verifying the correctness of the data

Instant Payment Notification (IPN) IPN Notification and Notification Validation 26 August 2005 Order Management Integration GuideIPN Notification and

Order Management Integration Guide August 2005 27Instant Payment Notification (IPN) IPN Notification and Notification Validation Shared Secret Validat

Instant Payment Notification (IPN) Using IPN with Multiple Currencies28 August 2005 Order Management Integration GuidePayPal Response to PostbackPayPa

Order Management Integration Guide August 2005 29Instant Payment Notification (IPN) Using IPN with Multiple CurrenciesThese values are absent for non-

Order Management Integration Guide August 2005 3ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Instant Payment Notification (IPN) Using IPN with Multiple Currencies30 August 2005 Order Management Integration Guidepayment_gross =payment_fee =mc_g

Order Management Integration Guide August 2005 31Instant Payment Notification (IPN) Using IPN with Multiple CurrenciesEXAMPLE 3.6 Pending - Accept to

Instant Payment Notification (IPN) Dispute Notification32 August 2005 Order Management Integration GuideDispute NotificationBuyers can register claims

Order Management Integration Guide August 2005 334Downloadable History LogPayPal’s Downloadable History Log makes it easier and more efficient to trac

Downloadable History LogCustomizing Your Downloadable History Log34 August 2005 Order Management Integration GuideCustomizing Your Downloadable Histor

Order Management Integration Guide August 2005 35Downloadable History LogCustomizing Your Downloadable History LogFIGURE 4.2 Customize My History Down

Downloadable History LogDownloading Your History36 August 2005 Order Management Integration GuideDownloading Your HistoryFollow the instructions below

Order Management Integration Guide August 2005 37Downloadable History LogViewing Your Downloaded LogViewing Your Downloaded LogAs detailed in the prev

Downloadable History LogViewing Your Downloaded Log38 August 2005 Order Management Integration GuideFIGURE 4.4 A Comma-Separated Value History log in

August 2005 39AIPN and PDT VariablesIPN and PDT variables are case-sensitive. All values are lowercase, except those for payment_status, which have an

Contents4 August 2005 Order Management Integration GuideDispute Notification . . . . . . . . . . . . . . . . . . . . . . . .

IPN and PDT Variablestest_ipn Variable in Sandbox40 August 2005test_ipn Variable in SandboxIn the Sandbox environment, IPN includes the additional var

August 2005 41IPN and PDT VariablesBasic InformationBasic Informationaddress_streetCustomer’s street address. 200address_zip Zip code of customer’s ad

IPN and PDT VariablesAdvanced and Custom Information42 August 2005Advanced and Custom Informationquantity Quantity as entered by your customer or as p

August 2005 43IPN and PDT VariablesShopping Cart InformationShopping Cart Informationoption_selection2Option 2 choice as entered by your customer.If t

IPN and PDT VariablesShopping Cart Information44 August 2005option_name1PayPal appends the number of the item where x represents the number of the sho

August 2005 45IPN and PDT VariablesShopping Cart Informationpayment_typeecheckinstantecheck: This payment was funded with an eCheck.instant: This paym

IPN and PDT VariablesCurrency and Currency Exchange46 August 2005Currency and Currency Exchangetax PayPal appends the number of the item (e.g., item_n

August 2005 47IPN and PDT VariablesAuctionsAuctionspayment_fee Transaction-specific for USD payments onlyUSD transaction fee associated with the payme

IPN and PDT VariablesMass Payment48 August 2005Mass PaymentTABLE A.6 IPN and PDT Variables: Mass PayVariable Name Possible Values Descriptionmasspay_t

August 2005 49IPN and PDT VariablesSubscriptions VariablesSubscriptions VariablesAlong with other IPN variables, the following variables are included

Order Management Integration Guide August 2005 5List of TablesTable 1.1 PayPal-Supported Currencies, Currency Codes, and Maximum Transaction Amounts 1

IPN and PDT VariablesSubscriptions Variables50 August 2005subscr_effectiveDate when the subscription modification will be effective (only for txn_type

August 2005 51IPN and PDT VariablesSubscriptions Variablesusername (optional) Username generated by PayPal and given to subscriber to access the subsc

IPN and PDT VariablesSubscriptions Variables52 August 2005Variables for Each Subscription EventThe following table shows which variables are associate

August 2005 53IPN and PDT VariablesSubscriptions VariablesCurrency and Exchange informationmc_grossXXmc_feeXXmc_currencyXXXXXXXsettle_amountXXexchange

IPN and PDT VariablesDispute Notification Variables54 August 2005Dispute Notification VariablesVariables related to customer dispute cases are detaile

August 2005 55IPN and PDT VariablesDispute Notification Variablescase_idCase identification number.Format: PP-nnn-nnn-nnn where n is any numeric chara

IPN and PDT VariablesPDT-Specific Variables56 August 2005PDT-Specific VariablesThe following variables apply only to PDT. TABLE A.10 PDT-Specific Vari

August 2005 57IPN and PDT VariablesPDT-Specific Variables

IPN and PDT VariablesPDT-Specific Variables58 August 2005

Order Management Integration Guide August 2005 59BDownloadable History LogColumns and ValuesTABLE B.1 Downloadable History Log Columns and ValuesColum

List of Tables6 August 2005 Order Management Integration Guide

Downloadable History Log Columns and Values60 August 2005 Order Management Integration GuideTypeType of transaction: Add Funds from a Bank AccountATM

Order Management Integration Guide August 2005 61Downloadable History Log Columns and ValuesStatus Status of transaction at time of download:CanceledC

Downloadable History Log Columns and Values62 August 2005 Order Management Integration GuideTo Email Address Email address of transaction recipient al

Order Management Integration Guide August 2005 63Downloadable History Log Columns and ValuesShipping Amount Specified by buyer in the website field:z

Downloadable History Log Columns and Values64 August 2005 Order Management Integration GuideOption 2 Value Entered by buyer in any of the following we

Order Management Integration Guide August 2005 65Downloadable History Log Columns and ValuesCustom Number Specified by seller in any of the following

Downloadable History Log Columns and Values66 August 2005 Order Management Integration Guide

August 2005 67CCountry CodesISO 3166 Standard Country CodesPayPal relies on two-character country codes defined by International Standards Organizatio

Country CodesISO 3166 Standard Country Codes68 August 2005Hungary HUIceland ISIndia INIreland IEIsrael ILItaly ITJamaica JMJapan JPLatvia LVLithuania

August 2005 69Country CodesISO 3166 Standard Country CodesThailand THTurkey TRUnited Kingdom GBUnited States USUruguay UYVenezuela VETABLE C.1 ISO 316

Order Management Integration Guide August 2005 7List of FiguresFigure 4.1 The Download My History Link . . . . . . . . . . . . . . . .

Country CodesISO 3166 Standard Country Codes70 August 2005

Order Management Integration Guide August 2005 71IndexSymbols_notify-synch 20_notify-validate 27AAccount Optional and PDT 19address 45address_city 40a

Index72 August 2005 Order Management Integration GuideVERIFIED response 28item_name 41item_number 41Llast_name 41Mmasspay_txn_id_x 48mc_amount1 50mc_a

Order Management Integration Guide August 2005 73Indexrecurring 50Refunded 44remaining_settle 43residence_country 41Resolution Center 32retry_at 50Rev

Index74 August 2005 Order Management Integration Guide

List of Figures8 August 2005 Order Management Integration Guide

Order Management Integration Guide August 2005 9PrefaceThis DocumentThis release of the PayPal Order Management Integration Guide, a document that des