Home

PayPal Pro - 2012 Integration Guide

1. Below is the iFrame code add the hidden form that is populated with the appropriate PayPal Pro variables including the total amount to be paid and specify the variable TemplateD For example lt form style display none target hss iframe name form_iframe method post action https securepayments paypal com cgi bin acquiringweb gt lt input type hidden name cmd value hosted payment gt lt input type hidden name subtotal value 50 gt lt input type hidden name business value HNZ30ZMCPBAAA gt lt input type hidden name paymentaction value sale gt lt input type hidden name template value templateD gt lt input type hidden name return value https yourwebsite com receipt page html gt lt form gt NoTE If the Frame transactions fail pass the billing address Integrating iFrame in Your Website Er Integrating iFrame 3 Ensure that the target name matches the iFrame name as highlighted in the example below lt iframe name hss iframe width 570px height 540px gt lt iframe gt lt form style display none target hss iframe name form iframe method post action https securepayments paypal com cgi bin acquiringweb gt 4 Submit the form using JavaScript For example lt script type text javascript gt document form_iframe submit lt script gt Example of Manual Integration The complete example as per the above steps is as follows lt
2. populates the buyer s home phone number The three digit prefix for U S phone numbers or the entire non U S phone number for numbers outside the U S excluding the country code This pre populates the buyer s home phone number NOTE Use this variable for non US numbers The four digit phone number for U S phone numbers This pre populates the buyer s home phone number The URL to which PayPal posts information about the transaction in the form of Instant Payment Notification Be sure to enter the complete URL including http or https Indicates whether the transaction is for payment on a final sale or an authorisation for a final sale to be captured later e Allowable Values authorization or sale e Default Value sale Required No Integrating Your Website Using HTML HTML Variables TABLE 2 1 HTML Variables for Settings of Payment Page Continued Variable Description Required return The URL to which the buyer s browser is redirected to No after completing the payment Be sure to enter the complete URL including http or https shipping Shipping charged This amount is added to subtotal for No the total amount state State of the shipping address No subtotal Amount charged for the transaction If shipping handling Yes and taxes are not specified this is the total amount charged tax Taxes charged This amount is added to subtotal for the No total amount zip Postal c
3. document form_iframe submit lt script gt Integrating iFrame in Your Website Integrating iFrame The complete example as per the above steps is as follows Example of API Form POST Integration lt iframe name hss iframe width 570px height 540px gt lt iframe gt WEBSITECODE lt form action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value _s xclick gt lt input type hidden name hosted button id value HSS bXkpgPTNgZi7Cyf IwWTAKWPSDbKziokU gt lt input type image src https ww paypal com i btn btn paynow LG gif border 0 name submit alt PayPal The safer easier way to pay online gt lt img alt border 0 src https ww paypal com i scr pixel gif width 1 height 1 gt lt form gt lt script type text javascript gt document form_iframe submit lt script gt 37 En Integrating iFrame in Your Website Integrating iFrame 38 Integrating Your Website Using API Using the Button Manager API you can programmatically create the checkout button that initiates the PayPal Pro checkout flow on your website You create the checkout button dynamically when the buyer attempts to checkout on your website When the buyer clicks on your checkout button you call the BMCreateButton API operation to create a checkout button and display it on your web page When the buyer clicks on this checkout button he or she is redirected to the
4. gt lt input type hidden name subtotal value 50 gt lt input type hidden name business value HNZ3QZMCPBAAA gt lt input type hidden name paymentaction value sale gt lt input type hidden name return value https yourwebsite com receipt page html gt lt input type submit name METHOD value Pay Now gt lt form gt Em Testing Your Integration in Sandbox Testing Your Integration and Settings Testing Your Settings To change the look and feel of your payment page modify the settings of the Customisation and Settings pages in the Profile section of the Sandbox Test Site For complete details refer to Modifying Your PayPal Account Settings on page 21 54 Order Processing This chapter walks you through the end of end order processing experience It includes information about verifying the status and authenticity of the order before fulfilling it Verifying Transaction Status and Authenticity Validate When the buyer successfully completes a transaction they are redirected either to the PayPal confirmation page or a website you specified in the return variable or on the Settings page in the Profile section as outlined in Simple PayPal Pro Integration on page 15 When the browser is redirected to the website you specified a Transaction ID is appended to it When you receive the redirect URL with Transaction ID you must verify that the order was completed successfully on Pa
5. gt Payments received Gift certificates Payments sent Account withdrawals Advanced search You are ready to test your PayPal Pro integration on the Sandbox Test Site Testing Your Integration in Sandbox Testing Your Integration and Settings Testing Your Integration and Settings The following sections contain information for testing your integration and modifying the look and feel of your payment page in the Sandbox environment e Testing Your Integration e Testing Your Settings Testing Your Integration To test your integration in the Sandbox environment follow the steps specified in Simple PayPal Pro Integration on page 15 For testing purposes you must make the following changes in the Form POST 1 Change the URL to point to the Sandbox environment From lt form action https securepayments paypal com acquiringweb method post gt lt input type hidden name cmd value hosted payment gt to lt form action https securepayments sandbox paypal com acquiringweb method post gt lt input type hidden name cmd value hosted payment gt 2 Change the business value to the Secure Merchant ID value that is specified at the top of the Profile page of the Sandbox Test Site Accordingly the Form POST for testing purposes will be lt form action https securepayments sandbox paypal com acquiringweb method post gt lt input type hidden name cmd value hosted payment
6. 25 single byte characters LASTNAME Payer s last name Character length and limitations 25 single byte characters SUFFIX Payer s suffix Character length and limitations 12 single byte characters BE Optional API Operations DoCapture API 80 Moving from Website Payments Standard to PayPal Pro If you are moving from Website Payment Standard to PayPal Pro you must make the following changes 1 In the FORM tag change the cmd value in the action attribute from lt form action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value xclick gt to lt form action https securepayments paypal com acquiringweb cmd hosted payment method post gt lt input type hidden name cmd value hosted payment gt 2 Change HTML variable amount to subtotal Norte Website Payment Standard has separate values for amount and quantity whereas PayPal Pro uses subtotal only Ensure that the subtotal includes the amount you want to charge the buyer taking into account any applicable discount and the quantity of items 3 If you have already customised your checkout flow such as color and background you will need to redo those settings for PayPal Pro For more information about customising the look and feel of your payment page refer to Chapter 3 Customising Your PayPal Payment Page a Moving from Website Payments Standard to PayPal Pro 82 Sample Code C
7. Buyer should enter a country in the billing address Buyer should enter a valid name in the billing address Buyer should enter a valid state in the billing address Buyer should enter a valid zip code in the billing address Buyer should enter a valid zip code in the billing address Buyer should enter a valid city 89 BE Error Messages TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10719 10720 10721 10722 10723 10724 10725 10726 10727 10728 10729 10730 10731 10732 10733 10734 Error Message Please enter a valid addressee name in the shipping address Please enter a valid address in line 1 of the shipping address Please enter a valid address in line 2 of the shipping address Please enter a valid city in the shipping address Please enter a valid state in the shipping address Please enter a valid postal code in the shipping address Please enter a valid country in the shipping address Please enter a complete shipping address Please enter an address in line 1 of the shipping address Please enter a city in the shipping address Please enter a state in the shipping address Please enter a postal code in the shipping address Please enter a country in the shipping address Please enter a valid addressee name in the shipping address Please enter a valid state in the shipping address
8. Choose a way to pay Pay with my PayPal account The safer easier way to pay PayPal PayPal Pay with a card Cardtype MasterCard Eurocard Card number Expiry date bad gi csc NER Billing Information Select country Choose a Country First Name Last Name Address Line 1 Address Line 2 optional Town City County Postcode Phone number Email address Shipping Address Postal Address Same as billing address Enter a different address Secure payments by PayPal i 28 Order summary Subtotal VAT Postage and packaging Total GBP Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Template C Customise the header background title and the button FIGURE 3 3 Template C PhotoStudio Order summary Subtotal VAT Postage and packaging Total GBP Choose a way to pay gt Pay with my PayPal account PayPal gt Pay with a card Card type Card number Expiry date Select country First Name Last Name Address Line 1 Address Line 2 optional TowniCity County Postcode Phone number Email address Postal Address The safer easier way to pay MasterCard Eurocard a I vy Billing Information Choose a Country Shipping Address O Same as billing address O Enter a different address Secure payments PayPal g 30 Customising Your PayPal Payment Pag
9. Encrypted Website Payments helps secure payment buttons that you generate or write manually Encrypted Website Payments protects the HTML button code that contains pricing information by encrypting it HTML button code that you protect by using Encrypted Website Payments cannot be altered by malicious third parties to create fraudulent payments For detailed information refer to Chapter 8 Protecting Buttons by Using Encrypted Website Payments Example of Initiating PayPal ProCheckout The example shows the NVP parameters using BUTTONCODE TOKEN for creating a URL to initiate the PayPal Pro checkout flow BUTTONCODE TOKEN BUTTONTYPE PAYMENT BUTTONIMAGEURL https www paypal com en US i btn btn billing gif L BUTTONVARO subtotal 11 L BUTTONVAR1 tax 2 L BUTTONVAR2 shipping 3 L BUTTONVAR3 handl ing 4 L BUTTONVAR4 first name Bob L BUTTONVAR5 last_name Jones L_BUTTONVAR6 address1 Gardens L_BUTTONVAR7 address2 99343 L_BUTTONVAR8 city Paris L_BUTTONVAR9 state Alsace L BUTTONVAR10 zip 75002 L_BUTTONVAR11 country FR L BUTTONVAR12 billing first _name BobBilling L BUTTONVAR13 billing last name JonesBilling L BUTTONVAR14 billing address1 5088 061 Craven Hill Gardens L BUTTONVAR15 billing address2 Apt 199343 L BUTTONVAR16 billing city Wolverhampton L BUTTONVAR17 billing state West Midlands L BUTTONVAR18 billing zip W12 4LQ L BUTTONVAR19 billing country GB L BUTTONVAR20 night phone a 408 L BUTTONVAR21 night phone b 398 L BUTTONVA
10. Please enter a valid postal code in the shipping address Corrective Action Buyer should enter a valid addressee name for shipping address Buyer should enter a valid address in line 1 of the ship ping address Buyer should enter a valid address in line 2 of the ship ping address Buyer should enter a valid city in the shipping address Buyer should enter a valid state in the shipping address Buyer should enter a valid postal code in the shipping address Buyer should enter a valid country in the shipping address Buyer should enter a complete shipping address Buyer should enter an address1 in the shipping address Buyer should enter a city in the shipping address Buyer should enter a state in the shipping address Buyer should enter a valid postal code in the shipping address Buyer should enter a country in the shipping address Buyer should enter a valid addressee in the shipping address Buyer should enter a valid state in the shipping address Buyer should enter a valid postal code in the shipping address 90 Error Messages EN TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10735 10736 10744 10745 10746 10747 10748 10750 10751 10752 10754 10755 10756 10759 Error Message Please enter a valid postal code in the shipping address Please enter a valid city and state in the shipping address Please e
11. UK gt Manually create accounts Test Email Access email sent to your test accounts API Credentials Manage API credentials for your test accounts Test Tools Instant Payment Notification IPN simulator 49 50 Testing Your Integration in Sandbox Creating a Preconfigured Account To test your PayPal Pro integration create a preconfigured account using the following steps 1 On the Sandbox Home page under the Test Accounts section and click Create a preconfigured buyer or seller account 2 The Create a Sandbox Test Account page appears as shown below PayPal Sandb Help Profile Log Out an Ox Sandbox Home Test Accounts Test Email Create a Sandbox Test Account API Credentials prng a After creating the account you can delete the account or you can provide additional information in Test Tools the Sandbox Test Site How to automatically create verified accounts Additional resources Country Documentation United Kingdom PayPal Developer Network Account Type Customer Support O Buyer Use to represent your customer s experience O seller Use to represent yourself as the merchant O website Payments Pro Use to represent yourself as a merchant using Pro Login Email This email address is only used inside the Sandbox Password 11111111 Your password must be at least 8 characters Add Credit Card Visa Delta Electron Y Add Bank Account O Yes O no
12. business name Character length and limitations 127 single byte characters Ship To Address Fields TABLE A 16 Ship To Address Fields Field ADDRESSSTATUS SHIPTONAME SHIPTOSTREET SHIPTOSTREET2 SHIPTOCITY SHIPTOSTATE SHIPTOZIP SHIPTOCOUNTRYCODE Description Status of street address on file with PayPal Valid values are e none e Confirmed e Unconfirmed Person s name associated with this address Character length and limitations 32 single byte characters First street address Character length and limitations 100 single byte characters Second street address Character length and limitations 100 single byte characters Name of city Character length and limitations 40 single byte characters State or province Character length and limitations 40 single byte characters Required for U S addresses only U S ZIP code or other country specific postal code Character length and limitations 20 single byte characters Country code Character length and limitations Two single byte characters 78 Optional API Operations DoCapture API Payer Name Fields TABLE A 17 Payer Name Fields Field Description SALUTATION Payer s salutation Character length and limitations 20 single byte characters FIRSTNAME Payer s first name Character length and limitations 25 single byte characters MIDDLENAME Payer s middle name Character length and limitations
13. gt The allowable size of the compact payment form is 570 pixels in width to 540 pixels in height IMPORTANT This option is not supported by Safari browsers Use the Form POST option described below Using Form POST Identify the WEBSITECODE in the response and use the code to create a Pay Now button on your review page When your buyer clicks the button they are redirected to the PayPal hosted payment page Like the URL the button is usable for approximately two hour or until the payment is successful 1 Enter the iFrame tag at the location where you want the compact payment form to appear on your website For example lt iframe name hss iframe width 570px height 540px gt lt iframe gt The allowable size for the compact payment form is 570 pixels in width to 540 pixels in height 2 Insert the following in the iFrame tag WEBSITECODE lt form action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value s xclick gt lt input type hidden name hosted button id value HSS bXkpgPTNgZi7Cyf IwWTAkWPSDbKziokU gt lt input type image src https www paypal com i btn btn paynow LG gif border 0 name submit alt PayPal The safer easier way to pay online gt lt img alt border 0 src https www paypal com i scr pixel gif width 1 height 1 gt lt form gt 3 Submit the form using JavaScript For example lt script type text javascript gt
14. on your website where they can verify the order details and submit the transaction For complete details on PayPal Express Checkout refer to Express Checkout Integration Guide Introduction to Integrating with PayPal Pro After signing up for PayPal Pro follow these steps to integrate your website with 1 Connect your website to PayPal Pro Identify a point in your website checkout flow where you want to place a Pay or similar button that the buyer clicks on to initiate the payment You can do this using HTML or API Clicking on this button redirects the buyer s browser to PayPal s payment page for transaction processing Depending on how you want to integrate follow the steps described in Chapter 2 Integrating Your Website Using HTML or Chapter 5 Integrating Your Website Using API 2 Optionally customise the appearance and content of your PayPal hosted payment page by either sending the appropriate HTTP variables or by editing your PayPal account settings Refer to Chapter 3 Customising Your PayPal Payment Page 3 Optionally test your integration in the PayPal Sandbox environment This step is described in Chapter 6 Testing Your Integration in Sandbox Be Getting Started with PayPal Pro Introduction to Integrating with PayPal Pro 14 Integrating Your Website Using HTML This chapter provides instructions for a simple integration that enables you to begin processing transactions using PayPal Pro No
15. transfer withdrawals for example Character length and limitations 17 single byte alphanumeric characters 63 Optional API Operations GetTransactionDetails API GetTransactionDetails Response NoTE All fields defined in the formal structure of GetTransactionDetails Response are not necessarily returned Data is returned in a response only if PayPal has recorded data that corresponds to the field e Receiver Information Fields e Payer Information Fields e Payer Name Fields e Address Fields e Payment Information Fields e Payment Item Information Fields e Payment Item Fields e Auction Fields e Subscription Term Fields Receiver Information Fields TABLE A 2 Receive Information Fields Field Description RECEIVERMAIL Primary email address of the payment recipient the seller If you are the recipient of the payment and the payment is sent to your non primary email address the value of Receiver is still your primary email address Character length and limitations 127 single byte alphanumeric characters RECEIVERID Unique account ID of the payment recipient the seller This value is the same as the value of the recipient s referral ID 64 Optional API Operations GetTransactionDetails API Payer Information Fields TABLE A 3 Payer Information Fields Field EMAIL PAYERID PAYERSTATUS SHIPTOCOUNTRYCODE PAYERBUSINESS Description Email address of payer Character length and limitat
16. using the Transaction ID we pass back to you with the return URL 24 Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Customisation Customize PayPal Pro Help with this page We ve designed a page for you below You can customize it to reflect your company s brand Here s how 1 Choose a layout With A your page design will be simple in white With B you have the most freedom and can customize your Order Summary With C your Order Summary is atthe top 2 Click the pencil icon to edit areas You can upload your company s logo in the header If you choose Layout B or C you can add color from an entire wheel of colors 3 Save and Publish After you ve finished customizing your page be sure to click Save and Publish You may also Preview your page to check your work as you go Preview Save and Publish Cancel Choose a layout and color Layout A LayoutB Layout C v Eagle Drug Store Choose a way to pay For example only Your Order Summary will appear gt Pay with my PayPal account here The faster safer way to pay PayPal pay um PayPal gt Pay with a Card pu Ei For example only Live pagewill reflect your settings Click Preview to see what the page will look like to your buyers Secure payments by PayPal g Return to Eagle Drug Store Copyright 1999 2010 PayPal All rights reserved Undo Changes Preview Save and Publish Cancel 26 Customising
17. version 26 private key 43 private keys 58 generating 59 public certificate downloading 60 generating 59 removing 60 uploading 59 public key 43 public keys 58 R RefundTransaction API 73 return 19 S save and publish 26 sectionBorder 31 Seller Protection 9 11 settings 23 shipping 19 showBillingAddress 32 showBillingEmail 32 showBillingPhone 32 showCustomerName 32 showHostedThankyouPage 32 showShippingAddress 32 simple integration 15 state 19 subheaderText 32 subtotal 19 T tax 19 template 32 Template A 27 Template B 28 Template C 29 testing your integration 49 title 30 TOKEN 39 token buttons 39 transaction status 55 W WEBSITECODE 36 41 46 Z zip 19 99
18. 9 BUTTONCODE ENCRYPTED 39 BUTTONCODE HOSTED 39 BUTTONCODE TOKEN 39 BUTTONTYPE 45 BUTTONTYPE PAYMENT 39 buyer_email 17 C cancel return 18 cbt 18 city 18 clear text buttons 39 CLEARTEXT 39 country 18 currency codes 95 currency_code 18 custom 18 customising payment page 21 customising your template 30 D DoCapture API 74 E EMAILLINK 36 40 46 ENCRYPTED 39 encrypted buttons 39 encryption 43 encryption process 58 error messages 85 Express Checkout 12 F first name 18 footerTextColor 31 G GetTransactionDetails API 56 63 97 98 Index H handling 18 header 30 headerBgColor 31 headerHeight 31 HOSTED 39 HOSTEDBUTTONID 46 HTML integration 15 HTTP variables 17 31 iFrames 33 API integration 35 manual integration 34 InputFile 62 Instant Payment Notification IPN 55 integration API 39 HTML 15 invoice 18 L L BUTTONVAR 45 last name 18 lc 18 logoFont 31 logoFontColor 31 logoFontSize 31 logolmage 31 logolmagePosition 31 logoText 31 METHOD 45 modifying account settings 21 N night phone a 18 night phone b 18 night phone c 18 notify_url 18 O optional API operations 63 order processing 55 order summary column 30 orderSummaryBgColor 31 orderSummaryBglmage 31 OutputFile 62 overview 9 P pageButtonBgColor 31 pageButtonTextColor 31 pageTitleTextColor 31 paymentaction 18 PCI complicance 9 PPCertFile 62 preconfigured account 49 preview 26 previous
19. Account Balance g0 00 GBP Notes Testing Your Integration in Sandbox Creating a Preconfigured Account 3 Choose Italy from the Country drop down menu 4 Select Website Payments Pro as the Account Type 5 The Login Email and Password fields are pre filled The rest of the fields are optional so make the appropriate selections or accept the defaults NoTE Make a note of the password as you will need it to log into the Sandbox Test Site 6 Click Create Account The following page confirms the creation of the test account PayPal Sandb Help Profile Log Out an Ox Sandbox gt Home Test Email Test Accounts API Credentials gt Your test accounts are listed below You must have a Business account to represent a merchant Test Tools and a Personal account to represent a buyer To simulate an action on the live site PayPal com select a test account and click Enter Sandbox Test Site Additional resources Documentation Create Account Preconfigured Create Manually Website Payments Pro US UK PayPal Developer Network Customer Support Negative Log in Email Payment Review Test Mode Reset O jdoe_1272862469 bizEpaypal com Enabled Disabled N A Business Verified El View Details kisses oeeie Note The login email is a pseudo randomized address which is based on the address you specified Credit card and bank account numbers are also generated randomly which are displayed when
20. Customization page on PayPal com Integrating iFrame in Your Website PayPal offers a compact payment form that can be integrated in an iFrame on your website Since this form is integrated on your website the buyer never leaves your website thereby reducing potential drop offs You can also maintain your checkout look and feel in the master frame that surrounds the compact payment form The credit card fields are part of the compact payment form so you do not have to collect this information separately IMPORTANT Due to security concerns involving iFrame the following browsers are supported and secure to use Internet Explorer 7 0 8 0 and 9 0 Firefox 8 Chrome 4 and 4 1 Safari 4 x and 5 x Transactions involving users of other browsers should not use the iFrame flow or abandon the transaction Additionally there is another risk beyond the iFrame flow should the PayPal iFrame become the source of an attack it would appear that the attack is originating from the merchant site do not use the Frame flow if you wish to avoid this additional risk NOTE Due to spoof concerns the form does not contain any PayPal branding The compact payment form contains the following fields e Credit card number e Expiry date e CVV2 number if applicable based on the card type e Any additional fields required for other card types such as start date and issue number for Maestro or Switch The form also offers the following options
21. Full do not set the Amount NOTE Optional Custom memo about the refund Character length and limitations 255 single byte alphanumeric characters 74 Optional API Operations DoCapture API RefundTransaction Response TABLE A 12 RefundTransaction Response Fields Field REFUNDTRANSACTIONID FEEREFUNDAMT GROSSREFUNDAMT NETREFUNDAMT Description Unique transaction ID of the refund Character length and limitations 17 single byte alphanumeric characters Transaction fee refunded to original recipient of payment Amount of money refunded to original payer Amount subtracted from PayPal balance of original recipient of payment to make this refund DoCapture API Capture an authorized payment e DoCapture Request e DoCapture Response DoCapture Request TABLE A 13 DoCapture Request Fields Field METHOD AUTHORIZATIONID CURRENCYCODE Description Required Must be DoCapture Required The authorisation identification number of the payment you want to capture This is the transaction id returned from DoExpressCheckoutPayment or DoDirectPayment Character length and limitations 19 single byte characters maximum Required Amount to capture Limitations Value is a positive number which cannot exceed 10 000 USD in any currency No currency symbol Must have two decimal places decimal separator must be a period and the optional thousands separator must be a comma Op
22. Hosted Payment Settings column click Website Payment Certificates The Website Payment Certificates page appears 4 Scroll down the page to the Your Public Certificates section and click the Add button The Add Certificate page appears 5 Click Browse and select the public certificate that you want to upload to PayPal from your local computer NoTE The file you upload must be in PEM format 6 Click Add After your public certificate is uploaded successfully 1t appears in the Your Public Certificates section of the Website Payment Certificates page 7 Store the certificate ID that PayPal assigned to your public certificate in a secure place You need the certificate ID that PayPal assigned to encrypt your payment buttons by using the Encrypted Website Payments software provided by PayPal 59 BEE Protecting Buttons by Using Encrypted Website Payments Setting Up Certificates Before Using Encrypted Website Payments Downloading the PayPal Public Certificate from the PayPal Website To download the PayPal public certificate 1 Log in to your PayPal account at https www paypal it Click the Profile subtab In the Seller Preferences column click the Encrypted Payment Settings link Scroll down the page to the PayPal Public Certificate section a YY Click Download and save the file in a secure location on your local computer Removing Your Public Certificate IMPORTANT If you remove your public certificate its ass
23. MP 2010 09 15T00 30 35Z amp CORRELATIONID 2 c9a340a2356 amp ACK Success amp VERSION 65 O amp BUILD 150 0269 Integrating Your Website Using API Bas Using the Button Manager API with PayPal Pro Checkout Example of ENCRYPTED EMAILLINK https www paypal com acquiringweb cmd hosted payment amp business idc S2dautomation 2duk 2dpro 2dt1 40paypal 2ecom amp tax 2 amp ship ping 3 amp business K5HHZSMWMCN58 amp subtotal 11 amp handling 4 amp TIMESTAMP 2010 09 15T00 39 06Z amp CORRELATIONID 23d12cell61f2 amp ACK Success amp VERSION 65 O amp BUILD 150 0269 Example of CLEARTEXT EMAILLINK https www paypal com acquiringweb cmd _hosted payment amp business idc 2dautomation 2duk 2dpro 2dt1 40paypal 2ecom amp tax 2 amp ship ping 3 amp business K5HHZSMWMCN5 8 amp subtotal 11 amp handling 4 amp TIMESTAMP 2010 09 15T00 40 32Z amp CORRELATIONID 64553e7c7c84 amp ACK Success amp VERSION 65 O amp BUILD 1500 269 The button variables control the presentation in the flow and the information that is provided to the buyer initially Because the URL is associated with a PayPal Pro token the URL is usable for approximately two hours after it is created or until the payment is successful Using Form POST Legend Merchant lud PayPal Checkout y Pay Now Pay Now Merchant Merchant PayPal Payment Checkout page Review page page Request Response BMCreateButton Button Code VYEBSITECODE PayPal API Server Ide
24. Pal Pro Customising your hosted payment page Testing your integration in the Sandbox environment Verifying the status and authenticity of the transactions before fulfilling the orders Intended Audience This guide is for merchants and developers that want to integrate with PayPal Pro to add transaction processing to their website Revision History Revision history for Website Payments Pro Hosted Solution Integration Guide TABLE P 1 Revision History Date Description July 2012 Removed references to the deprecated HTML variable shopping url June 2012 e Updated the requirements for the billing address fields in the HTML Variables section e Added a character limitations note to the following sections HTML Variables Adding HTML Variables and BMCreateButton API Operation e Corrected the HTML samples in Chapter 2 and Chapter 5 May 2012 Added IE9 to list of browsers that support iFrame Preface Documentation Feedback Documentation Feedback Help us improve this guide by sending feedback to documentationfeedback paypal com Getting Started with PayPal Pro Overview PayPal Pro is a payment platform allowing merchants to receive payments funded by card or PayPal account This solution is hosted by PayPal You do not have to capture or store credit card information on your website thereby helping towards achieving PCI compliance PayPal Pro is the choice for merchants who prefer a solut
25. PayPal PayPal Pro Integration Guide PayPal Pro Integration Guide Document Number 10116 en_US 201207 O 2012 PayPal Inc All rights reserved PayPal is a registered trademark of PayPal Inc The PayPal logo is a trademark of PayPal Inc Other trademarks 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 Europe S r l et Cie S C A Soci t en Commandite par Actions Registered office 22 24 Boulevard Royal L 2449 Luxembourg R C S Luxembourg B 118 349 Consumer advisory The PayPal payment service is regarded as a stored value facility under Singapore law As such it does not require the approval of 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 caused by errors or omissions or resulting from the use of this document or the information contained in this document or resulting from the application or use of the product or service described herein PayPal Inc
26. PayPal payment page where he or she can complete the payment HTML variables control the presentation of the PayPal payment pages the information contained on the pages and pages to which your buyer can be returned to when leaving the payment pages For a list of HTML variables refer to HTML Variables on page 17 For complete information on the Button Manager API refer to the Button Manager API NVP or Button Manager API SOAP Nore Using the Button Manager API you can programmatically create the checkout button but not manage edit or delete it Button Hosting For PayPal Pro using BUTTONTYPE PAYMENT you can create the following kinds of checkout buttons e Token buttons BUTTONCODE TOKEN are not stored on PayPal They are dynamic and initiate the PayPal Pro checkout flow The parameters associated with this kind of button are secure They have a lifetime of approximately two hours 1f not used e Encrypted buttons BUTTONCODE ENCRYPTED are not stored on PayPal The parameters associated with this kind of button are encrypted You must update the web pages that use an encrypted button each time the button or the associated information changes e Clear text buttons BUTTONCODE CLEARTEXT are not stored on PayPal The parameters associated with this kind of button are not encrypted They can be used dynamically because you can change the value of a parameter anytime However if you use them recognize the ri
27. R22 night phone c 3065 43 44 Integrating Your Website Using API Using the Button Manager API with PayPal Pro Checkout L BUTTONVAR23 notify url www yourcompany com L BUTTONVAR24 custom customl L BUTTONVAR25 cancel return http www cancel return com L BUTTONVAR26 paymentaction sale L BUTTONVAR27 currency code GBP L BUTTONVAR28 invoice 123456789 L BUTTONVAR29 1c GB L BUTTONVAR30 showBillingAddress false L BUTTONVAR31 showShippingAddress false L BUTTONVAR32 showBillingEmail true L BUTTONVAR33 showBillingPhone true L BUTTONVAR34 showCustomerName true L BUTTONVAR35 showCardInfo true L BUTTONVAR36 showHostedThankyouPage true L BUTTONVAR3 7 bn GBD L BUTTONVAR38 cbt Merchant ABCD L BUTTONVAR39 address_override false L BUTTONVAR40 cpp header image Red L BUTTONVAR41 logoText YourCompanyLogo L BUTTONVAR42 logolmage http yourcompanyimages com logo gi f L_BUTTONVAR43 logoImagePosition center L_BUTTONVAR44 logoFont Arial Bold L_BUTTONVAR45 logoFontSize 24px L BUTTONVAR46 logoFontColor f0ff0f L BUTTONVAR47 bodyBgImg sdf L BUTTONVAR48 bodyBgColor AFAFAF L BUTTONVAR49 headerHeight 70px L BUTTONVAR50 headerBgColor 4B6BA1 L BUTTONVAR51 PageTitleTextColor Blue L BUTTONVAR52 PageCollapseBgColor Blue L BUTTONVAR53 PageCollapseTextColor Yellow L BUTTONVAR54 PageButtonBgColor Blue L BUTTONVAR55 PageButtonBgColor Blue L_BUTTONVAR56 orderSummaryBgColor EDF2F7 L_BUTTONVARS7 orderSummaryBgImage http teamworks scr
28. SHI PTOSTATE SHIPTOZIP SHIPTOCOUNTRYCODE SHIPTOPHONENUMBER SHIPTOPHONENUM Description eBay company that maintains this address Valid values are e eBay e PayPal Status of street address on file with PayPal Valid values are e none e Confirmed e Unconfirmed Person s name associated with this address Character length and limitations 32 single byte characters First street address Character length and limitations 100 single byte characters Second street address Character length and limitations 100 single byte characters Name of the city Character length and limitations 100 single byte characters State or province Character length and limitations 40 single byte characters US zip code or other country specific postal code Character length and limitations 40 single byte characters Expanded name of country Character length and limitations 20 single byte characters Country code Character length and limitations two single byte characters Country code Character length and limitations Two single bye characters Optional API Operations GetTransactionDetails API Payment Information Fields TABLE A 6 Payment Information Fields Field TRANSACTIONID PARENTTRANSACTIONID RECEIPTID TRANSACTIONTYPE PAYMENTTYPE ORDERTIME AMT CURRENCYCODE Description Unique transaction ID of the payment Character length and limitations 17 single byte chara
29. Type Fields e Ship To Address Fields e Payer Name Fields Note If you use version 56 0 or later of the DoCapture API only the authorisation ID transaction ID transaction type paymentdate gross amount and payment status are guaranteed to be returned If you need the values of other fields and they are not returned you can obtain their values later by calling GetTransactionDetails or by using the reporting mechanism DoCapture Response Fields TABLE A 14 DoCapture Response Fields Field AUTHORIZATIONID Description The authorisation identification number you specified in the request Character length and limitations 19 single byte characters maximum Payerlnfo Type Fields TABLE A 15 Payerlnfo Type Fields Field EMAIL PAYERID PAYERSTATUS COUNTRYCODE Description Email address of payer Character length and limitations 127 single byte characters Unique PayPal customer account identification number Character length and limitations 13 single byte alphanumeric characters Status of payer Valid values are e verified e unverified Character length and limitations 10 single byte alphabetic characters Payer s country of residence in the form of ISO standard 3166 two character country codes Character length and limitations Two single byte characters we Optional API Operations DoCapture API TABLE A 15 Payerlnfo Type Fields Field BUSINESS Description Payer s
30. Your PayPal Payment Page Modifying Your PayPal Account Settings This page allows you to customise your payment page You can customise the header background title button and the order summary column of your payment page PayPal offers three design templates for you to choose Template A is the default template however you can choose from any of the templates offered Nore Your buyers will not see the payment page until you have completed the HTML integration with your website Preview the design of your payment page You can either change the design of your template or select and customise a different template on this page To make changes left click on the section you are trying to modify or the corresponding Click to Edit button for that section On the pop up that appears click the color selector to change the color or enter the appropriate URL as needed If the buyer pays by logging into PayPal the look and feel of that flow can be customised through the Website Payment Standard customisation options on the Profile page After making the changes click one of the following buttons e Preview Preview the changes you have made to your template before saving and publishing it e Save and Publish Save all the changes you have made and publish the updated template Your buyers will see the updated payment page e Cancel Discard all the changes you have made in this session e Previous Version Discard all changes you h
31. _bg ordersummary jpg L BUTTONVAR58 footerTextColor 333333 L BUTTONVAR59 footerTextlinkColor 00f00f L BUTTONVAR60 template templateC L BUTTONVAR61 return http www yourcompany com Integrating Your Website Using API Bas BMCreateButton API Operation BMCreateButton API Operation Use the BMCreateButton API operation to create PayPal Pro checkout button e BMCreateButton Request e BMCreateButton Response e BMCreateButton Errors BMCreateButton Request The request fields specify the characteristics of your button which include associated menu items related to the button You can specify up to 5 menu items each of which can include up to 10 possible selections BMCreateButton Request Fields NOTE The values you pass must not contain any of these special characters lt gt V Field Description METHOD Required BMCreateButton BUTTONCODE Optional The kind of button code to create It is one of the following values e TOKEN A secure button not stored on PayPal used only to initiate the PayPal Pro checkout flow default for Pay Now button Since version 65 2 e ENCRYPTED An encrypted button not stored on PayPal e CLEARTEXT An unencrypted button not stored on PayPal BUTTONTYPE Required The kind of button you want to create PAYMENT Pay Now button since version 65 2 L_BUTTONVARN Optional HTML standard button variables 45 46 Integrating Your Website Using API BMCreateButton API Oper
32. act the merchant directly with this code Corrective Action Review your integration to ensure that the totals match There is a mismatch in the currency code Contact PayPal with this error code Credit card data is invalid Contact PayPal with this error code 93 NE Error Messages 94 Currency Codes The table below lists all the currencies supported by PayPal TABLE D 1 Currency Codes Currency Code Country Name AUD Australian Dollar CAD Canadian Dollar CHF Swiss Franc CZK Czech Koruna DKK Danish Krone EUR Euro GBP British Pound Sterling HKD Hong Kong Dollar HUF Hungarian Forint JPY Japanese Yen NOK Norwegian Krone NZD New Zealand Dollar PLN Polish Zloty SEK Swedish Krona SGD Singapore Dollar USD U S Dollar BE Currency Codes 96 Index A address override 17 addressl 17 address2 17 API integration 39 B background 30 billing addressl 17 billing address2 17 billing city 17 billing country 17 billing first name 17 billing last name 17 billing state 17 billing zip 17 BMCreateButton API 39 BMCreateButton API Operation 45 BMCreateButton Errors 46 BMCreateButton Request 45 BMCreateButton Request Fields 45 BMCreateButton Response 46 BMCreateButton Response Fields 46 bn 17 bodyBgColor 31 bodyBglmg 31 business 17 button 30 button hosting 39 clear text buttons 39 encrypted buttons 39 token buttons 39 Button Manager API 39 BUTTONCODE 45 BUTTONCODE CLEARTEXT 3
33. ager API with PayPal Pro Checkout 2 2 2 2 40 Using URL Returned in the Response Recommended 40 Using Form POST a gd dee aaa 0 mia an an an ee a a a 8 41 Encrypting Buttons Using Public and Private Key 43 Example of Initiating PayPal ProCheckout 2 22 m nun 43 BMCreateButton API Operation ooa aa 45 BMCreateButton Request 2 22 2 2 nn nn nn 45 BMCreateButton Response nn nn nn nn 46 BMCreateButton Errors 222 22m nn nn nn 46 Chapter 6 Testing Your Integration in Sandbox 49 Creating a Preconfigured Account 2 222 2 2 2 nn nn nn 49 Testing Your Integration and Settings 2 2 2 o nn nn 53 Testing Your Integration 2 2 22m nn nn 53 Testing Your Setlings sees edu a zu a le 54 Chapter 7 Order Processing 2 22 nn nn DD Verifying Transaction Status and Authenticity 2 22 2 2 nn nn nn 55 Validate Instant Payment Notification IPN 22 2 2 un nn nn 55 Execute a GetTransactionDetails API Call 2 2 2 aaa 56 Fulfilling Order 2 2 22 000 0m ne nn 56 Chapter 8 Protecting Buttons by Using Encrypted Website Payments 57 Public Key Encryption Used by Encrypted Website Payments 58 Setting Up Certificates Before Using Encrypted Website Payments 58 Generating Your Private Key Using OpenSSL 0 o 59 Generating Your Public Certificate Using OpenSSL 59 Uploading Your P
34. ation BMCreateButton Response The response contains an ID if the button is hosted on PayPal and code for HTML in a website and for a link in email BMCreateButton Response Fields Field Description WEBSITECODE HTML code for web pages EMAILLINK Code for URL for the PayPal Pro checkout flow HOSTEDBUTTONID ID of a PayPal Pro token BMCreateButton Errors Error Code Short Message Long Message Correcting This Error 10001 Internal Error Internal Error 11923 Invalid Argument The button image value specified is invalid 11924 Invalid Argument The button image URL specified is invalid 11925 Invalid Argument The button type specified is invalid 11926 Invalid Data One of the parameters specified using Button Var is invalid 11927 Invalid Argument The buy now button text specified is invalid 11928 Invalid Argument The email or merchant ID specified is invalid 11929 Invalid Data A cart button must have an item name and amount specified 11931 Invalid Argument The subscription button text specified is invalid 11932 Invalid Data You must specify a corresponding number of entries for option names and selections 11933 Invalid Data You cannot skip index numbers for option selections Option selections must be specified sequentially Integrating Your Website Using API Bas BMCreateButton API Operation Error Code Short Message Long Message Correcting This Error 11934 Invalid Data You must spec
35. ave made since the last time you saved the template Your buyers will see the last saved template NoTE You must make all modifications including changing templates within the same session otherwise all changes will be lost and you will have to redo your changes If the session times out the design of the template will remain at the version that was last published Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Choosing a Template Choose from the following three design templates e Template A e Template B e Template C Template A Selected by default you can customise the header FIGURE 3 1 Template A PhotoStudio Choose a way to pay Order summary Subtotal Pay with my PayPal account VAT Postage and packaging The safer easier way to pay PayPal Total GBP rar Paypalis gt Pay with a card Card type MasterCard Eurocard Card number Expiry date csc What is this Billing Information Selectcountry Choose a Country First Name Last Name Address Line 1 Address Line 2 optional Town City County Postcode Phone number Email address Shipping Address Postal Address O Same as billing address O Enter a different address payments by PayPal p Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Template B Customise the header background title button and the order summary column FIGURE 3 2 Template B PhotoStudio
36. because your customer did not include a confirmed shipping address and your Payment Receiving Preferences is set such that you want to manually accept or deny each of these payments To change your preference go to the Preferences section of your Profile authorisation The payment is pending because it has been authorised but not settled You must capture the funds first echeck The payment is pending because it was made by an eCheck that has not yet cleared intl The payment is pending because you hold a non U S account and do not have a withdrawal mechanism You must manually accept or deny this payment from your Account Overview multi currency You do not have a balance in the currency sent and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment You must manually accept or deny this payment order The payment is pending because it is part of an order that has been authorised but not settled paymentreview The payment is pending while it is being reviewed by PayPal for risk unilateral The payment is pending because it was made to an email address that is not yet registered or confirmed verify The payment is pending because you are not yet verified You must verify your account before you can accept this payment other The payment is pending for a reason other than those listed above For more information contact PayPal customer service REASONCODE The reason fo
37. ble and value must be on a separate line as in the following example Note The cert_id variable identifies the public certificate you uploaded to PayPal website cert _id Z24MFU6DSHBXQ cmd _xclick business salesecompany com item_number 1234 custom sc id 789 amount 500 00 currency code USD tax 41 25 shipping 20 00 address override true address1 123 Main St city Austin state TX zip 94085 country US no note 1 cancel return http www company com cancel htm 2 Runthe encryption software using the appropriate syntax as shown below Java PPEncrypt CertFile PrivKeyFile PPCertFile InputFile OutputFile Sandbox Microsoft Windows java ButtonEncryption CertFile PKCS12File PPCertFile Password InputFile OutputFile Sandbox 61 62 Protecting Buttons by Using Encrypted Website Payments Setting Up Certificates Before Using Encrypted Website Payments where the argument is CertFile The pathname to your own public certificate PKCS12File The pathname to the PKCS12 format of your own public certificate PPCertFile The pathname to a copy of the PayPal public certificate Password The passphrase to the PKCS12 format of your own public certificate InputFile The pathname to file containing the non encrypted Website Payments HTML Form variables OutputFile A file name for the encrypted output Sandbox The optional word Sandbox that lets you test payment buttons in the PayPal Sandbox that you pro
38. cal transactions in quick succession Excessive CVV failures on the credit card Buyer should try a different card None this is a PayPal internal error Transaction was declined by PayPal Contact PayPal with this error code Buyer should give the correct start date for their credit card Transaction was rejected by PayPal because of excessive failures over a short period of time for this credit card Contact PayPal with this error code Transaction was declined by PayPal Contact PayPal with this error code Transaction was declined because the merchant does not have a valid commercial entity agreement on file with PayPal Contact PayPal with this error code Transaction was declined because the CVV entered does not match the credit card Transaction was declined by the issuing bank not PayPal Buyer should attempt another card Transaction was declined by the issuing bank not PayPal Buyer should attempt another card Transaction was declined by the issuing bank because of an expired credit card Buyer should attempt another card 92 Error Messages EN TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 15008 15009 99998 Error Message Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please cont
39. card statement If a value for the soft descriptor field is provided the full descriptor displayed on the customer s statement has the following format lt PP PAYPAL gt lt Merchant descriptor as set in the Payment Receiving Preferences gt lt 1space gt lt soft descriptor gt The soft descriptor can contain only the following characters e Alphanumeric characters e dash e asterisk e period e space If you use any other characters such as an error code is returned The soft descriptor does not include the phone number which can be toggled between the merchant s customer service number and PayPal s customer service number The maximum length of the total soft descriptor is 22 characters Of this either 4 or 8 characters are used by the PayPal prefix shown in the data format Thus the maximum length of the soft descriptor passed in the API request is 22 len lt PP PAYPAL gt len lt Descriptor set in Payment ReceivingPreferences gt 1 For example assume the following conditions e The PayPal prefix toggle is set to PAYPAL in PayPal s admin tools e The merchant descriptor set in the Payment Receiving Preferences is set to EBAY e The soft descriptor is passed in as JanesFlowerGifts LLC The resulting descriptor string on the credit card would be PAYPAL EBAY JanesFlow 76 DoCapture Response Optional API Operations DoCapture API e DoCapture Response Fields e Payerlnfo
40. cters Parent or related transaction identification number This field is populated for the following transaction types e Reversal Capture of an authorised transaction e Reversal Reauthorisation of a transaction e Capture of an order The value of ParentTransactionID is the original OrderlD Authorisation of an order The value of ParentTransactionID is the original OrderID e Capture of an order authorisation e Void of an order The value of ParentTransactionID is the original OrderlD Character length and limitations 16 digits in xxxX XXXX XXXX XXXX format Receipt identification number Character length and limitations 16 digits in XXxX XXXX XXXX XXXX format The type of transaction Valid values e cart e express checkout Character length and limitations 15 single byte characters Indicates whether the payment is instant or delayed Character length and limitations Seven single byte characters Valid values e none e echeck e instant Time date stamp of payment For example 2006 08 15T17 23 15Z The final amount charged including any shipping and taxes from your Merchant Profile Character length and limitations Does not exceed 10 000 USD in any currency No currency symbol Regardless of currency decimal separator is a period and the optional thousands separator is a comma Equivalent to nine characters maximum for USD A three character currency code 68 Optional API Operati
41. dden name business value HNZ3QZMCPBAAA gt lt input type hidden name paymentaction value sale gt lt input type hidden name return value https yourwebsite com receipt page html gt lt input type submit name METHOD value Pay gt lt form gt The bold text is the value for the corresponding variable It is recommended that you enclose the values in quotes For detailed information on these values refer to Table 2 1 HTML Variables for Settings of Payment Page 2 Output the HTML text into your website at the point where buyers will proceed with their checkout 3 Open your checkout page and test the button to ensure that 1t opens the PayPal payment page You can also use the PayPal sandbox environment to test your integration For complete information on testing your integration in the PayPal Sandbox environment refer to Chapter 6 Testing Your Integration in Sandbox Integrating Your Website Using HTML HTML Variables HTML Variables The table below lists the PayPal Pro HTML variables you can use to send in additional transaction information along with your web request For a list of HTML variables that you can use to customise the look and feel of your payment page refer to Table 3 1 HTML Variables for Look and Feel of Payment Page Norte The values you pass must not contain any of these special characters lt gt NOTE Some merchants are required to pass billing information
42. e Modifying Your PayPal Account Settings Customising Your Template Consider the following when you customise your template Header applicable to Template A B and C By default the business name from your profile is shown in the header You can change the following Header height and color Font type size and color Swap between displaying the business name or the business logo image Position of the business name or the logo NoTE We recommend that you host your images on a secure server https to avoid the security dialog window that may hurt conversion Background applicable to Template B and C You can change the following Background color Background image URL Title and Button applicable to Template B and C You can change the following Header color Title bar color and title text color Button color and button text color Order Summary Column applicable to Template C You can change the following Column color Image URL Customising Your PayPal Payment Page Adding HTML Variables Adding HTML Variables The table below lists the PayPal Pro HTML variables you can use to customise the look and feel of your payment page Norte The values you pass must not contain any of these special characters lt gt TABLE 3 1 HTML Variables for Look and Feel of Payment Page Variable bodyBgColor bodyBgImg footerTextColor headerBgColor headerHeig
43. e Remove the Pay with PayPal button Although the form offers the option to pay using PayPal account by default you can contact your account manager or customer support to turn this option off e Manually customize the color of the Pay Now button IMPORTANT The compact payment form does not display the buyer s billing address even if showBillingAddress true is passed However for some merchants 1t may be necessary to pass the billing address to successfully process the transactions 34 Integrating iFrame in Your Website Integrating Frame Integrating iFrame Choose one of the following methods to integrate the compact payment form in your website e Manual Integration e API Integration IMPORTANT For optimal performance PayPal recommends that you load the iFrame asset before other assets such as images and JavaScripts If there are too many assets running on your payment page when you load iFrame the request for the iFrame may not be placed or might get delayed This may result in the buyers seeing a blank iFrame Manual Integration To manually integrate the compact payment form in your website perform the following steps 1 Enter the iFrame tag at the location where you want the compact payment form to appear on your website For example lt iframe name hss iframe width 570px height 540px gt lt iframe gt The allowable size for the compact payment form is 570 pixels in width to 540 pixels in height
44. e billing address Please enter a valid state in the billing address Please enter a valid ZIP code in the billing address Please enter a valid country in the billing address Please enter a complete billing address Please enter an address in line 1 of the billing address Please enter a city in the billing address Please enter a state in the billing address Please enter a valid postal code in the billing address Please enter a country in the billing address Please enter a valid name in the billing address Please enter a valid state in the billing address Please enter a valid postal code in the billing address Please enter a valid postal code in the billing address Please enter a valid city in the billing address Corrective Action Buyer should enter a valid address in line 1 of the bill ing address Buyer should enter a valid address in line 2 of the bill ing address Buyer should enter a valid city in the billing address Buyer should enter a valid state in the billing address Buyer should enter a valid zip code in the billing address Buyer should enter a valid country in the billing address Buyer should enter the complete billing address Buyer should enter an address in line 1 of the billing address Buyer should enter a city in the billing address Buyer should enter a state in the billing address Buyer should enter a valid zip code in the billing address
45. ebsite follow either Billing phone number the Paypal Pro Guide Italian orthe Paypal Pro Guide Enalish Billing email address Shipping address Required for our Seller Protection Policy How do you want to display payment confirmation On a PayPal page that shows the payment is complete Enter a URL that will return customers to your site http www paypal com C On my company s confirmation page Remember to include a message on this page that the payment is complete sae Cancel This page allows you to select the information you want to collect and display on your payment page and where you want to display the payment confirmation Although we offer many options on this page we recommend that you display as few options as possible on the payment page For example you may have already collected shipping address on your own website in order to calculate the shipping cost and passed it on to PayPal s payment page Therefore it is not necessary to show this option on the payment page again You could have information that has already been collected on your website but you may want to pass it to PayPal and display it on the hosted payment page again This information will be pre filled and editable on this page sa Customising Your PayPal Payment Page Modifying Your PayPal Account Settings What information do you want to show on your PayPal Pro payment page You can select the fields that are displayed on yo
46. ed by PayPal because of possible fraudulent activity on the IP address Contact PayPal with this error code None this is a PayPal internal error Merchant account attempting the transaction is not a business account at PayPal Check your account settings Merchant account attempting the transaction is not able to process Direct Payment transactions Contact PayPal with this error code Access to Direct Payment was disabled for your account Contact PayPal with this error code 87 BE Error Messages TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10552 10553 10557 10558 10561 10562 10563 10564 10565 10566 10570 10701 Error Message Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Please enter a complete billing address Please enter a valid year for the credit card expiration date Please enter a valid month for the credit card expiration date Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payme
47. edirect to validate the authenticity of the order For complete details refer to GetTransactionDetails API on page 63 Fulfilling Order After you have verified the authenticity of the payment amount and status you can fulfil the order by shipping the item to the buyer Norte To benefit from PayPal s Seller Protection the item must be shipped to the address specified on the PayPal payment page or communicated to PayPal Otherwise the item is not eligible for Seller Protection For more information refer to Seller Protection on page 11 56 Protecting Buttons by Using Encrypted Website Payments Using Encrypted Website Payments helps secure payment buttons that you generate or write manually Encrypted Website Payments protects the HTML button code that contains pricing information by encrypting it HTML button code that you protect by using Encrypted Website Payments cannot be altered by malicious third parties to create fraudulent payments Encrypted Website Payments relies on standard public key encryption for protection With public and private keys you can dynamically generate HTML code for payment buttons and encrypt the payment details before displaying the buttons on your website The below table illustrates the sequence of actions that occur with payment buttons protected by using Encrypted Website Payments TABLE 8 1 How Encrypted Website Payments Works Website Actions Generate a public key for t
48. egrate with Instant Payment Review Payment Review is a feature that identifies high risk transactions and notifies you so that you can hold shipments until the risk has been evaluated by PayPal It is made available to all merchants and it reduces seller loss and makes the transactions eligible for Seller Protection When a transaction is initiated PayPal runs additional buyer risk assessment PayPal scores all transactions Authorization and Sale instantly and flags high risk transactions as Under Review and you are immediately notified You should not ship merchandise or in the case of electronic media you should not allow download access while the payment is under review PayPal fraud agents review the transaction within 24 hours and update the order as Completed released as safe by Payment Review or Reversed rejected by Payment Review For risky transactions PayPal advises you to not ship the items until the transaction has been determined as Completed Payments that are completed are eligible for PayPal s Seller Protection You can determine the status of a payment in the following ways e Logging into https www paypal com and viewing the status information in the Transaction History e Checking email sent by PayPal e Reviewing the Instant Payment Notification IPN message 12 Getting Started with PayPal Pro PayPal Express Checkout Transaction Processing e Verifying the status of a transaction programatically To chec
49. f they have one 3 Ifthe transaction is successful the buyer either sees PayPal s confirmation page or is redirected to a URL you specify If the transaction is unsuccessful an error message is displayed and the buyer can rectify the error and retry the transaction You can specify the content of the payment page and configure its appearance to reflect the look and feel of your website including your logo 10 Getting Started with PayPal Pro Seller Protection Seller Protection If PayPal is the only payment method on your website transactions processed through Int gral Evolution are eligible for PayPal s Seller Protection It covers payments done through the payment flow of your website for items sold domestically and internationally These items can be purchased using a credit card or through the PayPal account To benefit from Seller Protection the purchased item must be shipped to the address you communicated to PayPal For this you must perform the following tasks e Send all the details of the billing and shipping address provided by the buyer in the Form POST e Setthe address override variable to true and showShippingAddress variable to false or unselect it in the Settings page on your Profile page IMPORTANT Conditions apply To see all conditions please refer to PayPal e Terminal and PayPal Int gral Evolution User Agreement Instant Payment Review To take advantage of Seller Protection you must int
50. form gt type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden type hidden Moving from Website Payments Standard to PayPal Pro EN name city value San Jose gt name state value CA gt name zip value 95121 gt name country value US gt name billing first name value John gt name billing last name value Doe gt name billing addressi value 345 Lark Ave gt name billing city value San Jose gt name billing state value CA gt name billing zip value 95121 gt name billing country value US gt name bn value CC Partner H3S gt name notify url value https www paypal com IPN gt type image name submit border 0 src https www paypal com img gif gt BE Moving from Website Payments Standard to PayPal Pro 84 Error Messages The table below lists error codes and the appropriate correction action TABLE C 1 Error Codes and the Corresponding Corrective Actions Error Code 10001 10004 10009 10010 10413 10500 10501 10502 10504 Error Message Your payment can t be processed right now Please try again later Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment ca
51. gt lt form gt Example of CLEARTEXT WEBSITECODE lt form action https www paypal com acquiringweb method post gt lt input type hidden name cmd value hosted payment gt lt input type hidden name business value testlepaypal com gt lt input type hidden name tax value 2 gt lt input type hidden name shipping value 3 gt lt input type hidden name business value K5HHZSMWMCN58 gt lt input type hidden name subtotal value 11 gt lt input type hidden name paymentaction value sale gt lt input type hidden name handling value 4 gt lt input type image src https www paypal com en US i btn btn auto billing LG gif border 0 name submit alt PayPal The safer easier way to pay online gt lt img alt border 0 src https ww paypal com en GB i scr pixel gif width 1 height 1 gt lt form gt Integrating Your Website Using API Using the Button Manager API with PayPal Pro Checkout NoTE The PayPal payment page displays a button identified as Pay Now to complete the checkout flow The Pay Now button on the PayPal page is different than the Pay Now button created by the BMCreateButton API operation on the review page You may need to change the URL for the latter in BUTTONIMAGEURL to avoid confusion If a URL is not specified in BUTTONIMAGEURL then the default Pay Now is used for the button Encrypting Buttons Using Public and Private Key Using
52. he website upload it to PayPal and download the PayPal public certificate to the website NoTE Do this action only once when you first integrate PayPal Pro with your website Generate HTML code for a payment button Encrypt the generated code by using the PayPal public key and then signing the encrypted code with the website s private key Publish the signed encrypted HTML code for the payment button to the website Buyer Action Click the published PayPal payment button PayPal Action Check the authenticity of the data by using the website s public key which was previously uploaded to PayPal Decrypt the protected button code by using the PayPal private key Redirect the payer s browser to the appropriate PayPal checkout experience as specified in the HTML variables of the decrypted button code 58 Protecting Buttons by Using Encrypted Website Payments Public Key Encryption Used by Encrypted Website Payments Public Key Encryption Used by Encrypted Website Payments Encrypted Website Payments uses public key encryption or asymmetric cryptography which provides security and convenience by allowing senders and receivers of encrypted communication to exchange public keys to unlock each others messages The fundamental aspects of public key encryption are e Public keys Public keys are created by receivers and are given to senders before they encrypt and send information Public certifica
53. he email address associated with your PayPal account e paymentaction Indicates whether the transaction is for payment on a final sale or an authorisation for a final sale to be captured later The default currency is USD Additionally you can specify the appropriate HTML variables listed in Table 2 1 HTML Variables for Settings of Payment Page to customise the information collected on the payment page or Table 3 1 HTML Variables for Look and Feel of Payment Page to customise the look and feel of the page If the payment is successful then the buyer either sees the PayPal confirmation page or is redirected to the URL you specify in your configuration 16 Integrating Your Website Using HTML Simple PayPal Pro Integration The return URL is appended with a Transaction ID on the query string during the redirect back from the payment page to your website This Transaction ID can be used to retrieve the status and verify the authenticity of the transaction For detailed information on verifying the authenticity of the transaction before fulfilling the order refer to Chapter 7 Order Processing Sample Integration Below is an example of a simple PayPal Pro integration 1 Sample PayPal Pro Form POST lt form action https securepayments paypal com cgi bin acquiringweb method post gt lt input type hidden name cmd value hosted payment gt lt input type hidden name subtotal value 50 gt lt input type hi
54. hidden name country value US gt lt input type hidden name bn value CC Partner WPS gt lt input type hidden name notify url value https www paypal com IPN gt lt input type image name submit border 0 src https www paypal com img gif gt lt form gt Sample PayPal Pro Code lt form action https securepayments paypal com acquiringweb cmd hosted payment method post gt lt input type hidden name cmd value hosted payment gt lt input type hidden lt input type hidden type hidden type hidden type hidden type hidden nable override name business value HN230ZMCPBAAA gt name subtotal value 20 gt name paymentaction value sale gt name currency code value USD gt name invoice value MEM32507725 gt name template value TemplateB gt of payer s stored PayPal address gt lt input type hidden name address override value true gt lt input type hidden name showShippingAddress value false gt lt Set prepopulation variables to override stored address gt lt input type hidden name first_name value John gt lt input type hidden name last_name value Doe gt lt input type hidden name address1 value 345 Lark Ave gt lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt inpu lt input cm ct ct ct oct ct oct toc ct oct ct lt
55. ht logoFont logoFontColor logoFontSize logoImage logoImagePosition logoText orderSummaryBgColor orderSummaryBgImage pageButtonBgColor pageButtonTextColor pageTitleTextColor sectionBorder Description Color of the surrounding background of the payment page Image of the surrounding background of the payment page The file extension can be gif jpg jpeg or png format Color of the footer text Color of the header background Height of the header banner It can be from 50 to 140 pixels The width cannot be changed It is always 940 pixels Font type of the logo text Color of the logo text Font size of the logo text Image displayed in the logo The acceptable file extension formats are gif jpg jpeg or png The width of the image cannot be more than 940 pixels Position of the image in the logo Business name displayed on your profile page This field is editable and text specified here is displayed on the header 1f logolmage is not specified Color of the Order Summary column on the right side of the payment page You cannot change the color of the Order Summary box Background image you can put in the Order Summary Column The acceptable file extension formats are gif jpg jpeg or png Background color of the Pay Now button Color of the Pay Now button You cannot change the text of the button Color of the text used in the title of the page Text that says Choose a way to
56. iframe name hss iframe width 570px height 540px gt lt iframe gt lt form style display none target hss iframe name form_iframe method post action https securepayments paypal com cgi bin acquiringweb gt lt input type hidden name cmd value hosted payment gt lt input type hidden name subtotal value 50 gt lt input type hidden name business value HNZ3QZMCPBAAA gt lt input type hidden name paymentaction value sale gt lt input type hidden name template value templateD gt lt input type hidden name return value https yourwebsite com receipt page html gt lt form gt lt script type text javascript gt document form_iframe submit lt script gt API Integration To integrate the compact payment form in your website using the API refer to Using the Button Manager API with PayPal Pro Checkout on page 40 NOTE Use template templateD for this type of integration There are two options in the response to initiate the PayPal Pro payment flow e Using URL Returned in the Response e Using Form POST 35 36 Integrating iFrame in Your Website Integrating Frame Using URL Returned in the Response In the URL identified in the response as EMAILLINK add src for iFrame as per the example below to redirect the buyer and initiate the payment flow lt iframe src https www paypal com hosted button id HSS width 570px height 540px gt lt iframe
57. ify the same number of entries for option prices and selections 11936 Invalid Data You cannot specify both an item price and prices for individual selections within an option 11937 Invalid Argument A text box name specified is invalid Text box names must not exceed 64 characters 11938 Invalid Argument The button code value specified is invalid 11940 Invalid Argument An option name specified is invalid Option names must not exceed 64 characters 11941 Invalid Argument An option selection value specified is invalid Option selection values must not exceed 64 characters 11942 Invalid Argument An option price value specified is invalid Make sure any punctuation marks are in the correct places 11943 Invalid Argument The button country value specified is invalid 11945 Invalid Data The button country and language code combination specified is invalid 11947 Invalid Argument The tax rate specified is invalid Make sure any punctuation marks are in the correct places and value specified is in the range 0 0 to 100 11948 Invalid Argument The amount specified is invalid Make sure any punctuation marks are in the correct places 12210 Invalid Argument The currency code value specified is invalid 13117 Invalid Argument Subtotal amount is not valid 13118 Invalid Argument Tax amount is not valid 13119 Invalid Argument Handling amount is not valid 13120 Invalid Argument Shipping amount is not valid 47 el Integrating You
58. ion where all financial details are handled by PayPal In addition to PayPal Pro PayPal recommends that you implement the PayPal Express Checkout button on your website The button appears much earlier in the payment flow and glves existing PayPal account holders the opportunity to use PayPal thereby increasing the transaction completion rate Features and Benefits Here are the features and benefits of PayPal Pro e PCI compliance Payment Card Industry PCI Data Security Standards DSS is a global security standard which applies to all businesses that collect store process or transmit card holder information You can use PayPal s hosted payment page as part of the PCI compliance solution for your business NoTE PayPal Pro implementation helps achieving PCI compliance and does not necessarily guarantee it e Supports iFrame PayPal offers a compact payment form that can be integrated in an iFrame on your website The buyer completes the payment on your website and you can maintain the checkout look and feel in the master frame that surrounds the compact form The credit card fields are part of the compact form so you do not have to collect this information separately For more information refer to Chapter 4 Integrating iFrame in Your Website e Soluzione di Pagamento Telefonico PayPal hosted online payment form which enables you to accept phone fax mail orders for all major credit cards e Seller Protection This pr
59. ions 127 single byte characters Unique PayPal customer account identification number Character length and limitations 13 single byte alphanumeric characters Status of payer Valid values are e verified e unverified Character length and limitations 10 single byte alphabetic characters Payer s country of residence in the form of ISO standard 3166 two character country codes Character length and limitations Two single byte characters Payer s business name Character length and limitations 127 single byte characters Payer Name Fields TABLE A 4 Payer Name Fields Field SALUTATION FIRSTNAME MIDDLENAME LASTNAME Description Payer s salutation Character length and limitations 20 single byte characters Payer s first name Character length and limitations 25 single byte alphanumeric characters Payer s middle name Character length and limitations 25 single byte alphanumeric characters Payer s last name Character length and limitations 25 single byte alphanumeric characters 66 Optional API Operations GetTransactionDetails API TABLE A 4 Payer Name Fields Field SUFFIX Description Payer s suffix Character length and limitations 12single byte alphanumeric characters Address Fields TABLE A 5 Address Fields Field ADDRESSOWNER ADDRESSSTATUS SHIPTONAME SHIPTOSTREET SHI PTOSTREET2 SHIPTOCITY
60. k the initial status of a transaction use any of the following API operations DoExpressCheckoutPayment DoReferenceTransaction DoAuthorization DoReauthorization You can check the subsequent status of a transaction programatically by calling the GetTransactionDetails API operation For more information refer to GetTransactionDetails API on page 63 NOTE You must use version 58 0 or of the API to obtain the initial status information provided by DoExpressCheckoutPayment DoReferenceTransaction DoAuthorization or DoReauthorization To use payment review with DoExpressCheckoutPayment DoReferenceTransaction DoAuthorization and DoReauthorization Payment API operations you must 1 Check the payment status in the response to the API operation specifically check whether PaymentStatus is set to Pending 2 Ifthe PaymentStatus is set to Pending check whether the PendingReason is set to PaymentReview because there are other reasons that a transaction may become pending For example an unsettled authorization s PaymentStatus is set to Pending however its PendingReason is set to authorization which is not related to payment review If PaymentStatus is set to Pending and the PendingReason is set to PaymentReview you should not ship merchandise or in the case of electronic media you should not allow download access Because the payment status will change after review you must periodically check the paymen
61. lease enter a first name Please enter a last name Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed right now Please try again later Please enter a valid amount Please enter a valid card number Your payment can t be processed Please contact the merchant directly with this code Please enter a valid credit card number Your payment can t be processed Please contact the merchant directly with this code Corrective Action Your PayPal account is restricted Contact PayPal with this error code Expiration date must be in the correct format PayPal was unable to determine the IP address of the buyer Review the integration to ensure that a valid PaymentAction value is supplied First name of the buyer is required Last name of the buyer is required Amounts supplied do not match Try again later Verify your integration to ensure that the amounts are not zero Credit card entered is invalid Credit card entered is currently restricted by PayPal Contact PayPal with this error code Credit card entered is invalid All shopping cart items must be in the same currency 86 Error Messages EN TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10539 10540 10541 10542 10544 10545 10546 10547 10548 10549 10550 Error Message Your payment can t be p
62. n of the Profile page on PayPal com Email address of the buyer Required Conditional No Conditional Conditional Conditional Conditional Conditional Conditional No 17 18 Integrating Your Website Using HTML HTML Variables TABLE 2 1 HTML Variables for Settings of Payment Page Continued Variable cancel return cbt city country currency code custom first name handling invoice last name 1c night phone a night phone b night phone c notify url paymentaction Description The browser will be redirected to this URL if the buyer clicks Return to Merchant link Be sure to enter the complete URL including http or https Sets the text for the Return to Merchant link on the PayPal confirmation page For business accounts the return button displays your business name in the place of the word Merchant by default City name of shipping address Country name of shipping address The currency of the payment The default is USD Pass through variable never presented to the payer First name of person the item is being shipped to Handling charged This amount is added to subtotal for the total amount Order number in the merchant s ordering invoice system Last name of person the item is being shipped to The language of the login or sign up page The area code of the U S phone number or the country code of the phone number outside the U S This pre
63. n t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your credit card has expired Please pay with a valid card Please enter a valid card security code Corrective Action Try again later There is a problem with your integration Check the parameters that you have supplied Try again later Provide a valid invoice ID Subtotal shipping handling and tax Review the totals in your integration You have not agreed to the billing agreement Billing agreement is disabled or inactive Credit card used has expired CVV provided is invalid The CVV is between 3 4 digits long 85 BE Error Messages TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10507 10508 10509 10511 10512 10513 10520 10523 10525 10527 10534 10535 10536 Error Message Your payment can t be processed Please contact the merchant directly with this code Please enter a valid card expiration date Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code P
64. nal transaction Character length and limitations 127 single byte alphanumeric characters Custom field you set in the original transaction Character length and limitations 127 single byte alphanumeric characters Memo entered by your customer in PayPal Website Payments note field Character length and limitations 255 single byte alphanumeric characters Amount of tax charged on payment 72 Optional API Operations GetTransactionDetails API Payment Item Fields TABLE A 8 Payment Item Fields Field L DESCn L NUMBERn L QTYn L AMTn L_OPTIONSNAMEn L OPTIONSVALUEn Description Amount of tax charged on payment These parameters must be ordered sequentially beginning with 0 for example L_DESCO L DESCI Item number set by you If this was a shopping cart transaction PayPal appends the number of the item to the HTML item_number variable For example item_numberl item_number 2 and so forth Character length and limitations 127 single byte alphanumeric characters These parameters must be ordered sequentially beginning with 0 for example L NUMBERO L NUMBERI Quantity set by you or entered by the customer Character length and limitations no limit Cost of item These parameters must be ordered sequentially beginning with 0 for example L_AMTO L_AMT 1 PayPal option names for an item in the shopping cart each name corresponds to an option value There can be multiple option name
65. nd the funds for the reversal have been returned to you Completed The payment has been completed and the funds have been added successfully to your account balance Denied You denied the payment This happens only if the payment was previously pending because of possible reasons described for the PendingReason element Expired the authorisation period for this payment has been reached Failed The payment has failed This happens only if the payment was made from your customer s bank account In Progress The transaction has not terminated e g an authorisation may be awaiting completion e Partially Refunded The payment has been partially refunded e Pending The payment is pending See the PendingReason field for more information e Refunded You refunded the payment e Reversed A payment was reversed due to a chargeback or other type of reversal The funds have been removed from your account balance and returned to the buyer The reason for the reversal is specified in the ReasonCode element Processed A payment has been accepted e Voided An authorisation for this transaction has been voided Optional API Operations GetTransactionDetails API TABLE A 6 Payment Information Fields Field Description PENDINGREASON NoTE PendingReason is returned in the response only if PaymentStatus is Pending The reason the payment is pending none No pending reason address The payment is pending
66. nt can t be processed Please pay with a different card type Your payment can t be processed Please pay with another credit card Please enter a valid name for the billing address Corrective Action Merchant account attempting the transaction does not have a confirmed email address with PayPal Check your account settings Merchant attempted a transaction where the amount exceeded the upper limit for that merchant Check your payment receiving preferences Contact PayPal if you more help Credit card supplied cannot be charged in the currency requested Buyer should enter the complete billing address Buyer should enter a valid year for card expiration Buyer should enter a valid month for card expiration A duplicate transaction was detected advice buyer to try again later Merchant country is not supported Credit card type is not supported Credit card supplied doesn t support Authorization Buyer should enter a valid name in the billing address 88 Error Messages EN TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10702 10703 10704 10705 10706 10707 10708 10709 10710 10711 10712 10713 10714 10715 10716 10717 10718 Error Message Please enter a valid address in line 1 of the billing address Please enter a valid address in line 2 of the billing address Please enter a valid city in th
67. nter a valid country in the billing address Please enter a valid country in the shipping address Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Please enter a card security code Please enter a valid state in the shipping address Please enter a valid state in the billing address Your payment can t be processed Please pay with another card Your payment can t be processed Please pay with another card Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please pay with another card Your payment can t be processed Please pay with another card Corrective Action Buyer should enter a valid postal code in the shipping address Buyer should enter a valid city and state in the shipping address Buyer should enter a valid country in the billing address Buyer should enter a valid country in the shipping address Credit card from this country is not supported Contact PayPal with this error code Buyer should enter a Card Security Code Buyer should enter a valid state in the shipping address Buyer should enter a valid state in the billing address Transaction was declined by the issuing bank not PayPal Buyer should attempt another card Buyer should use a different credit card Review you
68. ntify the WEBSITECODE in the response and use the code to create a Pay Now button on your review page When your buyer clicks the button they are redirected to the PayPal hosted payment page Like the URL the button is usable for approximately two hours or until the payment is successful 41 42 Integrating Your Website Using API Using the Button Manager API with PayPal Pro Checkout Example for TOKEN WEBSITECODE lt form action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value s xclick gt lt input type hidden name hosted button id value HSS 2MTCOLOp9LOPGdFYsYclhbGyj JVNrMHO gt lt input type image src https www paypal com en_US i btn btn_auto_ billing LG gif border 0 name submit alt PayPal The safer easier way to pay online gt lt img alt border 0 src https ww paypal com en GB i scr pixel gif width 1 height 1 gt lt form gt Example for ENCRYPTED WEBSITECODE lt form action https www paypal com cgi bin webscr method post gt lt input type hidden name cmd value s xclick gt lt input type hidden name encrypted value BEGIN PKCS7 END PKCS7 gt lt input type image src https www paypal com en US i btn btn auto billing LG gif border 0 name submit alt PayPal The safer easier way to pay online gt lt img alt border 0 src https ww paypal com en GB i scr pixel gif width 1 height 1
69. ociated certificate ID is no longer valid for encrypting buttons and any buttons that you generated or wrote manually for your website that use the ID will not function correctly To remove one or more of your public certificates 1 Log in to your PayPal account at https www paypal it 2 Click the Profile subtab 3 In the Seller Preferences column click the Encrypted Payment Settings link 4 Scroll down the page to the PayPal Public Certificate section 5 Select the radio button next to the certificate you want to remove and click Remove The Remove Certificate page appears 6 Click Remove to confirm the removal of the public certificate that you selected 60 Protecting Buttons by Using Encrypted Website Payments E Setting Up Certificates Before Using Encrypted Website Payments Using Encrypted Website Payments to Protect Your Payment Buttons Encrypted Website Payments includes Java and Microsoft Windows software to protect the payment buttons that you generate or write manually Download the software from the following location after logging in to PayPal https www paypal com us cgi bin webscr cmd p xcl rec ewp code After you download and extract the software copy your private key public certificate p12 file and the PayPal public certificate to the folder where the software is located 1 Prepare an input file of PayPal Pro variables and values for each encrypted button that you want to generate Each varia
70. ode of the shipping address No 19 En Integrating Your Website Using HTML HTML Variables 20 Customising Your PayPal Payment Page You can customise the look and feel of the PayPal payment page in the following two ways e Modifying Your PayPal Account Settings e Adding HTML Variables NoTE HTML variables will override the settings you save on your profile page Modifying Your PayPal Account Settings In your Profile section on PayPal com you can change the look and feel of the payment page by modifying the settings on the following pages under the Website Payment Settings section e Settings e Customisation 21 Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Profile Business Eagle Drug Store mkotamballi STAGE2VM5116 IT 20100929104345125645769 paypal com Secure Merchant ID CB6SXQEPN3LHG View and edit your account settings and check the status of your products and services Services My Business Setup Soluzione di Pagamento Telefonico i Your guide to getting Risk Controls i paid Start Now Account information Email ces Billing gt Street address Phones and mobile payments gt View PayPal bills gt Password Manage monthly billing gt Secure FTP server settings Language preference Selling preferences implementation Testing gt Timezone Auctions Sandbox testing gt y poe ee Customer service message environment Request API credentials g
71. ogram protects you against chargebacks on transactions funded by credit card or a PayPal account For more information refer to Seller Protection on page 11 e PayPal Express Checkout Two click payment option for PayPal account holders For more information refer to PayPal Express Checkout Transaction Processing on page 12 pal Getting Started with PayPal Pro How PayPal Pro Works e Supports Major Credit and Debit Cards Supports Visa MasterCard Carta Aura processed by Cetelem Postepay Visa PayPal prepaid card MasterCard How PayPal Pro Works Legend Merchant MH PayPal _ _ __ _ Confirmation don E A a PayPal Login Review Your PayPal Pa Confi ti Purchase onfirmation page q__ Merchant PayPal Payment s Checkout page page Confirmation PayPal Hosted Confirmation page Confirmation Merchant Confirmation page In the figure above the top flow is for paying using your PayPal account and the bottom flow is for paying with a card To integrate your website with PayPal Pro 1 Generate a button in your website checkout flow using HTML or API solution The button could be labeled Pay or Buy or similar When the buyer clicks this button they are redirected to the payment page hosted by PayPal 2 On the payment page the buyer enters their debit or credit card information and clicks the Pay Now button They do not have to have a PayPal account although they have the option to use it i
72. omparison Below is a comparison of Website Payment Standard code and PayPal Pro code Norte In the samples below note that for Website Payment Standard amount and quantity are specified as 10 and 2 respectively For PayPal Pro the subtotal is 20 which is the product of the above mentioned amount and quantity This is highlighted in bold below Sample Website Payments Standard Code lt form action https www paypal com cgi bin webscr method post gt lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt input type hidden lt Enable override name cmd value xclick gt name business value seller designerfotos com gt name amount value 10 gt name quantity value 2 gt name tax value 1 gt name currency code value USD gt name invoice value MEM32507725 gt of payer s stored PayPal address gt lt input type hidden name address override value 1 gt lt Set prepopulation variables to override stored address gt lt input type hidden name first_name value John gt lt input type hidden name last_name value Doe gt lt input type hidden name address1 value 345 Lark Ave gt lt input type hidden name city value San Jose gt lt input type hidden name state value CA gt lt input type hidden name zip value 95121 gt lt input type
73. ons GetTransactionDetails API TABLE A 6 Payment Information Fields Field FEEAMT SETTLEAMT TAXAMT EXCHANGERATE Description PayPal fee amount charged for the transaction Character length and limitations Does not exceed 10 000 USD in any currency No currency symbol Regardless of currency decimal separator is a period and the optional thousands separator is a comma Equivalent to nine characters maximum for USD Amount deposited in your PayPal account after a currency conversion Tax charged on the transaction Character length and limitations Does not exceed 10 000 USD in any currency No currency symbol Regardless of currency decimal separator is a period and the optional thousands separator is a comma Equivalent to nine characters maximum for USD Exchange rate if a currency conversion occurred Relevant only if your are billing in their non primary currency If the customer chooses to pay with a currency other than the non primary currency the conversion occurs in the customer s account Character length and limitations a decimal that does not exceed 17 characters including decimal point Optional API Operations GetTransactionDetails API TABLE A 6 Payment Information Fields Field PAYMENTSTATUS Description Status of the payment The status of the payment None No status Canceled Reversal A reversal has been canceled for example when you win a dispute a
74. pay Background of the section that displays Pay with my PayPal account or Pay with a Card 32 Customising Your PayPal Payment Page Adding HTML Variables TABLE 3 1 HTML Variables for Look and Feel of Payment Page Variable showCustomerName showBillingAddress showBillingPhone showBillingEmail showHostedThankyouPage showShippingAddress subheaderText template Description Display customer name first name and last name e Default Value true e Allowable Value true or false where true show and false hide Display billing address information e Default Value true e Allowable Value true or false where true show and false hide Display billing phone number e Default Value true e Allowable Value true or false where true show and false hide Display email address for billing purposes e Default Value false e Allowable Value true or false where true show and false hide Display PayPal s confirmation page e Default Value true e Allowable Value true or false where true show and false hide Display shipping address e Default Value false e Allowable Value true or false where true show and false hide Color of the Pay with my PayPal account or Pay with a Card text Template used for your payment page Options are TemplateA TemplateB and TemplateC TemplateD is used for Frame integration only and is not an option on the
75. r Website Using API BMCreateButton API Operation 48 Testing Your Integration in Sandbox The PayPal Sandbox is a self contained environment within which you can prototype and test PayPal features The PayPal Sandbox is an almost identical copy of the live PayPal website Its purpose is to give developers a shielded environment for testing and integration purposes and to help avoid problems that might occur while testing PayPal integration solutions on the live site Before moving any PayPal based application into production you should test the application in the Sandbox to ensure that it functions as you intend and within the guidelines and standards set forth by the PayPal Developer Network PDN For complete details on using Sandbox refer to Sandbox User Guide Creating a Preconfigured Account When you log in to the Sandbox the Sandbox Test Environment home page appears as shown below PayPal Sandb Help Profile Log Out an Ox Sandbox Test Accounts Test Email API Credentials Test Tools The PayPal Sandbox allows you to test the integration of your PayPal payment solution before Additional posuurces submitting transactions to the live PayPal environment The Sandbox is a duplicate of the live PayPal site except that no real money changes hands Documentation PayPal Developer Network Test Accounts Customer Support Create a preconfigured buyer or seller account gt Create a Website Payments Pro account US
76. r a reversal if TransactionType is reversal none No reason code chargeback A reversal has occurred on this transaction due to a chargeback by your customer guarantee A reversal has occurred on this transaction due to your customer triggering a money back guarantee buyer complaint A reversal has occurred on this transaction due to a complaint about the transaction from your customer refund A reversal has occurred on this transaction because you have given the customer a refund other A reversal has occurred on this transaction due to a reason not listed above 70 Optional API Operations GetTransactionDetails API TABLE A 6 Payment Information Fields Field PROTECTIONELIGIBILITY Description Since version 64 4 the kind of seller protection in force for the transaction which is one of the following values e Eligible Seller is protected by PayPal s Seller Protection Policy for Unauthorised Payments and Item Not Received Protection Policy for Item Not Received Seller Protection Policy for Unauthorized Payment Ineligible Seller is not protected under the Seller Protection Policy ItemNotReceivedEligible Seller is protected by PayPal s Seller UnauthorizedPaymentEligible Seller is protected by PayPal s Payment Item Information Fields TABLE A 7 Payment Item Information Fields Field INVNUM CUSTOM NOTE SALESTAX Description Invoice number you set in the origi
77. r integration to ensure that the currency code is supported Buyer should use a different credit card Transaction was declined by PayPal Contact PayPal with this error code 91 BE Error Messages TABLE C 1 Error Codes and the Corresponding Corrective Actions Continued Error Code 10761 10762 10763 10764 11998 15001 15002 15003 15004 15005 15006 15007 Error Message Your payment can t be processed because this transaction appears to be a duplicate of a recent transaction Your payment can t be processed Please pay with another card Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Please enter the date when your credit card became valid Your payment can t be processed Please pay with another card Your payment can t be processed Please pay with another card Your payment can t be processed Please contact the merchant directly with this code Please enter a valid Card Security Code Your payment can t be processed Please pay with another card Please enter a valid card number Your card is expired Please pay with a valid card Corrective Action Transaction was declined because PayPal is currently processing a transaction by the same buyer for the same amount This error can occur when a buyer submits multiple identi
78. reserves the right to make changes to any information herein without further notice Preface Chapter Chapter Chapter Chapter Contents About This Guide nn nn nn Intended Audience 222 222mm nn on nn Revision History e e 22H 2 nun nn Documentation Feedback 2 2 2 m nun nn 1 Getting Started with PayPal Pro OVEIVIEW lt lt Es a dd ee ee a we Features and Benefits s o 2 soio saad ca ooi uua e d a a o a How PayPal Pro Works Eu nn nn Seller Protection 222220 ae a En Instant Payment Review nn PayPal Express Checkout Transaction Processing Introduction to Integrating with PayPal Pro 2 Integrating Your Website Using HTML Simple PayPal Pro Integration 2 200000 0 4 Sample Integration 222 2 un nn HTML Variables s s 2 2 Ho oo 3 _Customising Your PayPal Payment Page Modifying Your PayPal Account Settings SEHINGS ar de eh ee CUSTOMISAION s a sea aa un au an a ee ga a ee ee Adding HTML Variables aoaaa aa 4 Integrating iFrame in Your Website Integrating iFrame 2 eaaa rea a Manual Integration oaa o API Integrations 000 42 3 we A 43a a eee BS 13 15 16 17 21 21 23 25 31 Bi Contents Chapter 5 Integrating Your Website Using API 39 B tt n Hosting s u 2 2 mu ae Ba A ae Gow da Ge a Pe x 39 Using the Button Man
79. rocessed Please contact the merchant directly with this code Please enter a valid address Please enter a valid credit card number Please enter a valid email address Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please pay with another credit card Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Your payment can t be processed Please contact the merchant directly with this code Corrective Action Transaction was declined by fraud filter managed by the merchant To accept this translation change your risk settings on PayPal Transaction was declined by PayPal because of an invalid address Buyer should provide the correct address Credit card entered is currently restricted by PayPal Contact PayPal with this error code Email address is in an invalid format Buyer should provide the email address in the correct format Transaction was declined by PayPal Contact PayPal with this error code Transaction was declined by PayPal because of possible fraudulent activity Contact PayPal with this error code Transaction was declin
80. s per item The option names are ordered sequentially beginning with 0 for example L OPTIONSNAMESO L_OPTIONSNAME PayPal option values corresponding to option names of an item in the shopping cart The option names are ordered sequentially beginning with 0 for example L OPTIONS VALUEO L OPTIONSVALUEI Auction Fields TABLE A 9 Auction Fields Field BUYERID CLOSINGDATE MULTIITEM Description Customer s auction ID Auction s close date Counter used for multi item auction payments Optional API Operations RefundTransaction API Subscription Term Fields TABLE A 10 Subscription Terms Fields Field Description AMT The amount subscriber is to be charged in one payment Character length and limitations no limit PERIOD The period of time that the subscriber will be charged Character length and limitations no limit RefundTransaction API Issue a refund to the PayPal account holder associated with a transaction e RefundTransaction Request e RefundTransaction Response RefundTransaction Request TABLE A 11 RefundTransaction Request Fields Field Description METHOD Must be RefundTransaction TRANSACTIONID Required Unique identifier of a transaction Character length and limitations 17 single byte alphanumeric characters REFUNDTYPE Required Type of refund you are making e Other e Full e Partial AMT Refund amount Amount is required if RefundType is Partial NoTE If RefundType is
81. sk that sensitive information can be altered or stolen Note Hosted buttons BUTTONCODE HOSTED are not supported for PayPal Pro and will return an error ifused For more information about Button Manager API usage refer to BMCreateButton API Operation on page 45 40 Integrating Your Website Using API Using the Button Manager API with PayPal Pro Checkout Using the Button Manager API with PayPal Pro Checkout To create a checkout button on your website you call the BMCreateButton API operation When the buyer clicks on the checkout button PayPal initiates the PayPal Pro checkout flow You must decode the response from the BMCreateButton API For information about URL encoding refer to the Name Value Pair API Developer Guide There are two options in the response to initiate the PayPal Pro payment flow e Using URL Returned in the Response Recommended e Using Form POST Using URL Returned in the Response Recommended Legend ij Merchant ME PayPal Merchant PayPal Payment Checkout page page Request Response BMCreateButton Redirect URL EMAILLINK PayPal API Server Using the URL identified in the response as EMAILLINK you can redirect the buyer and initiate the payment flow Example of TOKEN EMAILLINK https www paypal com cgi bin webscr cmd _s xclick amp hosted_button_id HSS 2MTCOLOp9LOPGdFYsYclhbGyjJVNrMHO amp HOSTEDBUTTONID HSS 2MTCOLOp9LOPGdFYsYclhbGyjJVNrMHO amp TIMESTA
82. t Business information Close Account Identification Preference Instant Payment Notification preferences My Saved Buttons Financial information gt Bank accounts gt Credit cards Manage Redemption codes Monthly Account Statements Preapproved Payments Recurring payments dashboard gt Settings gt Appearance Website Payments Standard and Express Checkout gt Postal preferences Customising Your PayPal Payment Page Modifying Your PayPal Account Settings Settings PayPal y US English ial My Account Send Money Request Money Merchant Services Auction Tools Overview AddFunds Withdraw History Resolution Center Reports Profile Design your PayPal Pro solution Help with this page Choose settings You ll see we ve defined some settings by default at right You can change PayPal collects your customers card number expiration date and Card Verification number them and then click Save Select additional information from the options below to collect and display on the payment page You can also collect this information on your own website and send itto PayPal in Choose appearance your web payment request We ve created a basic for you below but you can change it to reflect your company s brand What information do you want to show on your PayPal Pro payment page IF Card information Customer name Integrate Billing address When you re ready to incorporate this page with your w
83. t status using the GetTransactionDetails API operation checking email from PayPal reviewing IPN messages or checking the Transaction History on https www paypal com PayPal Express Checkout Transaction Processing PayPal Express Checkout is PayPal s premier checkout solution It makes it easier for your buyers to pay and allows you to accept PayPal while retaining control of the buyer and overall checkout flow It enables the buyers to use shipping information stored securely at PayPal to check out so they do not have to re enter it on your site The Pay with PayPal button can be Getting Started with PayPal Pro Introduction to Integrating with PayPal Pro placed on both the product page as well as the shopping cart page and is a great tool to increase checkout conversion Confirmation D a Pay a PayPal Log in Stored Shipping Review Order and Billing Cu eve Customer reviews na ki PayPal Confirmation Customer views The zafer saser way to pay storm Shopping Cart Customer pays with PayPal The following steps describe how PayPal Express Checkout works 1 After selecting products to purchase on your website buyers click Pay with PayPal button 2 They are redirected to the PayPal site where they log in using their PayPal login and password 3 After logging in they review the order summary and click Continue Checkout to authorise the transaction 4 The buyers are then returned to the confirmation page
84. te PayPal recommends that you implement the simple integration to familiarise yourself with PayPal Pro before implementing a more customised integration As part of a simple integration you get the default settings on your payment page To customise the look and feel of the page so it matches your website you can do one of the following e Change your settings in your Profile section on PayPal com as described in Modifying Your PayPal Account Settings on page 21 e Add the appropriate HTML variables to the payment page as described in Table 2 1 HTML Variables for Settings of Payment Page and Table 3 1 HTML Variables for Look and Feel of Payment Page IMPORTANT HTML variables will override the settings you save on your profile page Simple PayPal Pro Integration To integrate your website with PayPal Pro identify a point in your website checkout flow where you want to place a button that the buyer clicks to initiate the payment The button should be labeled Continue to Payment Pay or similar and when clicked should execute a Form POST to PayPal Clicking on this button redirects the buyer s browser to the PayPal payment page where they can pay with credit card or their PayPal account The Form POST contains a set of HTML variables that describe the transaction In the Form POST you must specify the following e subtotal amount of the transaction e business Secure Merchant ID found on the profile page or t
85. tected with Encrypted Website Payments 3 Copy the encrypted code to your website Blocking Unprotected and Non encrypted Website Payments For extra security of your protected and encrypted buttons update your PayPal account profile to block unprotected and non encrypted payments To block payments from unprotected and non encrypted Website Payments Standard buttons 1 Log in to your PayPal account at https www paypal it DD nan A Q N Click the Profile subtab In the Seller Preferences column click the Encrypted Payment Settings link Scroll down to the Encrypted Website Payments section Next to the Block Non encrypted Website Payment label select the On radio button Scroll to the bottom of the page and click Save Optional API Operations Using the Transaction ID a number of PayPal API operations are available The most commonly used for PayPal Pro are e GetTransactionDetails API e RefundTransaction API e DoCapture API GetTransactionDetails API Obtain information about a specific transaction e GetTransactionDetails Request e GetTransactionDetails Response GetTransactionDetails Request TABLE A 1 GetTransactionDetails Request Fields Field Description METHOD Must be GetTransactionDetails TRANSACTIONID Required Unique identifier of a transaction NoTE The details for some kinds of transactions cannot be retrieved withGetTransactionDetails You cannot obtain details of bank
86. tes comprise a public key and identity information such as the originator of the key and an expiry date Public certificates can be signed by certificate authorities who guarantee that public certificates and their public keys belong to the named entities You and PayPal exchange each others public certificates e Private keys Private keys are created by receivers are kept to themselves You create a private key and keep it in your system PayPal keeps its private key on its system e The encryption process Senders use their private keys and receivers public keys to encrypt information before sending it Receivers use their private keys and senders public keys to decrypt information after receiving it This encryption process also uses digital signatures in public certificates to verify the sender of the information You use your private key and PayPal s public key to encrypt your HTML button code PayPal uses it s private key and your public key to decrypt button code after people click your payment buttons Setting Up Certificates Before Using Encrypted Website Payments Do the following before you use Encrypted Website Payments to protect your payment buttons e Generating Your Private Key Using OpenSSL e Generating Your Public Certificate Using OpenSSL e Uploading Your Public Certificate to Your PayPal Account e Downloading the PayPal Public Certificate from the PayPal Website PayPal uses only X 509 public cer
87. tificates not public keys A public key can be used for decryption but contains no information identifying who provided the key A public certificate includes a public key along with information about the key such as when the key expires and who the key belongs to PayPal accepts public certificates in OpenSSL PEM format from any established certificate authority such as VeriSign You can generate your own private key and public certificate using open source software such as OpenSSL https www openssl org which is detailed in the following section Protecting Buttons by Using Encrypted Website Payments ES Setting Up Certificates Before Using Encrypted Website Payments Generating Your Private Key Using OpenSSL Using the openssl program enter the following command to generate your private key The command generates a 1024 bit RSA private key that is stored in the file my prvkey pem openssl genrsa out my prvkey pem 1024 Generating Your Public Certificate Using OpenSSL The public certificate must be in PEM format To generate your certificate enter the following openssl command which generates a public certificate in the file my pubcert pem openssl req new key my prvkey pem x509 days 365 out my pubcert pem Uploading Your Public Certificate to Your PayPal Account To upload your public certificate to your PayPal account 1 Log in to your PayPal account at https www paypal it 2 Click the Profile subtab 3 In the
88. tional A three character currency code Default USD Optional API Operations DoCapture API TABLE A 13 DoCapture Request Fields Field COMPLETETYPE INVNUM NOTE Description Required The value Complete indicates that this the last capture you intend to make The value NotComplete indicates that you intend to make additional captures NoTE If Complete any remaining amount of the original authorised transaction is automatically voided and all remaining open authorisations are voided Character length and limitations 12 single byte alphanumeric characters Optional Your invoice number or other identification number that is displayed to the merchant and customer in his transaction history NoTE This value on DoCapture will overwrite a value previously set on DoAuthorisation NOTE The value is recorded only if the authorisation you are capturing is an order authorisation not a basic authorisation Character length and limitations 127 single byte alphanumeric characters Optional An informational note about this settlement that is displayed to the payer in email and in his transaction history Character length and limitations 255 single byte characters all Optional API Operations DoCapture API TABLE A 13 DoCapture Request Fields Field Description SOFTDESCRIPTOR Optional The soft descriptor is a per transaction description of the payment that is passed to the consumer s credit
89. ublic Certificate to Your PayPal Account 59 Downloading the PayPal Public Certificate from the PayPal Website 60 Removing Your Public Certificate o 0 2 60 Using Encrypted Website Payments to Protect Your Payment Buttons 61 Blocking Unprotected and Non encrypted Website Payments 62 Appendix A Optional API Operations 63 Contents GetTransactionDetails API m En nn nn 63 GetTransactionDetails Request En nn ee 63 GetTransactionDetails Response 2 2 2 En m nn nn 64 RefundTransaction API ee ee 73 RefundTransaction Request 2 222 2 nn nn nn 73 RefundTransaction Response 2 2 2 2 nn m nn nn 74 DoCapture API a e 24 4 2008 a u Bee bet Ee the ea fea hee dee an a 74 DoCapture Request nn nn 74 DoCapture Response 22 LE m nn nn nn 77 Chapter B Moving from Website Payments Standard to PayPalPro 81 Sample Code Comparison 2 1 Emm mann 82 Appendix C Error Messages 2 ee ee 89 Appendix D Currency Codes 2 0 6 2 8 8 ee ee 95 BER Contents Preface About This Guide The PayPal Pro Integration Guide describes how to integrate with PayPal Pro It includes information about Features and benefits of PayPal Pro Seller Protection Moving from Website Payments Standard to PayPal Pro Integrating your website with Pay
90. ur hosted payment page You have the following options e Card Information Buyer s credit card information This field is always displayed and selected by default e Customer Name Buyer s first and last name e Billing Address Buyer s billing address e Billing Phone Number Buyer s phone number e Billing Email Address Buyer s email address e Shipping Address Buyer s shipping address This is required for seller protection Ensure that you set the buyer s shipping address HTML variable if you do not select this box How do you want to display payment confirmation Once the transaction is successful you can choose to display your payment confirmation on either a PayPal s confirmation page or on your own payment confirmation page e Ona PayPal page that shows the payment is complete The payment confirmation appears on the PayPal confirmation page Optionally you can also provide a URL on the confirmation page to take your buyer back to your website To do so enter the appropriate URL in the field provided e On the Company s confirmation page The payment confirmation will appear on your own payment confirmation page For this enter the URL of the page that will display the payment confirmation You will have to message the outcome of the transaction to the buyer when PayPal redirects back to this URL Be sure to display specifics of the order so the buyer sees a meaningful confirmation You can get the specifics of the order
91. with every transaction It is recommended that you test your integration first particularly if you plan to use iFrame to determine if the billing information fields are required TABLE 2 1 HTML Variables for Settings of Payment Page Variable address1 address2 address override bi bi bi bi bi bi bi bn lling_address1 lling_address2 lling city lling country illing first_name lling last name lling state lling zip business buyer email Description Street name of shipping address 1 of 2 fields Street name of shipping address 2 of 2 fields The payer is shown the passed in address but cannot edit it This variable is overridden if there are errors in the address The allowable values are true false Default is false Street name of the billing address 1 of 2 fields Street name of the billing address 2 of 2 fields City name of the billing address Country code of the billing address First name of person the item is being billed to Last name of person the item is being billed to State name of the billing address Zip code of the billing address Identifies the source that built the code for the button Format lt Company gt _ lt Service gt _ lt Product gt _ lt Country gt Your PayPal account email address or your PayPal ID Secure Merchant ID associated with your PayPal account It is recommended that you use your PayPal ID which can be found on the top sectio
92. yPal before sending the items to the buyer You can do so by checking the confirmation email sent to you by PayPal or by verifying the transaction history You can also using one of the following methods Instant Payment Notification IPN IPN enables you to receive messages about transaction payments and activity from PayPal through asynchronous server to server communication This allows you to integrate your online payments with your order fulfillment process Through IPN you receive messages for the following e Payments and their status pending complete or denied e Fraud Management Filter actions e Recurring Payment activity e Authorisations chargebacks disputes reversals and refunds After a transaction has been processed PayPal sends an IPN to the notification URL specified in your transaction using the parameter notify url or in your PayPal Profile You must verify that the Transaction ID transaction amount and other order specific parameters such as Invoice ID that are sent in the IPN match with the information you have in your order processing system For more details refer to Instant Payment Notification Guide 55 all Order Processing Fulfilling Order Execute a GetTransactionDetails API Call Using GetTransactionDetails API you can obtain information about a specific transaction If you are integrated with PayPal APIs you can call GetTransactionDetails with the Transaction ID that was returned in the web r
93. you click View Details 7 Ensure that Payment Review is set to Enabled In doing so all transactions on this account are put into pending review state You can then click accept or decline on the Transaction Details page to simulate the fraud agent s action 52 Testing Your Integration in Sandbox Creating a Preconfigured Account 8 Click Enter Sandbox Test Site The Sandbox Test Site appears in a different browser window as shown below If you are not automatically logged in to the Sandbox Test Site log in using the email address created for the test account as part of step 6 and the password you noted in step 5 PayPal Sandbox U S English Test Site Log Out Help Security Center PayPal My Account Send Money Request Money Merchant Services Auction Tools Overview Add Funds Withdraw History Resolution Center Reports Profile Help with this page Business name Anna Test Store jdoe_1272862469_biz paypal com Status Verified Application status Approved Your application has been approved WwW We ve approved your application You can now configure your account and process transactions Search transactions Quick links Policy updates Next steps E gt Referrals Verify a bank gt Refund Accept billing agreement and activate monthly billing PayPal balance Currency Euro Primary 0 00 EUR Total in EUR 0 00 EUR View transactions Tools gt All account activity E Invoicing w My Saved Buttons

PayPal Pro - 2012 Integration Guide

Contents

Download Pdf Manuals

Related Search

Related Contents