Transcription
Website PaymentsPro Integration GuideLast updated: November 2010
PayPal Website Payments Pro Integration GuideDocument Number: 100001.en US-201011 2010 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, Inc. The PayPal logo is a trademark of PayPal, Inc. Othertrademarks and brands are the property of their respective owners.The information in this document belongs to PayPal, Inc. It may not be used, reproduced or disclosed without the written approval of PayPal, Inc.Copyright PayPal. All rights reserved. PayPal S.à r.l. et Cie, S.C.A., Société en Commandite par Actions. Registered office: 22-24 Boulevard Royal, L2449, Luxembourg, R.C.S. Luxembourg B 118 349Consumer advisory: The PayPal payment service is regarded as a stored value facility under Singapore law. As such, it does not require the approvalof the Monetary Authority of Singapore. You are advised to read the terms and conditions carefully.Notice of non-liability:PayPal, Inc. is providing the information in this document to you “AS-IS” with all faults. PayPal, Inc. makes no warranties of any kind (whether express,implied or statutory) with respect to the information contained herein. PayPal, Inc. assumes no liability for damages (whether direct or indirect), causedby errors or omissions, or resulting from the use of this document or the information contained in this document or resulting from the application or useof the product or service described herein. PayPal, Inc. reserves the right to make changes to any information herein without further notice.
ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Where to Go for More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Chapter 1Introducing Website Payments Pro . . . . . . . . . . . . . 9Getting Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Website Payments Pro Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Additional Features of Website Payments Pro . . . . . . . . . . . . . . . . . . . . . . . . 10Settlements and Captured Payments . . . . . . . . . . . . . . . . . . . . . . . . . . 11Recurring Payments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Virtual Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Hosted Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Fraud Management Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Event Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Website Payments Pro API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Website Payments Pro Regional Differences . . . . . . . . . . . . . . . . . . . . . . . . 15Credit Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Default Currency and Transaction Limits . . . . . . . . . . . . . . . . . . . . . . . . 15Credit Card Currencies by Country . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Chapter 2Introducing Direct Payment . . . . . . . . . . . . . . . . . 19The Direct Payment User Experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19User Interface Recommendations for Direct Payment Checkout . . . . . . . . . . . . . . 21Chapter 3Introducing Express Checkout . . . . . . . . . . . . . . . 23The Express Checkout Experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Express Checkout Integration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Configuring and Customizing the Express Checkout Experience . . . . . . . . . . . . 25Additional PayPal API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Express Checkout Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26November 20103
ContentsCheckout Entry Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Payment Option Entry Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27PayPal Button and Logo Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Express Checkout API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Express Checkout Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Express Checkout Token Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Chapter 4Getting Started With Direct Payment . . . . . . . . . . . . 33Implementing the Simplest Direct Payment Integration . . . . . . . . . . . . . . . . . . . 33Testing Direct Payment Using NVP and cURL. . . . . . . . . . . . . . . . . . . . . . . . 34Direct Payment Authorization and Captures . . . . . . . . . . . . . . . . . . . . . . . . . 38Sale Payment Action for Direct Payment . . . . . . . . . . . . . . . . . . . . . . . . 38Authorization and Capture for Direct Payment . . . . . . . . . . . . . . . . . . . . . 38DoDirectPayment Reauthorization and Capture Example. . . . . . . . . . . . . . . . 41Chapter 5Getting Started With Express Checkout . . . . . . . . . . . 45Implementing the Simplest Express Checkout Integration. . . . . . . . . . . . . . . . . . 45Setting Up the Express Checkout Transaction . . . . . . . . . . . . . . . . . . . . . 45Obtaining Express Checkout Transaction Details . . . . . . . . . . . . . . . . . . . . 47Completing the Express Checkout Transaction . . . . . . . . . . . . . . . . . . . . . 48Testing an Express Checkout Integration . . . . . . . . . . . . . . . . . . . . . . . . . . 49Handling Payment Settlements With Express Checkout. . . . . . . . . . . . . . . . . . . 53Authorization Payment Action for Express Checkout . . . . . . . . . . . . . . . . . . 54Order Payment Action for Express Checkout . . . . . . . . . . . . . . . . . . . . . . 55Issuing Refunds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Chapter 6Integrating Recurring Payments . . . . . . . . . . . . . . . 59How Recurring Payments Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Recurring Payments Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Recurring Payments With Direct Payment . . . . . . . . . . . . . . . . . . . . . . . . . . 61Recurring Payments With Express Checkout . . . . . . . . . . . . . . . . . . . . . . . . 62Redirecting the Buyer’s Browser to PayPal . . . . . . . . . . . . . . . . . . . . . . . 65Getting Buyer Details Using GetExpressCheckoutDetails . . . . . . . . . . . . . . . . 65Creating the Profiles With CreateRecurringPaymentsProfile . . . . . . . . . . . . . . 65Options for Creating a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . 66Specifying the Regular Payment Period . . . . . . . . . . . . . . . . . . . . . . . . . 664November 2010
ContentsIncluding an Optional Trial Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Specifying an Initial Payment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Billing the Outstanding Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Recurring Payments Profile Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Getting Recurring Payments Profile Information . . . . . . . . . . . . . . . . . . . . . . . 69Modifying a Recurring Payments Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Updating Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Updating the Billing Amount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Billing the Outstanding Amount of a Profile . . . . . . . . . . . . . . . . . . . . . . . . . 70Recurring Payments Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Chapter 7Getting Started With the PayPal Name-Value Pair API. . . 73PayPal API Client-Server Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73PayPal Name-Value Pair API Requests and Responses . . . . . . . . . . . . . . . . 74Multiple API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Obtaining API Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Creating an API Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Creating an API Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Creating an NVP Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Specifying the PayPal API Operation . . . . . . . . . . . . . . . . . . . . . . . . . . 78Specifying an API Credential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78URL Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79List Syntax for Name-Value Pairs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Executing NVP API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Specifying a PayPal Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Logging API Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Responding to an NVP Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Common Response Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81URL Decoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Chapter 8Implementing 3-D Secure Transactions (UK Only) . . . . . 83Introduction to 3-D Secure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Integration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Cardinal Commerce Registration and Installation . . . . . . . . . . . . . . . . . . . . . . 84Transaction Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85URL to Handle Issuer’s Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Transaction Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863-D Secure Fields for Direct Payment Transaction Requests . . . . . . . . . . . . . . 88November 20105
ContentsWebsite Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Example 1: Successful 3-D Secure Authentication . . . . . . . . . . . . . . . . . . . 89Example 2: 3-D Secure with Unsuccessful Authentication . . . . . . . . . . . . . . . 90Example 3: Card Issuer Not Using 3-D Secure . . . . . . . . . . . . . . . . . . . . . 90Example 4: Merchant Not Using 3-D Secure . . . . . . . . . . . . . . . . . . . . . . 91Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91cmpi lookup API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91cmpi lookup Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91cmpi lookup Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Issuer Authentication Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Issuer Authentication Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Issuer Authentication Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93cmpi authenticate API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93cmpi authenticate Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94cmpi authenticate Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946November 2010
PrefaceThis document describes Website Payments Pro integration.Intended AudienceThis document is intended for merchants and developers implementing Website PaymentsPro.Revision HistoryRevision history for PayPal Website Payments Pro Integration Guide.TABLE 1.1 Revision historyDateDescription11/15/10Added information about Hosted Solution for UK.10/26/10Added a reference to information on Mobile Express Checkout, which islocated in the Express Checkout Integration Guide.08/11/10Divided the Website Payments Pro Integration Guide into 2 guides: theWebsite Payments Pro Integration Guide and the Express CheckoutAdvanced Features Guide.05/11/10Added details for integrating parallel payments using the NVP and SOAPAPI, including use with airlines. Added new Immediate Paymentfunctionality. Updated billing agreements with functionality to obtain thelatest billing address, skip billing agreement creation, and clarify use of theBAUpdate API.03/10/2010Consolidated all regions (US, UK, and Canada) into one manual.Added additional information about Direct Payment.10/05/2009Added Immediate Payment.Edited for technical accuracy.Removed PayPal placement guidelines.06/30/2009Added a section on payment review.06/04/2009Added a chapter on pre-populating the PayPal review page. Updated PayPalReview pages. Moved some customization topics out of this guide. Theyare now in the Merchant Setup and Administration Guide.Website Payments Pro Integration GuideNovember 20107
Where to Go for More InformationTABLE 1.1 Revision historyDateDescription04/08/2009Added a chapter describing the Instant Update Callback API.Added Express Checkout feature of passing AMT 0 to create one or morebilling agreements.12/11/2008Revised the Website Payments Pro introduction and overview chapters.11/13/2008Added information about integrating dynamic images and addedinformation about order details that can be displayed on the PayPal Reviewpage.06/30/2008Complete revision.Where to Go for More Information Express Checkout Advanced Features Guide Merchant Setup and Administration GuideFor information on Mobile Express Checkout, see:. Express Checkout Integration GuideDocumentation FeedbackHelp us improve this guide by sending feedback to:[email protected] 2010Website Payments Pro Integration Guide
1Introducing Website PaymentsProYou can accept credit and debit cards and PayPal payments directly on your website using 2API-based solutions: Direct Payment and Express Checkout. You must integrate with bothDirect Payment and Express Checkout to use Website Payments Pro. Website Payments Pro Overview Additional Features of Website Payments Pro Website Payments Pro API Operations Website Payments Pro Regional DifferencesGetting Related InformationAll PayPal documentation is available on x.com, including video demos, forums and developerresources. For information about administrative tasks you can perform from your PayPal account suchas adding users, setting up custom page styles, and managing multiple currency balances,see the Merchant Setup and Administration Guide. If you use the Payflow API to process transactions with PayPal as your internet merchantaccount, see Website Payments Pro Payflow Edition Developers Guide.Website Payments Pro OverviewWebsite Payments Pro includes Direct Payment, Express Checkout, and additional PayPalsolutions and tools, such as Virtual Terminal, Fraud Management Filters, and referencetransactions. Direct Payment enables you to accept both debit and credit cards directly from your site. Express Checkout enables you to accept payments from PayPal accounts in addition todebit and credit cards.The following diagram shows the relationship between Direct Payment and Express Checkoutto a buyer.Website Payments Pro Integration GuideNovember 20109
1Introducing Website Payments ProAdditional Features of Website Payments ProFrom your shopping cart, a buyer can either checkout with Express Checkout, starting fromthe Checkout with PayPal button on your Shopping Cart page, or pay directly by credit ordebit card using Direct Payment.If a buyer pays using Express Checkout, PayPal provides a checkout experience thatstreamlines checkout. Even if buyers do not pay using Express Checkout, they can still pay bycredit or debit card using Direct Payment. In this case, buyers might need to enter payment,billing, and shipping information. In both cases, buyers stay on your website or are sent to thepage of your choice.You must implement both an Express Checkout flow and a Direct Payment flow to useWebsite Payments Pro. You implement the Express Checkout flow by calling PayPal’sExpress Checkout API operations, which guides a buyer through the checkout process. Youimplement the Direct Payment flow using your own code, for which PayPal provides an APIoperation to process the credit or debit card payment.NOT E :Purchases through Direct Payment are not covered by the PayPal Seller ProtectionPolicy.Additional Features of Website Payments ProWebsite Payments Pro consists of APIs for accepting credit card, debit card, and PayPalpayments; these payments can be immediate, authorized for later capture, and they can berecurring payments. Website Payments Pro also includes standalone applications for acceptingpayments.In addition, Website Payments Pro includes Fraud Management Filters for automatic reviewand management of risk.10November 2010Website Payments Pro Integration Guide
Introducing Website Payments ProAdditional Features of Website Payments Pro1Settlements and Captured PaymentsOften, you accept a payment and ship goods immediately, which is refered to as sale. Inaddition to immediate payments, Direct Payment and Express Checkout both allow you toauthorize payments to be captured later, which is referred to as an authorization. Anauthorization is useful, for example, when you want to reserve a buyer’s funds pending theshipment of goods; the actual payment is captured when the goods are shipped. Anauthorization can be reauthorized one time if necessary; for example, when you are unable toship within 3 days of the authorization.Express Checkout provides an additional option, called an order, which you use when a singleauthorization is insufficient. You can create multiple authorizations and capture them as partof the same order. This would be useful, for example, when an order is split into multipleshipments and you need to capture a payment each time part of the order is shipped.Recurring PaymentsYou can support recurring payments to manage subscriptions and other payments on a fixedschedule. Direct Payment and Express Checkout both process recurring payments.When you support recurring payments for a buyer, you create a recurring payments profile.The profile contains information about the recurring payments, including details for anoptional trial period and a regular payment period. Both periods contain information about thepayment frequency and payment amounts, including shipping and tax, if applicable.After a profile is created, PayPal automatically queues payments based on the billing startdate, billing frequency, and billing amount. Payments reoccur until the profile expires, thereare too many failed payments to continue, or you cancel the profile.Permission to allow recurring payments is established by the buyer setting up a billingagreement with the merchant on PayPal. For Express Checkout, the billing agreement can beestablished either in advance or when the buyer first makes a purchase; in either case, it occurswhen you call Express Checkout API operations. For direct payment, it occurs when you makean explicit call to set up the billing agreement.Recurring payments using reference transactions is an alternative, which enables you to handlepayments for varying amounts of money on a varying schedule. A reference transaction is afinancial transaction from which subsequent transactions can be derived; for example, a buyercan make a purchase on your site and the PayPal transaction ID, called a reference transactionID, can later be used to initiate another transaction.NOT E :The use of recurring payments with direct payment may incur additional fees.Virtual TerminalPayPal’s Virtual Terminal is a web-based application that allows you to accept credit cardpayments. It is available to merchants in the United States, Canada, France, and the UnitedKingdom. Virtual Terminal provides your business with the functionality similar to a standalone credit card-processing terminal. Virtual Terminal is ideal when you receive orders byWebsite Payments Pro Integration GuideNovember 201011
1Introducing Website Payments ProAdditional Features of Website Payments Prophone, fax, or by mail and want to accept credit cards. An optional card reader is available toprocess face-to-face purchases; however, some restrictions apply. You can use VirtualTerminal on any computer with an internet connection and a web browser.For more information about Virtual Terminal, see Virtual Terminal Users Guide.Hosted SolutionHosted Solution, which is available to merchants in the United Kingdom as part of WebsitePayments Pro, is a fast and easy way to add transaction processing to your website. It is asecure, PayPal-hosted, web-based payment solution that allows you to securely send yourbuyers to PayPal’s payment page to authorize and process transactions. Buyers pay with adebit or credit card, or their PayPal account. You do not have to capture or store credit cardinformation on your website, thereby helping towards achieving PCI compliance. HostedSolution is the choice for merchants who prefer a solution where all financial details arehandled by PayPal.For more information about Hosted Solution for UK merchants, see Website Payments ProHosted Solution Integration Guide.Fraud Management FiltersFraud Management Filters (FMF) provide you filters that identify potentially fraudulenttransactions. There are 2 categories of filters: Basic filters screen against data such as the country of origin and the value of transactions.PayPal provides basic filters for Business accounts and Website Payments Pro accounts. Advanced filters screen data such as credit card and addresses information, lists of highrisk indicators, and additional transaction characteristics. Website Payments Pro merchantscan upgrade to use these filters.NOT E :Using advanced filters might incur additional charges.For more information about Fraud Management Filters, see Fraud Management FiltersEvent NotificationIn most cases you can use the GetTransactionDetails API operation to determine theinformation you need about a transaction. However, there may be some cases in which youmust set up IPN; for example, when you need automatic notification about actions, such asdisputes and their resolution.IPN is a message service that PayPal uses to notify you about events, such as 12Instant payments, including Express Checkout, Adaptive Payments, and direct credit cardpayments, and authorizations, which indicate a sale whose payment has not yet beencollectedNovember 2010Website Payments Pro Integration Guide
Introducing Website Payments ProWebsite Payments Pro API Operations eCheck payments and associated status, such as pending, completed, or denied, andpayments pending for other reasons, such as those being reviewed for potential fraud Recurring payment and subscription actions Chargebacks, disputes, reversals, and refunds associated with a transaction1For more information about IPN, see Instant Payment Notification GuideWebsite Payments Pro API OperationsThe PayPal API supports a range of functions related to payment processing. Though mostAPI operations support both Direct Payment and Express Checkout, some are specific toDirect Payment and others are specific to Express Checkout.PayPal API OperationDescriptionDirect Payment core API operations: (Direct Payment only)DoDirectPaymentProcess a credit card payment, such as a sale orauthorization.DoNonReferencedCreditIssue a credit to a card not referenced by the originaltransaction.N O TE :Contact PayPal to use this API operation; in mostcases, you should use the RefundTransactionAPI operation instead.Express Checkout core API operations: (Express Checkout only)SetExpressCheckoutInitiates an Express Checkout transaction.GetExpressCheckoutDetailsObtain information about an Express Checkout transaction.DoExpressCheckoutPaymentCompletes an Express Checkout transaction.Common API operations:GetTransactionDetailsObtain information about a specific transaction.ManagePendingTransactionStatusAccept or deny a pending transaction held by FraudManagement Filters.RefundTransactionIssue a refund to the PayPal account holder associated with atransaction.TransactionSearchSearch transaction history for transactions that meet thespecified criteria.Authorization and Capture API operations:DoCaptureCapture an authorized payment.DoAuthorizationAuthorize a payment. (Express Checkout only)Website Payments Pro Integration GuideNovember 201013
1Introducing Website Payments ProWebsite Payments Pro API OperationsPayPal API OperationDescriptionDoReauthorizationReauthorize a previously authorized payment.DoVoidVoid an order or an authorization.Recurring Payment API operations:CreateRecurringPaymentsProfileCreate a recurring payments profile.GetRecurringPaymentsProfileDetailsObtain information about a recurring payments , suspend, or reactivate a recurring payments profile.BillOutstandingAmountBill the buyer for the outstanding balance associated with arecurring payments profile.UpdateRecurringPaymentsProfileUpdate a recurring payments profile.DoReferenceTransactionProcess a payment from a buyer’s account, which isidentified by a previous transaction.Recurring Payment Billing Agreement API operations: (Express Checkout only)BAUpdateUpdate or delete a billing agreement.GetBillingAgreementCustomerDetailsObtain information about a billing agreement’s PayPalaccount holder.SetCustomerBillingAgreementInitiates the creation of a billing agreement.Other Express Checkout API operations: (Express Checkout only)AddressVerifyConfirms whether a postal address and postal code matchthose of the specified PayPal account holder. (ExpressCheckout only)CallbackDefine the shipping and handling parameters associated withExpress Checkout.GetBalanceObtain the available balance for a PayPal account. (ExpressCheckout only)GetPalDetailsObtain your Pal ID, which is the PayPal-assigned merchantaccount number, and other information about your account.MassPayMake a payment to one or more PayPal account holders.NOT E :14If you use the Payflow API to process transactions with PayPal as your internetmerchant account, see Website Payments Pro Payflow Edition Developers Guide.November 2010Website Payments Pro Integration Guide
Introducing Website Payments ProWebsite Payments Pro Regional Differences1Website Payments Pro Regional DifferencesWebsite Payments Pro is available in the United States, Canada, and the United Kingdom.Minor regional differences include transaction limits, the kinds of credit cards accepted, andaddress information.The following sections identify regional differences:Credit CardsThe following table lists the credit cards that are accepted:CountryAccepted credit cardsCanada VisaMasterCardNOT E :United Kingdom United States Interac debit cards are not accepted.Visa, including Visa Electron and Visa DebitMasterCardMaestro, including SwitchSoloVisaMasterCardDiscoverAmerican ExpressMasterCard is a registered trademark.NOT E :For direct payment only, American Express restricts direct card acceptance merchantsin certain business categories. Merchants are required to accept the American ExpressCard Acceptance agreement in order to process American Express cards directly.Default Currency and Transaction LimitsThe following table lists the default transaction limit in the default currency for each country:CountryDefault transaction limit in default currencyCanada12,500 CADUnited Kingdom5,500 GBPUnited States10,000 USDNOT E :Contact PayPal if you want to increase transaction limits.Website Payments Pro Integration GuideNovember 201015
1Introducing Website Payments ProWebsite Payments Pro Regional DifferencesCredit Card Currencies by CountryThe following currencies are supported for Direct Payment:Currencies and Currency Codes Supported by Express Checkout and Direct PaymentExpressCheckoutCurrencyCurrencyCodeDirect PaymentCurrency forSpecified Card inUnited StatesDirect PaymentCurrency for SpecifiedCard in United KingdomDirect PaymentCurrency for SpecifiedCard in CanadaAustralianDollarAUDVisa, MasterCardVisa, MasterCardVisa, MasterCardCanadianDollarCADVisa, MasterCardVisa, MasterCardVisa, MasterCardCzech KorunaCZKVisa, MasterCardVisa, MasterCardDanish KroneDKKVisa, MasterCardVisa, MasterCardEuroEURVisa, MasterCardVisa, MasterCardHungarianForintHUFVisa, MasterCardVisa, MasterCardJapanese YenJPYVisa, MasterCardVisa, MasterCardNorwegianKroneNOKVisa, MasterCardVisa, MasterCardNew ZealandDollarNZDVisa, MasterCardVisa, MasterCardPolish ZlotyPLNVisa, MasterCardVisa, MasterCardPound SterlingGBPVisa, MasterCard, Maestro,SoloVisa, MasterCardSingaporeDollarSGDVisa, MasterCardVisa, MasterCardSwedish KronaSEKVisa, MasterCardVisa, MasterCardSwiss FrancCHFVisa, MasterCardVisa, MasterCardU.S. DollarUSDVisa, MasterCardVisa, MasterCardNOT E :16Visa, MasterCardVisa, MasterCardVisa, MasterCardVisa, MasterCard,Discover, AmericanExpressVirtual Terminal for France supports the same currencies as Visa or MasterCard forthe UK. Express Checkout supports all of the countries identified in the table.November 2010Website Payments Pro Integration Guide
Introducing Website Payments ProWebsite Payments Pro Regional Differences1Addresses For Canada, specify the province abbreviation in the State field. For Great Britain, the State field is ignored; howev
If you use the Payflow API to process transactions with PayPal as your internet merchant account, see Website Payments Pro Payflow Edition Developers Guide. Website Payments Pro Overview Website Payments Pro include
