PayPal Order Management - 2008 Guide de l'utilisateur

Order Management Integration GuideFor Professional Use OnlyCurrently only available in English.A usage Professional UniquementDisponible en Anglais un

IntroductionDifferences between Payment Data Transfer (PDT) and Instant Payment Notification (IPN)110 March 2008 Order Management Integration Guidez M

Order Management Integration Guide March 2008 11IntroductionPayPal-Supported Transactional Currencies1PayPal-Supported Transactional CurrenciesThe fol

IntroductionPayPal-Supported Transactional Currencies112 March 2008 Order Management Integration Guide

Order Management Integration Guide March 2008 132Payment Data Transfer (PDT)Merchants who use Website Payments Standard can use Payment Data Transfer

Payment Data Transfer (PDT)How PDT Works214 March 2008 Order Management Integration GuideStep 3: Bob enters his PayPal account information into the Pa

Order Management Integration Guide March 2008 15Payment Data Transfer (PDT)How PDT Works2Step 5: A payment confirmation page appears that informs Bob

Payment Data Transfer (PDT)How PDT Works216 March 2008 Order Management Integration GuideStep 6: A transaction token is passed to the return URL provi

Order Management Integration Guide March 2008 17Payment Data Transfer (PDT)Enabling Payment Data Transfer2Step 8: Bob receives an email receipt for th

Payment Data Transfer (PDT)Enabling Payment Data Transfer218 March 2008 Order Management Integration Guide1. Click the My Account tab.2. Click the Pro

Order Management Integration Guide March 2008 19Payment Data Transfer (PDT)PDT and PayPal Account Optional2For security, the identity token is not sen

PayPal Order Management Integration GuideDocument Number: 100009.en_US-200803© 2008 PayPal, Inc. All rights reserved. PayPal is a registered trademark

Payment Data Transfer (PDT)PDT Notification Synch220 March 2008 Order Management Integration GuideConstructing the POSTHere are the guidelines for con

Order Management Integration Guide March 2008 21Payment Data Transfer (PDT)Preventing Fraud2PDT and Auto Return: Messaging to BuyerWith Auto Return, y

Payment Data Transfer (PDT)Sample Code for PDT222 March 2008 Order Management Integration Guide

Order Management Integration Guide March 2008 - first technical draft 233Instant Payment Notification (IPN) Instant Payment Notification (IPN) allows

Instant Payment Notification (IPN)Setting Up IPN324 March 2008 - first technical draft Order Management Integration GuideFIGURE 3.1 How IPN Works: Thr

Order Management Integration Guide March 2008 - first technical draft 25Instant Payment Notification (IPN)Setting Up IPN3Activating IPN Through Your A

Instant Payment Notification (IPN)Using IPN Notification Validation to Help Prevent Fraud326 March 2008 - first technical draft Order Management Integ

Order Management Integration Guide March 2008 - first technical draft 27Instant Payment Notification (IPN)Using IPN Notification Validation to Help Pr

Instant Payment Notification (IPN)Using IPN with Multiple Currencies328 March 2008 - first technical draft Order Management Integration GuideN OTE: Yo

Order Management Integration Guide March 2008 - first technical draft 29Instant Payment Notification (IPN)Using IPN with Multiple Currencies3payment_g

Order Management Integration Guide March 2008 31ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Instant Payment Notification (IPN)Using IPN with Multiple Currencies330 March 2008 - first technical draft Order Management Integration GuideExample 2

Order Management Integration Guide March 2008 - first technical draft 31Instant Payment Notification (IPN)Dispute Notification and Downloadable Disput

Instant Payment Notification (IPN)Dispute Notification and Downloadable Dispute Report332 March 2008 - first technical draft Order Management Integrat

Order Management Integration Guide March 2008 - first technical draft 33Instant Payment Notification (IPN)Dispute Notification and Downloadable Disput

Instant Payment Notification (IPN)Dispute Notification and Downloadable Dispute Report334 March 2008 - first technical draft Order Management Integrat

Order Management Integration Guide March 2008 354Transaction History and Reporting ToolsWith transaction history and reporting tools, you can access m

Transaction History and Reporting ToolsUsing Monthly Account Statements436 March 2008 Order Management Integration GuideFIGURE 4.1 The History PageUsi

Order Management Integration Guide March 2008 37Transaction History and Reporting ToolsSearching History43. On the displayed page, click the Yes radi

Transaction History and Reporting ToolsSearching History438 March 2008 Order Management Integration GuideBasic Searching by ActivityFrom the History p

Order Management Integration Guide March 2008 39Transaction History and Reporting ToolsSearching History4The choice All Activity - Simple View is sele

Contents14 March 2008 Order Management Integration GuideUsing IPN with Multiple Currencies . . . . . . . . . . . . . . . . . . .

Transaction History and Reporting ToolsSearching History440 March 2008 Order Management Integration GuideFor detailed information on how to specify a

Order Management Integration Guide March 2008 41Transaction History and Reporting ToolsDownloading History4z Select the From radio button, and specify

Transaction History and Reporting ToolsDownloading History442 March 2008 Order Management Integration GuideFIGURE 4.2 Download History Page2. In the u

Order Management Integration Guide March 2008 43Transaction History and Reporting ToolsDownloading History4– Intuit QuickBooks (.iif file format)– or

Transaction History and Reporting ToolsDownloading History444 March 2008 Order Management Integration Guide1. In the upper right area of the History D

Order Management Integration Guide March 2008 45Transaction History and Reporting ToolsDownloading History4FIGURE 4.3 The Customize My History Downloa

Transaction History and Reporting ToolsDownloading History446 March 2008 Order Management Integration GuideUnderstanding the Status and Life Cycle of

Order Management Integration Guide March 2008 47Transaction History and Reporting ToolsReporting Disputed Transactions4Memo EntriesThe Balance Impact

Transaction History and Reporting ToolsReporting Disputed Transactions448 March 2008 Order Management Integration GuideFIGURE 4.5 Dispute ReportProgra

Order Management Integration Guide March 2008 49Transaction History and Reporting ToolsReporting Disputed Transactions4First DDR ReportWhen you first

Order Management Integration Guide March 2008 5Contents1Miscellaneous and Fee-Related IPN Variables . . . . . . . . . . . . . . . . .

Transaction History and Reporting ToolsReporting Disputed Transactions450 March 2008 Order Management Integration Guide5. Select the checkboxes next t

AOrder Management Integration Guide March 2008 51IPN and PDT VariablesIPN and PDT variables are case-sensitive. All values are lowercase, except those

IPN and PDT VariablesIPN Variables in All PostsA52 March 2008 Order Management Integration GuideIPN Variables in All PostsIPN Version: notify_versionT

Order Management Integration Guide March 2008 53IPN and PDT VariablesBasic InformationABasic Informationlast_name Customer’s last name 64payer_busines

IPN and PDT VariablesAdvanced and Custom InformationA54 March 2008 Order Management Integration GuideAdvanced and Custom Informationquantity Quantity

Order Management Integration Guide March 2008 55IPN and PDT VariablesWebsite Payments Standard, Website Payments Pro, and Refund InformationAWebsite P

IPN and PDT VariablesWebsite Payments Standard, Website Payments Pro, and Refund InformationA56 March 2008 Order Management Integration Guidemc_shippi

Order Management Integration Guide March 2008 57IPN and PDT VariablesWebsite Payments Standard, Website Payments Pro, and Refund InformationApayment_s

IPN and PDT VariablesWebsite Payments Standard, Website Payments Pro, and Refund InformationA58 March 2008 Order Management Integration Guidepending_r

Order Management Integration Guide March 2008 59IPN and PDT VariablesWebsite Payments Standard, Website Payments Pro, and Refund InformationAreason_co

Contents16 March 2008 Order Management Integration Guide

IPN and PDT VariablesCurrency and Currency ExchangeA60 March 2008 Order Management Integration GuideCurrency and Currency Exchangetxn_type cartexpress

Order Management Integration Guide March 2008 61IPN and PDT VariablesCurrency and Currency ExchangeAmc_gross Full amount of the customer's paymen

IPN and PDT VariablesAuctionsA62 March 2008 Order Management Integration GuideAuctionsMass PaymentTABLE A.6 IPN and PDT Variables: AuctionsVariable Na

Order Management Integration Guide March 2008 63IPN and PDT VariablesMass PaymentAmc_gross_x Transaction-specific for Multiple CurrenciesThe gross amo

IPN and PDT VariablesSubscriptionsA64 March 2008 Order Management Integration GuideSubscriptionsSubscriptions VariablesAlong with other IPN variables,

Order Management Integration Guide March 2008 65IPN and PDT VariablesSubscriptionsAperiod1 (optional) Trial subscription interval in days, weeks, mont

IPN and PDT VariablesSubscriptionsA66 March 2008 Order Management Integration GuideVariables for Each Subscription EventThe following table shows whic

Order Management Integration Guide March 2008 67IPN and PDT VariablesSubscriptionsApayment_date XXtxn_id XXparent_txn_id XXtxn_type subscr_signupsubsc

IPN and PDT VariablesDispute Notification VariablesA68 March 2008 Order Management Integration GuideDispute Notification VariablesSubscription Informa

Order Management Integration Guide March 2008 69IPN and PDT VariablesDispute Notification VariablesAtxn_id The merchant’s original transaction identif

Order Management Integration Guide March 2008 7PPrefaceThis DocumentThis document describes the PayPal features for managing orders, such as Payment D

IPN and PDT VariablesPDT-Specific VariablesA70 March 2008 Order Management Integration GuideMiscellaneous and Fee-Related IPN VariablesPDT-Specific Va

AOrder Management Integration Guide March 2008 71Downloadable History LogsTABLE B.1 Fields and Values in Downloadable History LogsField Name Descripti

Downloadable History LogsB72 March 2008 Order Management Integration GuideType Type of transaction: Add Funds from a Bank AccountATM WithdrawalATM Wit

Order Management Integration Guide March 2008 73Downloadable History LogsBType (continued) Update to ReversalUpdate to Web Accept Payment ReceivedVirt

Downloadable History LogsB74 March 2008 Order Management Integration GuideGross Gross amount of transaction signed decimal amount payment_grosssettle_

Order Management Integration Guide March 2008 75Downloadable History LogsBItem Title Specified by buyer in the website field:z Auction/Item TitleOr by

Downloadable History LogsB76 March 2008 Order Management Integration GuideOption 1 Value Entered by buyer in any of the following website fields:z Pay

Order Management Integration Guide March 2008 77Downloadable History LogsBClosing Date Close date of eBay/Auction Item (eBay/Auction-specific)[M]M/[D]

Downloadable History LogsB78 March 2008 Order Management Integration GuideBalance Account balance at time of transaction. Balance is reported in the c

Order Management Integration Guide March 2008 79IndexAaddress 58address_city 52address_country 52address_country_code 52address_name 52address_state 5

Revision HistoryP8 March 2008 Order Management Integration Guide

Index80 March 2008 Order Management Integration GuideHHistory 35HKD 11Hong Kong Dollar 11HUF 11Hungarian Forint 11Iiif file format 43instant 57intl 58

Order Management Integration Guide March 2008 81Indexpayment_gross 61payment_gross_x 63payment_status 51, 63payment_type 57PayPal-supported currencies

Index82 March 2008 Order Management Integration GuideYYen 11ZZloty 11

Order Management Integration Guide March 2008 91IntroductionPayPal offers four payment notification methods for back-end integration:z Emailz Reportin