PayPal Payflow Pro - 2006 User Manual
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. is authorised and regulated by the Financial Services Authority in the United
Kingdom as an electronic money institution. PayPal FSA Register Number: 226056.
Notice of Non-Liability
PayPal Inc. is p ro viding the information in this document to y o u “AS-IS” with all faults. PayPal Inc. make s
no warranties of any kind (whether express, implied or statutory) with respect to the information
contained herein. PayPal Inc. assumes no li ability 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.
reserves the right to make changes to any information herein without further notice.
PayPal Inc. does not guarantee that the features described in this document will be announced or made
available to anyone in the future.
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Chapter 1 Test Environment . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 2 Testing Direct Payment . . . . . . . . . . . . . . . . . . . 9
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
In this Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Setting the Host Address. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Setting Verbosity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Transaction Response Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
AVSCode Return Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
CVV2 Code Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Void, Delayed Capture, and Credit Transaction Parameters. . . . . . . . . . . . . . . . . 11
Chapter 3 Testing Express Checkout. . . . . . . . . . . . . . . . . .13
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
In this Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Changing HOSTADDRESS for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Redirecting the Buyer to the PayPal Login Page . . . . . . . . . . . . . . . . . . . . . . 14
Selecting a Predefined Buyer for Testing . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Buyer 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Buyer 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Buyer 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Buyer 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Setting Up the Test PayPal Login Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Reviewing the Test Funding and Shipping Page . . . . . . . . . . . . . . . . . . . . 19
Express Checkout and Direct Payment Simulator Guide August 2006 3
Contents
Express Checkout Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Set Express Checkout Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Get Express Checkout Details Parameters . . . . . . . . . . . . . . . . . . . . . . . 20
Do Express Checkout Payment Parameters. . . . . . . . . . . . . . . . . . . . . . . 20
Void, Delayed Captu re, and Credit Transaction Parameters. . . . . . . . . . . . . . . . . 21
Chapter 4 Testing Void, Delayed Capture, and Credit Transactions . . 23
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
In this Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Void Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Delayed Capture Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Credit Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4 August 2006 Express Checkout and Direct Payment Simulator Guide
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. Implement the function calls as described, and then modify your application to point to
the test environment to conduct testing.
Audience
This guide assumes that its users:
z Are experienced Web or application developers
z Have a background in payments services
The user should also be familiar with Payflow Pro Developer’s Guide. That document, along
with this guide, are the primary sources of information on developing payments applications
using the Payflow SDK.
Conventions Used in this Guide
In this guide, you refers to the merchant and buyer refers to a customer of the merchant.
Where to Go for More Information
For more information, see the Payflow Pro Developer’s Guide.
For answers to specific questions about Payflow products, search PayPal’s Knowledge Base at
the following URL:
http://knowledge.paypal.com/.
Express Checkout and Direct Payment Simulator Guide August 2006 5
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 Revision HistoryP.1
Date Description
July 2006 Revision history started.
August 2006 Added section titled
Updated note in
“Selecting a Predefined Buyer for Testing” on page 14.
“Setting Verbosity” on page 9.
6 August 2006 Express Checkout and Direct Payment Simulator Guide
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. Additionally, for Express Checkout, each of your
customers would have a PayPal buyer account to use as the source of funds in a transaction.
The test environment sets up “test” versions of these standard accounts for you in advance so
you can start testing right away.
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 SDK, see the documentation provided with the Payflow SDK. Implement the
function calls as described, then modify your application to point to the test environment to
begin testing.
Express Checkout and Direct Payment Simulator Guide August 2006 7
Test Environment
1
8 August 2006 Express Checkout and Direct Payment Simulator Guide
Loading...