PayPal Website Payments Pro - 2011 - Hosted Solution User's Guide

Website Payments Pro Hosted Solution Integration Guide(Payflow Edition)Last updated: December 2011

Getting Started with Website Payments Pro Hosted SolutionIntroduction to Integrating with Hosted Solution10

2Integrating Your Website Using HTMLThis chapter provides instructions for a simple integration that enables you to begin processing transactions usin

Integrating Your Website Using HTMLSimple Hosted Solution Integration12The default currency is USD. Additionally, you can specify the appropriate HTML

13Integrating Your Website Using HTMLHTML VariablesHTML VariablesThe table below lists the Hosted Solution HTML variables you can use to send in addit

Integrating Your Website Using HTMLHTML Variables14customA free-form field for your own use. This variable is never presented to the buyer and will be

15Integrating Your Website Using HTMLHTML VariablespaymentactionIndicates whether the transaction is for payment on a final sale or an authorisation f

Integrating Your Website Using HTMLHTML Variables16

173Customising Your PayPal Payment PageYou can customise the look and feel of the PayPal payment page in the following two ways: Modifying Your PayPa

Customising Your PayPal Payment PageModifying Your PayPal Account Settings18Billing and Postal InformationPayPal recommends that you display as few op

Customising Your PayPal Payment PageModifying Your PayPal Account SettingsBuyer Authentication ProgramYou can check Maestro, Visa, and MasterCard card

Website Payments Pro Hosted Solution Integration GuideDocument Number: 10112.en_GB-201112© 2011 PayPal, Inc. All rights reserved. PayPal is a register

Customising Your PayPal Payment PageModifying Your PayPal Account Settings20Payment Confirmation PageOnce the transaction is successful, you can choos

Customising Your PayPal Payment PageModifying Your PayPal Account SettingsDesign

Customising Your PayPal Payment PageModifying Your PayPal Account Settings22This page allows you to customise your payment page. You can customise the

Customising Your PayPal Payment PageModifying Your PayPal Account SettingsChoosing a LayoutChoose from the following two design templates or layouts:

Customising Your PayPal Payment PageModifying Your PayPal Account Settings24Template B. Customise the header, background, title, button, and the order

Customising Your PayPal Payment PageModifying Your PayPal Account SettingsCustomising Your LayoutConsider the following when you customise your templa

Customising Your PayPal Payment PageAdding HTML Variables26Adding HTML VariablesThe table below lists the Hosted Solution HTML variables you can use t

Customising Your PayPal Payment PageAdding HTML VariablesshowCustomerNameDisplay customer name (first name and last name). Default Value: true Allow

Customising Your PayPal Payment PageAdding HTML Variables28

4Integrating iFrame in Your WebsitePayPal offers a compact payment form that can be integrated in an iFrame on your website. Since this form is integr

ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5About This Guide. . . . .

Integrating iFrame in Your WebsiteIntegrating iFrame30Integrating iFrameChoose one of the following methods to integrate the compact payment form in y

31Integrating iFrame in Your WebsiteIntegrating iFrame4. Submit the form using JavaScript. For example:<script type="text/javascript">

Integrating iFrame in Your WebsiteIntegrating iFrame32Using URL Returned in the ResponseIn the URL identified in the response as EMAILLINK, add “src”

33Integrating iFrame in Your WebsiteIntegrating iFrameExample of API (Form POST) IntegrationThe complete example as per the above steps is as follows:

Integrating iFrame in Your WebsiteIntegrating iFrame34

5Integrating Your Website Using APIUsing the Button Manager API, you can programmatically create the checkout button that initiates the Hosted Solutio

Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution Checkout36Using the Button Manager API with Hosted Solution Checko

37Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution CheckoutExample of TOKENEMAILLINK=https://securepayments.paypal.

Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution Checkout38Identify the WEBSITECODE in the response and use the cod

39Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution Checkout<input type="hidden" name="subtotal&qu

Contents4Using the Button Manager API with Hosted Solution Checkout . . . . . . . . . . . . . . . 36Using URL Returned in the Response

Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution Checkout40<form method=post action=https://api-3t.paypal.com/nv

41Integrating Your Website Using APIUsing the Button Manager API with Hosted Solution Checkout<input type=hidden size=40 name="L_BUTTONVAR31&q

Integrating Your Website Using APIBMCreateButton API Operation42BMCreateButton API OperationUse the BMCreateButton API operation to create Hosted Solu

43Integrating Your Website Using APIBMCreateButton API OperationBMCreateButton ErrorsError Code Short Message Long Message10001 Internal Error Interna

Integrating Your Website Using APIBMCreateButton API Operation44

456Order ProcessingThis chapter walks you through the end to end order processing experience. It includes information about verifying the status and a

Order ProcessingFulfilling Order46

A 47Obtaining API CredentialsTo use the PayPal APIs, you must have API credentials that identify you as a PayPal account holder who is authorized to

Obtaining API CredentialsEncrypting Your Certificate Into PKCS12 Format484. Under Option 2, click View API Signature.5. Save the values for API Userna

Obtaining API CredentialsImporting Your CertificateImporting Your CertificateFor either PayPal SDK for .NET or Classic ASP, you must download and exec

PPrefaceAbout This GuideThe Website Payments Pro Hosted Solution Integration Guide (Payflow Edition) describes how to integrate with Hosted Solution.

Obtaining API CredentialsImporting Your Certificate50

B 51Error MessagesThe table below lists error codes and the appropriate correction action.TABLE B.1 Error Codes and the Corresponding Corrective Acti

Error Messages5211 Client time-out waiting for response12 Declined Check the credit card number, expiration date, and transaction information to make

53Error Messages31 Error in adding the recurring profile32 Error in modifying the recurring profile33 Error in canceling the recurring profile34 Error

Error Messages54108 Void error. See RESPMSG. Make sure the transaction ID entered has not already been voided. If not, then look at the Transaction D

55Error Messages119 General failure within PIM Adapter120 Attempt to reference a failed transaction121 Not enabled for feature122 Merchant sale total

Error Messages56200 Reauth error201 Order error402 PIM Adapter Unavailable403 PIM Adapter stream error404 PIM Adapter Timeout600 Cybercash Batch Error

57Error Messages1017 Buyer Authentication Service — 3-D Secure error response is invalid. An error response is received and the response is not well f

Error Messages581047 Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid Merchant ID in PARES1048 Buyer Authenticatio

59Error Messages10009 Your payment can't be processed. Please contact the merchant directly with this code.Try again later.10010 Your payment can

PrefaceDocumentation FeedbackP6

Error Messages6010511 Your payment can't be processed. Please contact the merchant directly with this code.Review the integration to ensure that

61Error Messages10540 Please enter a valid address. Transaction was declined by PayPal because of an invalid address. Buyer should provide the correct

Error Messages6210553 Your payment can't be processed. Please contact the merchant directly with this code.Merchant attempted a transaction where

63Error Messages10565 Your payment can't be processed. Please contact the merchant directly with this code.Merchant country is not supported.1056

Error Messages6410713 Please enter a country in the billing address.Buyer should enter a country in the billing address.10714 Please enter a valid nam

65Error Messages10729 Please enter a state in the shipping address.Buyer should enter a state in the shipping address.10730 Please enter a postal code

Error Messages6610752 Your payment can't be processed. Please pay with another card.Transaction was declined by the issuing bank, not PayPal. Buy

67Error Messages12000 Your payment can't be processed. Please contact the merchant directly with this code.This is related to insufficient 3DS pa

Error Messages68

C Currency CodesThe table below lists all the currencies supported by PayPal. TABLE C.1 Currency CodesCurrency Code Country NameAUD Australian Dollar

71Getting Started with Website Payments Pro Hosted SolutionOverviewHosted Solution is the fast and easy way to add transaction processing to your webs

Currency Codes70

71IndexNumerics3-D Secure 7, 19Aaddress_override 13address1 13address2 13API integration 35Bbackground 25billing_address1 13billing_address2 13billing

Index72headerHeight 26HOSTED 35HOSTEDBUTTONID 42HTML integration 11HTTP variables 13, 26IiFrames 29API integration 31manual integration 30Instant Paym

73IndexWWEBSITECODE 32, 38, 42Zzip 15

Getting Started with Website Payments Pro Hosted SolutionHow Hosted Solution Works8 Virtual Terminal - PayPal-hosted online payment form, which enabl

Getting Started with Website Payments Pro Hosted SolutionIntroduction to Integrating with Hosted SolutionTo integrate your website with Hosted Solutio