PayPal Order Management - 2006 Betriebsanweisung

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

List of Figures10 October 2006 Order Management Integration Guide

Order Management Integration Guide October 2006 11PPrefaceThis DocumentThis release of the PayPal Order Management Integration Guide, a document that

PrefaceNotational Conventions12 October 2006 Order Management Integration GuideNotational ConventionsThis document uses typefaces to identify the char

Order Management Integration Guide October 2006 13PrefaceDocumentation ProblemsDocumentation ProblemsIf you discover any errors in or have any problem

PrefaceRevision History14 October 2006 Order Management Integration Guide

Order Management Integration Guide October 2006 151IntroductionPayPal offers four payment notification methods for backend integration:z Emailz Report

IntroductionDifferences between Instant Payment Notification (IPN) and Payment Data Transfer (PDT)16 October 2006 Order Management Integration Guidez

Order Management Integration Guide October 2006 17IntroductionPayPal-Supported Transactional CurrenciesSSL Not Required for IPNBecause credit card and

IntroductionPayPal-Supported Transactional Currencies18 October 2006 Order Management Integration Guide

Order Management Integration Guide October 2006 192Payment Data TransferPayment Data Transfer (PDT) provides merchants with the ability to display tra

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

Payment Data TransferHow PDT Works20 October 2006 Order Management Integration GuideStep 2: Bob is taken to a PayPal Payment Details page which displa

Order Management Integration Guide October 2006 21Payment Data TransferHow PDT WorksStep 4: Bob is then taken to a confirmation page that displays the

Payment Data TransferHow PDT Works22 October 2006 Order Management Integration GuideStep 5: A payment confirmation page appears that informs Bob that

Order Management Integration Guide October 2006 23Payment Data TransferEnabling Payment Data TransferFor example, as shown in the following diagram: T

Payment Data TransferEnabling Payment Data Transfer24 October 2006 Order Management Integration Guide3. Click the Website Payment Preferences link, as

Order Management Integration Guide October 2006 25Payment Data TransferPDT Notification SynchYou will need to pass this identity token, along with the

Payment Data TransferPDT Notification Synch26 October 2006 Order Management Integration GuideFor information about the identity token, see “Getting an

Order Management Integration Guide October 2006 27Payment Data TransferPreventing FraudPreventing FraudIn order to prevent fraud, PayPal recommends th

Payment Data TransferCode Samples28 October 2006 Order Management Integration Guide

Order Management Integration Guide October 2006 293Instant Payment Notification (IPN) Instant Payment Notification (IPN) allows you to integrate PayPa

Order Management Integration Guide October 2006 3ContentsChapter P Preface . . . . . . . . . . . . . . . . . . . . . . . . .

Instant Payment Notification (IPN)Setting Up IPN30 October 2006 Order Management Integration GuideFIGURE 3.1 How IPN Works: Three General Steps1. A cu

Order Management Integration Guide October 2006 31Instant Payment Notification (IPN)IPN Notification Validation: Preventing Fraud2. Click the Profile

Instant Payment Notification (IPN)IPN Notification Validation: Preventing Fraud32 October 2006 Order Management Integration Guide1. Sending a shared s

Order Management Integration Guide October 2006 33Instant Payment Notification (IPN)IPN Notification Validation: Preventing Fraudvariable to which the

Instant Payment Notification (IPN)Using IPN with Multiple Currencies34 October 2006 Order Management Integration Guide1. Check that the payment_status

Order Management Integration Guide October 2006 35Instant Payment Notification (IPN)Using IPN with Multiple Currenciesmc_currencyThis variable reflect

Instant Payment Notification (IPN)Using IPN with Multiple Currencies36 October 2006 Order Management Integration GuideExample 3If the account is set t

Order Management Integration Guide October 2006 37Instant Payment Notification (IPN)Using IPN with Multiple Currenciesmc_currency = GBPIf the payment

Instant Payment Notification (IPN)Using IPN with Multiple Currencies38 October 2006 Order Management Integration Guide

Order Management Integration Guide October 2006 394Transaction History and Reporting ToolsWith transaction history and reporting tools, you can access

Contents4 October 2006 Order Management Integration GuideIPN Notification Validation: Preventing Fraud . . . . . . . . . . . . . . . .

Transaction History and Reporting ToolsOnline History Searching40 October 2006 Order Management Integration Guidemonthly account statements of your tr

Order Management Integration Guide October 2006 41Transaction History and Reporting ToolsOnline History SearchingIMPORTANT:The length of time of the d

Transaction History and Reporting ToolsDownload My History42 October 2006 Order Management Integration GuideDownload My HistoryDownload My History giv

Order Management Integration Guide October 2006 43Transaction History and Reporting ToolsDownload My History– All activity– Completed payments– Balanc

Transaction History and Reporting ToolsDownload My History44 October 2006 Order Management Integration GuideFIGURE 4.3 Customize My History Download

Order Management Integration Guide October 2006 45Transaction History and Reporting ToolsDownload My HistoryTransaction Reconciliation with the Balanc

Transaction History and Reporting ToolsDispute Report46 October 2006 Order Management Integration GuideIf you are found in favor in a dispute, the tra

Order Management Integration Guide October 2006 47Transaction History and Reporting ToolsDispute ReportIPN variables for cases include the type of cas

Transaction History and Reporting ToolsDispute Report48 October 2006 Order Management Integration GuideContent of the ReportThe report contains inform

Order Management Integration Guide October 2006 49Transaction History and Reporting ToolsDispute Report3. Click the Multi-User Access link under the A

Order Management Integration Guide October 2006 5ContentsAuctions . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Transaction History and Reporting ToolsDispute Report50 October 2006 Order Management Integration Guide

A Order Management Integration Guide October 2006 51IPN and PDT VariablesIPN and PDT variables are case-sensitive. All values are lowercase, except t

IPN and PDT VariablesIPN Variables in All Posts52 October 2006 Order Management Integration GuideIPN Variables in All PostsIPN Version: notify_version

Order Management Integration Guide October 2006 53IPN and PDT VariablesBasic InformationBasic Informationlast_name Customer’s last name 64payer_busine

IPN and PDT VariablesAdvanced and Custom Information54 October 2006 Order Management Integration GuideAdvanced and Custom Informationreceiver_emailPri

Order Management Integration Guide October 2006 55IPN and PDT VariablesWebsite Payments Standard and Refund InformationWebsite Payments Standard and R

IPN and PDT VariablesWebsite Payments Standard and Refund Information56 October 2006 Order Management Integration Guidemc_shipping_xTransaction-specif

Order Management Integration Guide October 2006 57IPN and PDT VariablesWebsite Payments Standard and Refund Informationpayment_statusCanceled_Reversal

IPN and PDT VariablesWebsite Payments Standard and Refund Information58 October 2006 Order Management Integration Guidepending_reasonaddressauthorizat

Order Management Integration Guide October 2006 59IPN and PDT VariablesWebsite Payments Standard and Refund Informationreason_code chargebackguarantee

Contents6 October 2006 Order Management Integration Guide

IPN and PDT VariablesCurrency and Currency Exchange60 October 2006 Order Management Integration GuideCurrency and Currency ExchangeTABLE A.5 IPN and P

Order Management Integration Guide October 2006 61IPN and PDT VariablesAuctionsAuctionspayment_grossTransaction-specific for USD payments onlyFull USD

IPN and PDT VariablesMass Payment62 October 2006 Order Management Integration GuideMass PaymentTABLE A.7 IPN and PDT Variables: Mass PaymentVariable N

Order Management Integration Guide October 2006 63IPN and PDT VariablesMass Paymentreason_code 100110031004This variable is only set if status = Faile

IPN and PDT VariablesMass Payment64 October 2006 Order Management Integration GuideSubscriptions VariablesAlong with other IPN variables, the followin

Order Management Integration Guide October 2006 65IPN and PDT VariablesMass PaymentVariables for Each Subscription EventThe following table shows whic

IPN and PDT VariablesMass Payment66 October 2006 Order Management Integration Guideitem_number X XXX X XXAdvanced and Custom Informationinvoice X XXX

Order Management Integration Guide October 2006 67IPN and PDT VariablesMass Paymentlast_name X XXX X XXpayer_business_nameX XXX X Xaddress_name X XXX

IPN and PDT VariablesDispute Notification Variables68 October 2006 Order Management Integration GuideDispute Notification Variablesrecur_times XXXuser

Order Management Integration Guide October 2006 69IPN and PDT VariablesPDT-Specific VariablesPDT-Specific VariablesThe following variables apply only

Order Management Integration Guide October 2006 7List of TablesTable P.1 Revision History . . . . . . . . . . . . . . . . . . . .

IPN and PDT VariablesPDT-Specific Variables70 October 2006 Order Management Integration Guide

B Order Management Integration Guide October 2006 71Downloadable History Log Columns and ValuesTABLE B.1 Downloadable History Log Columns and ValuesC

Downloadable History Log Columns and Values72 October 2006 Order Management Integration GuideType Type of transaction: Add Funds from a Bank AccountAT

Order Management Integration Guide October 2006 73Downloadable History Log Columns and ValuesType (continued) Update to ReversalUpdate to Web Accept P

Downloadable History Log Columns and Values74 October 2006 Order Management Integration GuideGross Gross amount of transaction signed decimal amount p

Order Management Integration Guide October 2006 75Downloadable History Log Columns and ValuesItem Title Specified by buyer in the website field:z Auct

Downloadable History Log Columns and Values76 October 2006 Order Management Integration GuideOption 1 Value Entered by buyer in any of the following w

Order Management Integration Guide October 2006 77Downloadable History Log Columns and ValuesClosing Date Close date of eBay/Auction Item (eBay/Auctio

Downloadable History Log Columns and Values78 October 2006 Order Management Integration GuideBalance Account balance at time of transaction. Balance i

79 C Country CodesNOTE:This table lists country codes defined by ISO 3166-1.Table 1: Country CodesCountry CodeAFGHANISTAN AFÅLAND ISLANDS AXALBANIA AL

List of Tables8 October 2006 Order Management Integration Guide

Country Codes80CENTRAL AFRICAN REPUBLICCFCHAD TDCHILE CLCHINA CNCHRISTMAS ISLAND CXCOCOS (KEELING) ISLANDSCCCOLOMBIA COCOMOROS KMCONGO CGCONGO, THE DE

GUINEA GNGUINEA-BISSAU GWGUYANA GYHAITI HTHEARD ISLAND AND MCDONALD ISLANDSHMHOLY SEE (VATICAN CITY STATE)VAHONDURAS HNHONG KONG HKHUNGARY HUICELAND I

Country Codes82MICRONESIA, FEDER-ATED STATES OFFMMOLDOVA, REPUBLIC OFMDMONACO MCMONGOLIA MNMONTSERRAT MSMOROCCO MAMOZAMBIQUE MZMYANMAR MMNAMIBIA NANAU

SAO TOME AND PRINC-IPESTSAUDI ARABIA SASENEGAL SNSERBIA AND MON-TENEGROCSSEYCHELLES SCSIERRA LEONE SLSINGAPORE SGSLOVAKIA SKSLOVENIA SISOLOMON ISLANDS

Country Codes84VIRGIN ISLANDS, U.S. VIWALLIS AND FUTUNA WFWESTERN SAHARA EHYEMEN YEZAMBIA ZMZIMBABWE ZWCountry Code

Order Management Integration Guide October 2006 85IndexAactivities 41address 58address_city 52address_country 52address_country_code 52address_name 52

Index86 October 2006 Order Management Integration GuideHHistory 39HKD 17Hong Kong Dollar 17HUF 17Hungarian Forint 17Iiif file format 43instant 57intl

Order Management Integration Guide October 2006 87IndexPayPal-supported currencies 17Pending 55, 57pending_reason 58period1 64period2 64period3 64PLN

Index88 October 2006 Order Management Integration GuideZZloty 17

Order Management Integration Guide October 2006 9List of FiguresFigure 3.1 How IPN Works: Three General Steps . . . . . . . . . . . . 3