Express Checkout and Direct Payment Simulator Guide © 2006 PayPal Inc. All rights reserved. PayPal, the PayPal logo, Payflow, and Payflow Pro are registered trademarks 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. PayPal (Europe) Ltd.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 About this Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Conventions Used in this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Where to Go for More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 How to Contact Customer Service .
Contents Express Checkout Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Set Express Checkout Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Get Express Checkout Details Parameters . . . . . . . . . . . . . . . . . . . . . . . 20 Do Express Checkout Payment Parameters. . . . . . . . . . . . . . . . . . . . . . . 20 Void, Delayed Capture, and Credit Transaction Parameters. . . . . . . . . . . . . . . . .
Preface About this Document This document provides guidelines for testing your implementation of Express Checkout and Direct Payment and for interpreting the results. For complete information on the function calls and parameters referred to in this document, see the Payflow Pro Developer’s Guide. For specific details on how to implement Website Payments Pro Payflow Edition through the Payflow Software Developer’s Kit (SDK), see the documentation provided with the Payflow SDK.
Preface How to Contact Customer Service How to Contact Customer Service You may contact Customer Service at payflow-support@paypal.com. Revision History Revision history for Express Checkout and Direct Payment Simulator Guide. TABLE P.1 Revision History 6 Date Description July 2006 Revision history started. August 2006 Added section titled “Setting Verbosity” on page 9. Updated note in “Selecting a Predefined Buyer for Testing” August 2006 on page 14.
1 Test Environment The test environment allows you to easily test your integration without having to create a Website Payments Pro Payflow Edition merchant account or PayPal buyer accounts. The test environment allows you to test Express Checkout Transaction Processing and Direct Payment Credit Card Processing. In the production environment, you must create and configure a Website Payments Pro Payflow Edition merchant account.
1 8 Test Environment August 2006 Express Checkout and Direct Payment Simulator Guide
2 Testing Direct Payment Overview The test environment allows you to test Direct Payment Credit Card transactions. N O T E : Direct Payment Credit Card transactions require that you set the parameters as described in the Payflow Pro Developer’s Guide.
2 Testing Direct Payment Transaction Response Parameters Transaction Response Parameters The following table shows parameter values returned in a transaction response in the test environment. TABLE 2.
Testing Direct Payment Void, Delayed Capture, and Credit Transaction Parameters TABLE 2.2 2 AVSCode Returned Based on Address and Zip Code (Continued) Address Range Zip Range PayPal Processor AVSCode 000-333 01501-02000 Y 334-666 50001-99999 N 334-666 00000-10000 P 334-666 10001-20000 W 334-666 20001-50000 Z All other CVV2 Code Return Values The following table lists the PayPal Processor CVV2 codes returned based on the value of CVV2.
2 12 Testing Direct Payment Void, Delayed Capture, and Credit Transaction Parameters August 2006 Express Checkout and Direct Payment Simulator Guide
3 Testing Express Checkout Overview The test environment allows you to test the entire flow of your Express Checkout integration, including the redirect to PayPal and the return back to your website. In the test environment for Express Checkout, you can select a predefined buyer, customize the simulated PayPal buyer login page, and redirect the buyer to that login page. The buyer can log in and enter shipping information.
3 Testing Express Checkout Redirecting the Buyer to the PayPal Login Page z To test transactions in the test environment, use the following URL: test-payflow.verisign.com z To send transactions to the live servers in the production environment, use the following URL: payflow.verisign.
Testing Express Checkout Selecting a Predefined Buyer for Testing z Buyer 10 (UK default) as described in Table 3.3, “Buyer 10 Profile UK” z Buyer 11 (UK) as described in Table 3.4, “Buyer 11 Profile UK” 3 Buyer 1 Table 3.1, “Buyer 1 Profile U.S.,” shows the details of the default U.S. buyer. Buyer 2 TABLE 3.1 Buyer 1 Profile U.S. Attribute Value in Test Environment ContactPhone 800-555-1111 PayerEmail Buyer1@paypal.
3 Testing Express Checkout Selecting a Predefined Buyer for Testing TABLE 3.2 Buyer 2 Profile U.S. (Continued) Attribute Value in Test Environment Payer FirstName: Bob LastName: Johnson PayerCountry US PayerBusiness Software Consulting Address AddressStatus: confirmed Name: Bob Johnson Street1: 211 Elm St. Street2: CityName: San Jose StateorProvince: CA PostalCode: 95100 Country: US Address AddressStatus: unconfirmed Name: Sally Johnson Street1: 222 Maple St.
Testing Express Checkout Selecting a Predefined Buyer for Testing TABLE 3.3 3 Buyer 10 Profile UK (Continued) Attribute Value in Test Environment PayerBusiness Car Sales Address AddressStatus: confirmed Name: Kent Jones Street1: 311 Market St. Street2: CityName: London StateOrProvince: London PostalCode: TW9 1EJ Country: UK Address AddressStatus: unconfirmed Name: Amanda Jones Street1: 102 Cooper Lane Street2: Apt.
3 Testing Express Checkout Setting Up the Test PayPal Login Page TABLE 3.4 Buyer 11 Profile UK (Continued) Attribute Value in Test Environment Address AddressStatus: confirmed Name: Paul Casey Street1: 114 Mason Street Street2: CityName: Westminster StateOrProvince: London PostalCode: WC3 1AF Country: UK Address AddressStatus: confirmed Name: Donna Clarke Street1: 118 Steeplechase Lane Street2: Apt.
Testing Express Checkout Express Checkout Parameters 3 Reviewing the Test Funding and Shipping Page If the buyer clicks Login from the Login page, they go to the Review Your PayPal Information page. This page allows the buyer to select a source of funds and enter shipping information. Only the shipping information settings can be modified. The source of funds does not impact your integration.
3 Testing Express Checkout Express Checkout Parameters TABLE 3.5 Set Express Checkout Parameters in the Test Environment (Continued) Parameter Test Environment Behavior ADDROVERRIDE Same as production environment. This is enforced when the buyer is redirected to the test environment Review Your PayPal Information page. LOCALECODE Ignored.
Testing Express Checkout Void, Delayed Capture, and Credit Transaction Parameters 3 Test Payment Information The following payment information is defined in the test environment. TABLE 3.7 Payment Information Attribute Test Environment Behavior PPREF Unique ID is generated PAYMENTTYPE None FEEAMT 0.5, where currency is USD PAYMENTSTATUS Completed TAXAMT 0.
3 22 Testing Express Checkout Void, Delayed Capture, and Credit Transaction Parameters August 2006 Express Checkout and Direct Payment Simulator Guide
4 Testing Void, Delayed Capture, and Credit Transactions Overview The test environment allows you to test Void, Delayed Capture, and Credit transactions for Express Checkout and Direct Payment. These transactions require that you pass in the PNREF returned in the Do Express Checkout Payment response or transaction reponse from Direct Payment. In this Chapter z “Void Parameters” on page 23 z “Delayed Capture Parameters” on page 23 z “Credit Parameters” on page 24 Void Parameters Table 4.
4 Testing Void, Delayed Capture, and Credit Transactions Credit Parameters Credit Parameters Table 4.3, “Credit Response Parameters,” describes the Credit transaction response parameters. TABLE 4.3 24 Credit Response Parameters Attribute Test Environment Behavior PPREF Unique ID is generated FEEAMT 0.
