Express Checkout for Payflow Pro

For Professional Use Only Currently only available in English. A usage Professional Uniquement Disponible en Anglais uniquement pour l’instant.

Last updated: April 2009

Express Checkout for Payflow Pro Document Number: 200042.en_US-200904

© 2009 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. reserves the right to make changes to any information herein without further notice.

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 How to Contact Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Document History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1

Express Checkout Processing Flow . . . . . . . . . . . . . 9

What Is Express Checkout? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 How Express Checkout Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Express Checkout Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Express Checkout ACTION Values . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Express Checkout Token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Express Checkout Sale Transaction Example . . . . . . . . . . . . . . . . . . . . . . . . 12 Set Express Checkout (ACTION=S) . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Redirecting the Customer to PayPal Example. . . . . . . . . . . . . . . . . . . . . . 13 Get Express Checkout Details (ACTION=G) . . . . . . . . . . . . . . . . . . . . . . 14 Redirecting the Customer to Your Website Example . . . . . . . . . . . . . . . . . . 15 Do Express Checkout Payment (ACTION=D) . . . . . . . . . . . . . . . . . . . . . . 15 Other Express Checkout Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Obtaining the Buyer’s Telephone Number During Checkout . . . . . . . . . . . . . . 16 Pending Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 2

Express Checkout Recurring Payments . . . . . . . . . . . 19

Creating Multiple Billing Agreement Descriptions . . . . . . . . . . . . . . . . . . . . . . 19 Creating a Single Billing Agreement Description. . . . . . . . . . . . . . . . . . . . . . . 20 Example of Creating a Billing Agreement Description . . . . . . . . . . . . . . . . . . . . 20

Chapter 3

PayPal Button Placement and Page Designs . . . . . . . . 23

HTML for PayPal Button Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Design Variation: Eliminating Your Order Review Page . . . . . . . . . . . . . . . . . . . 25 Payment Method Page Layout Recommendations . . . . . . . . . . . . . . . . . . . . . 26

Express Checkout for Payflow Pro

3

Contents

Chapter 4

Express Checkout Transaction Types . . . . . . . . . . . . 27

Honor Period and Authorization Period . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Payment Transaction Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Sale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Do Reauthorization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Do Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Delayed Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Complete Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Partial Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Void . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Credit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Chapter 5

Transaction Responses . . . . . . . . . . . . . . . . . . . 35

Response Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Address Verification Service Responses From PayPal . . . . . . . . . . . . . . . . . . . 36 Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Normalized Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 PayPal Card Security Code Results . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 PNREF Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 PNREF Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 RESULT Values and RESPMSG Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 RESULT Values for Transaction Declines or Errors . . . . . . . . . . . . . . . . . . . 39

Chapter 6

Express Checkout Testing

. . . . . . . . . . . . . . . . . 45

Testing Your Integration Using the Sandbox . . . . . . . . . . . . . . . . . . . . . . . . . 45 Create A Business Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Create a Payflow Test Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Link Your Payflow Pro Account to the Sandbox . . . . . . . . . . . . . . . . . . . . . 46 Testing Your Integration Using the PayPal Simulator . . . . . . . . . . . . . . . . . . . . 47

Appendix A

Express Checkout Parameter Reference . . . . . . . . . . 49

Connection Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 User Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Express Checkout Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 51

4

Express Checkout for Payflow Pro

. . . . . 75 Index . . . . 71 Appendix B Currency Codes . . . . . . . . . . . . . . . . . . . . 69 Credit Parameter Descriptions . . . . . . . . . . . . . . . 66 Do Authorization Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Get Express Checkout Details Response Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Do Express Checkout Payment Request Parameter Descriptions . . . . . . . . . . . . . 68 Void Parameter Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Get Express Checkout Details Request Parameter Descriptions . . . . . 51 Set Express Checkout Response Parameter Descriptions . . . . . . . . . . 62 Do Express Checkout Payment Response Parameter Descriptions . . . . . . . . . 73 Appendix C Country Codes . . . . . . . 67 Do Reauthorization Parameter Descriptions . . . 81 Express Checkout for Payflow Pro 5 . . . . . . . . . . . . . . . . . . . . 70 Delayed Capture Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Contents Set Express Checkout Request Parameter Descriptions . . . . . . . . . . . . . . . . . . .

Contents 6 Express Checkout for Payflow Pro .

Preface Intended Audience This guide assumes that its readers: Are experienced web or application developers Have a background in payments services Are developing payment services applications that are integrating Express Checkout to process transactions to be sent over the Payflow gateway Related Documentation For additional information on Payflow documentation and the Payflow SDK. Express Checkout for Payflow Pro 7 .paypal. and click the Payflow Pro link. Added order line-item details parameters.com/mts.1 Document history Date April 2009 Description Added creating billing agreements for setting up Recurring Payments through Express Checkout. contact Customer Support by opening a ticket on the under Contact Support tab at http://www. select Documentation from the Library tab. Updated with PHONENUM parameter in Set Express Checkout request.com/developer. Document History TABLE 1. How to Contact Customer Support For problems with transaction processing or your connection to the server. go to http://www.paypal.

Document History 8 Express Checkout for Payflow Pro .

so they don’t have to re-enter it on your website. Like other Payflow transactions. Express Checkout transaction requests send data as namevalue pair parameters. Express Checkout for Payflow Pro 9 . convenient checkout experience by letting them use shipping and billing information stored securely at PayPal to check out. and include this basic set of required parameters: Connection parameters User parameters Transaction type (TRXTYPE) such as Sale (TRXTYPE=S). or Order (TRXTYPE=0) Tender type.1 Express Checkout Processing Flow This chapter describes Express Checkout processing: What Is Express Checkout? How Express Checkout Works Express Checkout Flow Express Checkout Sale Transaction Example Other Express Checkout Concepts What Is Express Checkout? Express Checkout is PayPal’s method of payment. It offers your customers an easy. which is always PayPal (TENDER=P) How Express Checkout Works The figure below summarizes the Express Checkout flow. Authorization (TRXTYPE=A).

but the integration points at which the Express Checkout calls are made and customer redirection to PayPal and back to your website are important to understand.1 Express Checkout flow The figure shows a typical set of web pages representing your merchant website. The events that take place at each number in the figure are described below: 10 Express Checkout for Payflow Pro . The PayPal logo is used by the customer to choose PayPal as their method of payment. Express Checkout gives you the flexibility to place the PayPal logo at the start of checkout and later on your billing page with other payment options.1 Express Checkout Processing Flow How Express Checkout Works FIGURE 1. The web page layout may differ somewhat from your own web design.

In the previous figure. you send the Do Express Checkout Payment request to perform the actual payment transaction. 4. This customer action triggers the call to the Set Express Checkout request. the token is represented by an orange “donut. Express Checkout includes parameters that you can use to customize the PayPal pages so they match characteristics of your own website. The server returns the transaction result. which consist of a single request call. For example. When your customer clicks the “Pay” button. 3. The server responds to the request by returning a token or string value to your website. along with other response parameter data about the transaction. and confirm contact and shipping information. Express Checkout for Payflow Pro 11 . Express Checkout is a three-step process where the second step is optional: 1. Set Express Checkout sets up the data about the transaction at hand such as a Sale and controls what is displayed to the customer on the PayPal site when the customer chooses PayPal at checkout. The token is appended to the URL to identify the customer. Express Checkout Flow Through a set of name-value pair parameters. This guide refers to this request sequence and the resulting customer experience as the Express Checkout flow. you provide Express Checkout transaction data to the server. select a funding source. The server returns the requested information. On your website. 2. Unlike most Payflow Pro transactions. your customer clicks the PayPal button to check out. you can provide your own logo and colors. 3. where they log in. 7. 5. Do Express Checkout Payment performs the actual money transfer. You direct your customer to the PayPal site. 6. You send the token to identify the customer. PayPal sends them back to your site at the return URL you specified in the Set Express Checkout request. When your customer clicks the “Continue” button. Optionally you can send the Get Express Checkout Details request to obtain details about your customer such as the customer’s telephone number and shipping address. 2.” The token keeps track of your customer throughout the checkout process. The server responds with RESULT and RESPMSG values.Express Checkout Processing Flow Express Checkout Flow 1 1. Get Express Checkout Details is an optional request enabling you to obtain this information for display on your own website.

1 Express Checkout Processing Flow Express Checkout Sale Transaction Example Express Checkout ACTION Values To identify each request in the Express Checkout flow. TABLE 1.” for detailed descriptions of all required and optional Express Checkout transaction parameters. ACTION AMT 12 Express Checkout for Payflow Pro . Set Express Checkout requires that you pass data for the following parameters. The table below shows the value of ACTION for each Express Checkout request. Set Express Checkout (ACTION=S) Redirecting the Customer to PayPal Example Get Express Checkout Details (ACTION=G) Redirecting the Customer to Your Website Example Do Express Checkout Payment (ACTION=D) Set Express Checkout (ACTION=S) The Set Express Checkout request passes the transaction details from your website to PayPal when a customer chooses to pay with PayPal. “Express Checkout Parameter Reference. You pass it back to the server in these Express Checkout requests: In the HTTP request to redirect the customer’s browser to the PayPal web site In the Get Express Checkout Details request to obtain the customer’s hipping information In the Do Express Checkout Payment request to carry out the transaction Express Checkout Sale Transaction Example This section describes the Express Checkout flow in greater detail using a Sale transaction as the example. See Appendix A. you pass the appropriate ACTION parameter.1 ACTION values for Express Checkout Request Set Express Checkout Get Express Checkout Details Do Express Checkout Payment ACTION value ACTION=S ACTION=G ACTION=D Express Checkout Token The TOKEN value returned in the response to Set Express Checkout associates the customer with this particular Express Checkout flow.

you will want to automatically direct your customer to the PayPal website.Express Checkout Processing Flow Express Checkout Sale Transaction Example 1 RETURNURL CANCELURL This is an example Set Express Checkout request parameter string for a Sale transaction: "TRXTYPE=S &ACTION=S AMT=35. see Chapter 5. “Transaction Responses. Alternately. For details on the set of response parameters generally passed back in transactions. This is a response to the request. CANCELURL should be the URL of the original page on your website where the customer initially chose to use PayPal.com &TENDER=P &USER=user &VENDOR=vendor" N O T E : It is strongly recommended that RETURNURL be the URL of the final review page on your website where the customer confirms the order and payment. you can generate a web page for your buyer that includes a META REFRESH tag in the header.paypal. Remember to replace <TOKEN> with the token value that you received in the Set Express Checkout response. An example is shown below.” For more information.com &PARTNER=partner &PWD=password &RETURNURL=http://www.confirmation_page. Likewise. PayPal recommends that you use the HTTPS response 302 “Object Moved” with your URL as the value of the Location header in the HTTPS response. the value of RESULT is 0. In a successful response.com/cgi-bin/webscr?cmd=_express-checkout&token=<TOKEN> TOKEN is the value returned in the Set Express Checkout response. Express Checkout for Payflow Pro 13 .00 &CANCELURL=http://www.order_page.com &CUSTOM=TRVV14459 &EMAIL=buyer_name@abc. The redirect URL for this is: https://www. Redirecting the Customer to PayPal Example After your buyer clicks the PayPal button and you submit the Set Express Checkout request. N O T E : Express Checkout has a variation on this redirect URL (called useraction) that allows you to bypass the call to Get Express Checkout Details and to change the text of the button displayed on the PayPal website from “Continue” to “Pay. see “Design Variation: Eliminating Your Order Review Page” on page 25. RESULT=0&RESPMSG=Approved&TOKEN=EC-17C76533PL706494P RESULT and RESPONSE values are returned with all transactions.” The TOKEN value returned associates this customer with this particular Express Checkout flow.

com/cgibin/webscr?cmd=_express-checkout&token=<TOKEN>"> </head> <body> <!-. cell phone)do not support META refresh tags. such as the shipping address and email address. --> <a href="https://www. you need to pass data for these parameters.paypal.URL=https://www.paypal.Most buyers will see the text below for less than a second.com/cgi-bin/webscr?cmd=_expresscheckout&token=<TOKEN>"Click here if you are not redirected to PayPal within 5 seconds.</a> </body> </html> Get Express Checkout Details (ACTION=G) The Get Express Checkout Details request enables you to retrieve the customer’s billing information. --> <!-. 14 Express Checkout for Payflow Pro .1 Express Checkout Processing Flow Express Checkout Sale Transaction Example The following example uses the META REFRESH tag.Some browser types (example. <html> <head> <META HTTP-EQUIV="Refresh"CONTENT="0. If you use Get Express Checkout Details. ACTION TOKEN The following is an example Get Express Checkout Details request parameter string: "TRXTYPE=S &VENDOR=vendor &USER=user &PWD=pwd &TENDER=P &PARTNER=partner &ACTION=G &TOKEN=EC-17C76533PL706494P" The following is the Get Express Checkout Details response.

To the URL string.com &PAYERSTATUS=verified &CUSTOM=TRVV14459 &FIRSTNAME=Chris &LASTNAME=Alexander &BUSINESS=Monroe Creek Regional Interiors &SHIPTOSTREET=5262 Green Street #8 &SHIPTOCITY=San Jose &SHIPTOSTATE=CA &SHIPTOZIP=95148 &SHIPTOCOUNTRY=US 1 Redirecting the Customer to Your Website Example PayPal redirects the customer back to your website at the location you specified in the RETURNURL parameter to Get Express Checkout request. ACTION TOKEN PAYERID AMT The following is an example Do Express Checkout Payment request parameter string: Express Checkout for Payflow Pro 15 . Do Express Checkout Payment request requires that you pass data for these parameters.Express Checkout Processing Flow Express Checkout Sale Transaction Example RESULT=0 &RESPMSG=Approved &AVSADDR=Y &TOKEN=EC-17C76533PL706494P &PAYERID=FHY4JXY7CV9PG &EMAIL=buyer_name@aol. Do Express Checkout Payment (ACTION=D) The Do Express Checkout Payment request performs the actual money transfer of the Sale transaction. PayPal appends the TOKEN and PAYERID name-value pairs. as shown below: http://[RETURNURL]/?token=<TOKEN>&PayerID=<PAYERID> You need to pass the PAYERID in the Do Express Checkout Payment request.

16 Express Checkout for Payflow Pro .00" The following is an example response: RESULT=0 &PNREF=EFHP0CDBF5C7 &RESPMSG=Approved &AVSADDR=Y &TOKEN=EC-17C76533PL706494P &PAYERID=FHY4JXY7CV9PG &PPREF=2P599077L3553652G &PAYMENTTYPE=instantonly The response returns a 12-character PNREF (Payflow Transaction ID) that is used to identify this transaction in PayPal Manager reports.1 Express Checkout Processing Flow Other Express Checkout Concepts "TRXTYPE=S &VENDOR=vendor &USER=user &PWD=pwd &TENDER=P PARTNER=partner &ACTION=D &TOKEN=EC-17C76533PL706494P &PAYERID=FHY4JXY7CV9PG &AMT=35. Obtaining the Buyer’s Telephone Number During Checkout Pending Responses Obtaining the Buyer’s Telephone Number During Checkout You have three options regarding the buyer’s contact telephone number. 2. Log in to your PayPal account. You can choose to: Not request the contact telephone number (default) Request the contact telephone number as an optional field Require that the buyer enter their contact telephone number to proceed. To choose how you want to handle the buyer’s contact telephone number: 1. 3. Other Express Checkout Concepts The following topics are related to processing Express Checkout transactions. From the Profile tab. click Website Payments Preferences. Choose from the three options for handling the contact telephone number at the bottom of the page.

To find out the status of a pending payment. a telephone number displays in the Contact Information on the PayPal Review page during checkout.Express Checkout Processing Flow Other Express Checkout Concepts 1 If you choose to require the buyer provide a telephone number. See PayPal Manager online help for details. Help text tells the buyer how to change the number displayed to their own number. this means the customer has paid with an eCheck. the payment is pending. funds are not guaranteed. Typically. Pending Responses If the Do Express Checkout Payment PENDINGREASON response is a value other than none or completed. you can: Submit an Inquiry transaction. and you should not ship or deliver items or services until the payment has successfully completed. N O T E : PayPal recommends that you block eChecks as a payment method if you are unable to handle pending state payments. Express Checkout for Payflow Pro 17 . Check the status using PayPal Manager. In such a case.

1 Express Checkout Processing Flow Other Express Checkout Concepts 18 Express Checkout for Payflow Pro .

each of which can be used later to create a unique recurring payments profile. You can pass up to a maximum of ten different billing agreement description strings. One L_BILLINGTYPEn must correspond to each L_BILLINGAGREEMENTDESCRIPTIONn in the Set Express Checkout request. you need to set up a billing agreement description. pass the following parameter information in the Set Express Checkout request. the value must be RecurringPayments.1 Set Express Checkout fields for recurring payments Parameter L_BILLINGTYPEn Notes Type of billing agreement. You can also pass the TOKEN returned as a parameter in the request to create a recurring payments profile. Description of goods or services. See the Website Payments Pro Payflow Edition . along with the following parameters: One of the L_BILLINGAGREEMENTDESCRIPTIONn strings TENDER type P to identify the recurring payments as billing a PayPal account Express Checkout for Payflow Pro 19 . As a prerequisite.Recurring Payments Developer’s Guide for details on creating and managing recurring payments profiles. L_BILLINGAGREEMENTDESCRIPTIONn N O T E : You must pass the same L_BILLINGAGREEMENTDESCRIPTIONn string later in the call to create a recurring payments profile for that billing agreement description. as described in “Express Checkout Processing Flow” on page 9. The Set Express Checkout response returns a TOKEN that can be passed in subsequent requests to Get Express Checkout Details and Do Express Checkout Payment in the Express Checkout flow. Creating Multiple Billing Agreement Descriptions Creating a Single Billing Agreement Description Example of Creating a Billing Agreement Description Creating Multiple Billing Agreement Descriptions To set up multiple recurring payments billing agreement descriptions. TABLE 2.2 Express Checkout Recurring Payments This chapter describes how to bill the buyer’s PayPal account on a recurring basis. For recurring payments.

2 Express Checkout Recurring Payments Creating a Single Billing Agreement Description Thereafter. For recurring payments. The advantage of passing L_BILLINGAGREEMENTDESCRIPTIONn strings is that you can use the same TOKEN with each of the other L_BILLINGAGREEMENTDESCRIPTIONn strings passed to Set Express Checkout to create up to ten different recurring payments profiles. the value must be RecurringPayments. you can bill the buyer’s PayPal account on a regular basis as well as mix recurring payments with one-time purchases the buyer makes in the Express Checkout flow. Pass the Set Express Checkout response TOKEN along with the BA_DESC string and TENDER type P in the request to create a single recurring payments profile. below.2 Set Express Checkout fields for recurring payments Parameter BILLINGTYPE BA_DESC Notes Type of billing agreement. See Website Payments Pro Payflow Edition Recurring Payments Developer’s Guide for an example of how to create a recurring payments profile for the PayPal account. TABLE 2. 20 Express Checkout for Payflow Pro . Creating a Single Billing Agreement Description To create a single billing agreement description. Example of Creating a Billing Agreement Description The following Set Express Checkout example returns a TOKEN that can be used to create two recurring payments profiles. The TOKEN returned (EC-5FA74536B1724550T) can be used to create a profile for each of the billing agreement descriptions. String value describing the merchandise or services. you can pass the following parameters in the call to Set Express Checkout.

&CURRENCY=USD &L_BillingType0=RecurringPayments &L_BillingAgreementDescription0=Time magazine &L_BillingType1=RecurringPayments &L_BillingAgreementDescription1=Newsweek magazine &FIRSTNAME=J &LASTNAME=Smith &SHIPTOCITY=San Jose &SHIPTOCOUNTRY=USA US &SHIPTOFIRSTNAME=J &SHIPTOLASTNAME=Smith &SHIPTOSTATE=CA &SHIPTOSTREET=1 Main St &SHIPTOZIP=95131 &paymenttype=any" Set Express Checkout Response RESULT=0 &RESPMSG=Approved &TOKEN=EC-5FA74536B1724550T &CORRELATIONID=e8f1f97944872 Express Checkout for Payflow Pro 21 ..00 &RETURNURL=http://... &CANCELURL=http://.Express Checkout Recurring Payments Example of Creating a Billing Agreement Description 2 Set Express Checkout Request "TRXTYPE=A &USER=mytest01 &TENDER=P &PARTNER=partner &VENDOR=mytest01 &PWD=pwd &ACTION=S &AMT=10..

2 Express Checkout Recurring Payments Example of Creating a Billing Agreement Description 22 Express Checkout for Payflow Pro .

TABLE 3. along with credit card logos. PayPal recommends that you display it in two forms for your customers’ best buying experience: PayPal as a checkout choice on your shopping cart page PayPal as a payment method Table 3.1 PayPal Button Placement Guidelines PayPal Button Graphic Placement At the beginning of checkout as a checkout choice Requirements Align the PayPal Checkout button on your shopping cart page with any other checkout buttons At the end of checkout as a payment method option Place the PayPal Acceptance mark: On your Payment Billing page On your home page. This ensures that you are always displaying the most up-to-date logos. reference the PayPal image paths on the PayPal website. if applicable PayPal button graphics and placement topics below include: HTML for PayPal Button Graphics Design Variation: Eliminating Your Order Review Page Payment Method Page Layout Recommendations HTML for PayPal Button Graphics You can get HTML for the Express Checkout button and PayPal Acceptance Mark from the following location: https://www. Express Checkout for Payflow Pro 23 .1 summarizes these guidelines.paypal.3 PayPal Button Placement and Page Designs When you offer PayPal Express Checkout to your customers.com/express-checkout-buttons Rather than storing the button graphics on your own server.

3 PayPal Button Placement and Page Designs Examples of Button Placement Examples of Button Placement Below are two examples of proper PayPal button graphic placement within the context of web pages.1 PayPal as a Checkout Choice 24 Express Checkout for Payflow Pro . Figure 3. FIGURE 3.1 places the PayPal button graphic as a checkout choice.

when the customer returns from PayPal.PayPal Button Placement and Page Designs Design Variation: Eliminating Your Order Review Page 3 Figure 3. FIGURE 3.) In this situation.2 PayPal Mark as a Payment Method Design Variation: Eliminating Your Order Review Page You can make checkout appear to complete on the PayPal website rather than on your own and. you still call the Do Express Checkout Payment request to complete the transaction. You set this variable on the PayPal URL to which you redirect the buyer after calling Set Express Checkout. you would want the button text on PayPal to appear as “Pay” rather than “Continue. eliminate the need for an order review page on your site.2 places the PayPal mark as a payment method with other payment methods.” You control the button text through the value of the useraction variable. therefore. Values and resulting button text are described below: Express Checkout for Payflow Pro 25 . (Of course.

PayPal displays the button text “Continue Checkout. you have several designs to choose from: As a radio button As horizontal field options In a dropdown list IMPO RTANT: Do not preselect any payment method.4 As Horizontal Field Options FIGURE 3.” To display the “Pay” button text.3 As a Radio Button FIGURE 3.” If you set useraction to commit.paypal. The figures below illustrate each of these layouts.3 PayPal Button Placement and Page Designs Payment Method Page Layout Recommendations If you do not set useraction or you set useraction continue. for example. Allow the customer to make a choice without any default.5 In a Dropdown List 26 Express Checkout for Payflow Pro .com/cgi-bin/webscr?cmd=_expresscheckout&token=tokenvalue&useraction=commit" Payment Method Page Layout Recommendations When you display the PayPal Acceptance mark with other payment methods. FIGURE 3. "https://www. append &useraction=commit to the redirect URL string as shown below where tokenvalue is the token value returned in the Set Express Checkout response. PayPal displays the button text “Pay.

Payment Transaction Types During the Express Checkout flow. After a successful authorization. Honor Period and Authorization Period Payment Transaction Types Authorization Order Do Reauthorization Do Authorization Delayed Capture Void Credit Honor Period and Authorization Period Your business may not be able to provide immediate fulfillment of a product or service. An item. the following transaction types are supported: Sale (TRXTYPE=S) Authorization (TRXTYPE=A) Order (TRXTYPE=O) Express Checkout for Payflow Pro 27 . you can have the buyer approve of placing a 29-day hold or authorization period on their balance for the amount of the authorization to ensure funds are available for capture. may not be immediately available to ship because it is temporarily out of stock. Under these circumstances.4 Sale Express Checkout Transaction Types The Payflow gateway supports transaction types (TRXTYPE) for obtaining payment during the Express Checkout flow as well as for managing the capture of payments after the Express Checkout flow. You can extend the honor period once with a Do Reauthorization or multiple times with a Do Authorization. for example. PayPal honors the authorized funds for a three-day honor period.

You can capture up to the authorized amount specified in the original Authorization transaction. and marks the transaction for immediate fund transfer. If your business does not provide immediate fulfillment of products or services. the payment is complete and no further action is necessary. and Do Express Checkout Payment requests: Set Express Checkout request: TRXTYPE=S. ACTION=S Get Express Checkout Details request (optional): TRXTYPE=S. Get Express Checkout Details. It does not transfer funds. Merchants get around these limitations by choosing to perform an Order 28 Express Checkout for Payflow Pro . for example. you can manage the capture of payment using the following transaction types: Do Reauthorization (TRXTYPE=A) Do Authorization (TRXTYPE=A) Delayed Capture (TRXTYPE=D) Void (TRXTYPE=V) Credit (TRXTYPE=C) Sale A Sale transaction charges the specified amount against the account. Authorization An Authorization transaction represents an agreement to pay. Use a Sale transaction when you can fulfill an order immediately and you know the final amount of the payment at the time you send the Do Express Checkout Payment Details request. if you have the items in stock for immediate shipment. ACTION=G Do Express Checkout Payment request: TRXTYPE=S. see Express Checkout Sale Transaction Example. does become available. ACTION=D After you send the Do Express Checkout Payment request for a Sale transaction. an Authorization enables you to capture funds with a Delayed Capture transaction when backordered merchandise. You cannot capture a further payment or void any part of the payment. For a detailed example of a Sale transaction. you can perform a one-time extension of the Authorization using a Do Reauthorization.4 Express Checkout Transaction Types Sale After the Express Checkout flow. It places the buyer’s funds on hold for a three-day honor period is valid for 29 days. If you are still not able to complete the Authorization and Delayed Capture within the 29-day period. set these parameters in the Set Express Checkout. which returns a RESULT value of 0 (success). for example. To set up a Sale. A Sale is appropriate.

1. To set up an Authorization. in which you send merchandise in more than one shipment—perhaps to different addresses—and you want to collect a payment for each shipment Drop shipments. as it is available Split orders. for example: RESULT=0 &PNREF=EFHP0CDBF5C7 &RESPMSG=Approved &TOKEN=EC-17C76533PL706494P &PAYERID=FHY4JXY7CV9PG &PPREF=2P599077L3553652G To capture authorized funds. See Delayed Capture for details. Get Express Checkout Details. You should use an Order when a Sale or an Authorization with a single Do Reauthorization do not meet your needs. Order An Order transaction represents an agreement to pay one or more authorized amounts up to the specified total over a maximum of 29 days. or shipments from other vendors. in which you send available merchandise immediately and the remaining merchandise. ACTION=G Do Express Checkout Payment request: TRXTYPE=A. Each Do Authorization places the buyer’s funds on hold for up to three days. If the three-day honor period or the valid authorization period expires. Situations in which Orders are appropriate include the handling of the following: Back orders. To set up an Order. you use the PNREF to reference the original Authorization transaction. and Do Express Checkout Payment requests: Set Express Checkout request: TRXTYPE=A. Set TRXTYPE=O in the Set Express Checkout. and Do Express Checkout Payment requests in your Express Checkout flow. Express Checkout for Payflow Pro 29 . ACTION=D Note the value of PNREF in the Do Express Checkout Payment response.Express Checkout Transaction Types Order 4 transaction instead of an Authorization. Get Express Checkout Details. set these parameters in the Set Express Checkout. An Authorization uses the same parameters as a Sale transaction except that TRXTYPE is A. Orders provide greater flexibility with fewer time constraints when handling products or services that not immediately available. See Express Checkout Sale Transaction Example for details. simply create another Do Authorization. Orders provide you with greater flexibility in delivering merchandise than Authorizations. for which you accept the payment To create multiple authorizations of the Order over the 29-day period. ACTION=S Get Express Checkout Details request (optional): TRXTYPE=A. use the Do Authorization transaction.

you can use a Do Reauthorization transaction. for example: "TRXTYPE=Dcg&TENDER=P&PARTNER=partner&USER=user&VENDOR=vendor&PWD=pwd&OR IGID=EFHP0CDBF6C8" Do Reauthorization To reauthorize an Authorization for an additional three-day honor period. ACTION=S – Get Express Checkout Details request (optional): TRXTYPE=O. To set up a Do Reauthorization. To authorize the Order. set ORIGID=PNREF (PNREF value returned in original Order response) and TRXTYPE=A in a Do Authorization transaction request. you must first authorize it. for example: RESULT=0 &PNREF=EFHP0CDBF5C7 &RESPMSG=Approved &TOKEN=EC-17C76533PL706494P &PAYERID=FHY4JXY7CV9PG &PPREF=2P599077L3553652G To capture an Order. for example: "TRXTYPE=A &TENDER=P &PARTNER=partner &USER=user &VENDOR=vendor &PWD=pwd &ORIGID=EFHP0CDBF5C7" This is the Do Authorization response: RESULT=0 &PNREF=EFHP0CDCG6C8 &RESPMSG=Approved &PPREF=3Q600078M3553652G 2. set ORIGID=PNREF (PNREF returned in the Do Authorization response) and TRXTYPE=D. Note the value of PNREF in the Do Express Checkout Payment response. you must pass the following parameters in the request string: Set ORIGID=PNREF (PNREF returned in the original Authorization response) Set TRXTYPE=A Set DoReauthorization=1 This is an example Do Reauthorization request string with required parameters: 30 Express Checkout for Payflow Pro . ACTION=D 2.4 Express Checkout Transaction Types Do Reauthorization – Set Express Checkout request: TRXTYPE=O. To capture the Do Authorization. A Do Reauthorization can be used at most once during the 29-day authorization period. 1. ACTION=G – Do Express Checkout Payment request: TRXTYPE=O.

Express Checkout for Payflow Pro 31 . you will see the funds in your PayPal account. You cannot use Do Reauthorization against a Do Authorization. N O T E : You can only use Do Authorization if the original transaction in the Express Checkout flow is an Order. Once a capture is approved. Set TRXTYPE=A In this example. This is the Do Authorization request string: "TRXTYPE=A &TENDER=P &PARTNER=partner &USER=user &VENDOR=vendor &PWD=pwd &ORIGID=EFHP0CDBF7D9" Delayed Capture A Delayed Capture transaction captures authorized funds and transfers them to PayPal.Express Checkout Transaction Types Do Authorization "TRXTYPE=A &TENDER=P &PARTNER=partner &USER=user &VENDOR=vendor &PWD=pwd &ORIGID=EFHP0CDBF5C7 &DOREAUTHORIZATION=1" 4 Do Authorization A Do Authorization transaction represents an agreement to pay and places the buyer’s funds from the original Order transaction on hold for up to three days. You can capture up to the amount specified in the original Authorization. the PNREF returned in the original Order response is EFHP0CDBF7D9. you must pass the following parameters in the request string: Set ORIGID=PNREF (PNREF value returned in the original Order transaction response only) N O T E : Do not pass the PPREF returned from the original Order transaction in place of the PNREF. It does not transfer funds. To set up a Do Authorization.

set CAPTURECOMPLETE=Y to void any remaining amount of the original authorized transaction This example is based on an initial Authorization for $100. Do Authorization. "TRXTYPE=D &TENDER=P &PARTNER=partner &USER=user &VENDOR=vendor &PWD=pwd &ORIGID=EFHP0CDBF5C7" Partial Capture To set up a partial capture of authorized funds. TRXTYPE=D&TENDER=C&PWD=SuperUserPassword&PARTNER=PayPal&VENDOR=SuperMerc hant&USER=SuperMerchant&CAPTURECOMPLETE=Y&ORIGID=EFHP0D426A51&AMT=34.00 32 Express Checkout for Payflow Pro . Once you have shipped the remainder of the merchandise.00" 2.4 Express Checkout Transaction Types Delayed Capture Complete Capture To set up a capture of the total amount in the original Authorization. Capture the authorized funds for a partial shipment of $66. or Do Reauthorization transaction response) Set TRXTYPE=D Set the value for AMT Set CAPTURECOMPLETE=N to perform a partial capture. You charge the $34 for the final part of the shipment using a second Delayed Capture transaction. or Do Reauthorization transaction response) Set TRXTYPE=D This is an example Delayed Capture request string with required parameters. capture the $34 balance. Do Authorization. pass the following parameters in the Delayed Capture request string: Set ORIGID=PNREF (PNREF value returned in the original Authorization. you must pass the following parameters in the Delayed Capture request string: Set ORIGID=PNREF (PNREF value returned in the original Authorization. "TRXTYPE=D &TENDER=C &PWD=SuperUserPassword &PARTNER=PayPal VENDOR=SuperMerchant USER=SuperMerchant &CAPTURECOMPLETE=N &ORIGID=EFHP0D426A51 &AMT=66. 1. You charge $66 for the first partial shipment using a Delayed Capture transaction.

Do Authorization. or Do Reauthorization) N O T E : You can use a Void transaction only on transactions that have not yet settled.Express Checkout Transaction Types Void 4 Void A Void transaction voids any of the following transaction types: Order Authorizations (Authorization. However. PayPal makes reasonable effort to process authorization reversals for void transactions for debit and credit cards. you must pass the following parameters in the request string: Set ORIGID=PNREF (PNREF value returned in the response to the original Sale or Delayed Capture) Set TRXTYPE=C Set the value for AMT if the amount of the credit differs from the original Sale or Delayed Capture transaction This is an example Credit request string with the required parameters set: Express Checkout for Payflow Pro 33 . To set up a Void transaction. Credit transactions are permitted only against existing Sale and Delayed Capture transactions. "TRXTYPE=V &TENDER=P &PARTNER=partner &USER=user &VENDOR=vendor &PWD=pwd &ORIGID=EFHP0CDBF5C7" Credit A Credit transaction refunds the buyer for a settled transaction. If you void an unsettled transaction. the full authorized amount of the original transaction becomes void and can no longer be captured. N O T E : As part of its internal process. you must use a Credit transaction. there is no guarantee authorization reversal requests will be honored. you must pass the following parameters in the request string: Set ORIGID=PNREF (PNREF value returned in the response to the original Authorization or Order) Set TRXTYPE=V This is an example Void transaction request string with the required parameters set. To refund a customer’s money for a settled transaction. To set up a Credit transaction request.

The merchant can send a Memo Post Sale (above transaction) to Paymentech so Paymentech can include that Sale information in the merchant’s Paymentech account. 34 Express Checkout for Payflow Pro . for example. The advantage to the merchant is that the merchant can view PayPal Sale activities in their Paymentech reports.00" Say.4 Express Checkout Transaction Types Credit "TRXTYPE=C &TENDER=P PARTNER=partner VENDOR=vendor &USER=user &PWD=password &ORIGID=EFHP0D426A62 &AMT=45. The merchant uses a Memo Post Credit to send the buyer’s Credit transaction information to Paymentech so the merchant can see the buyer’s Credit information in their Paymentech reports. a buyer purchases merchandise from a particular merchant using the buyer’s PayPal account.

For more information on corrective actions. Limitations: Numeric. Response Parameters Address Verification Service Responses From PayPal Card Security Code Results PNREF Value RESULT Values and RESPMSG Text Response Parameters When a transaction finishes. PNREF Payflow Transaction ID. A result of 0 (zero) indicates the transaction was approved. Any other number indicates a decline or error. For example. the server returns a response string made up of name-value pairs. a unique 12-character alphanumeric string that identifies the transaction. N O T E : The PayPal processor may also return a warning message in the RESPMSG string when RESULT=0. TABLE 5. Express Checkout for Payflow Pro 35 . this is a response to a Sale transaction request: RESULT=0 &PNREF=EFHP0D426A53 &RESPMSG=APPROVED &AUTHCODE=25TEST &AVSADDR=Y &AVSZIP=N &CVV2MATCH=Y &PPREF=68W3371331353001F &CORRELATIONID=2dc60e253495e Express Checkout transaction responses include the response parameters described below as well as parameters returned by the specific transaction type (TRXTYPE) and ACTION. see the PayPal developer documentation on Developer Central.1 General response parameters Parameter RESULT Description The outcome of the attempted transaction.5 Transaction Responses Transaction response parameters indicate the status of the transaction and return requested information.

Limitations: Alphanumeric. With this setting. Sometimes a colon appears after the initial RESPMSG followed by more detailed information. see the PayPal developer documentation on Developer Central. set the VERBOSITY parameter to MEDIUM. N O T E : The PayPal processor may also return a warning message in the RESPMSG RESPMSG string when RESULT=0. Exact wording varies.1 General response parameters Parameter PPREF Description Unique PayPal transaction ID of the payment. CORRELATIONID Value used for tracking.2 Address Verification Service response value mapping PayPal Processor Address Verification Service Code A B C D E F G I Meaning Address International “A” International “N” International “X” Not allowed for MOTO (Internet/Phone) transactions UK-specific “X” Global Unavailable International Unavailable AVSADDR Y Y N Y X Y X X AVSZIP N N N Y X Y X X 36 Express Checkout for Payflow Pro . For more information on corrective actions. Limitations: 13-character alphanumeric string.5 Transaction Responses Address Verification Service Responses From PayPal TABLE 5. Address Verification Service Responses From PayPal The table below compares the detailed response returned by the PayPal processor for address verification to the normalized response value (Y. Limitations: 17-character string. The response message returned with the transaction result. or X) returned in the AVSADDR and AVSZIP response parameters. N. you should store the value of PPREF if you need to research a specific transaction with PayPal. If the request ACTION was A (Authorization). TABLE 5. the processor value is returned in the PROCAVS response parameter. If you want to obtain the PayPal processor value.

2 Address Verification Service response value mapping PayPal Processor Address Verification Service Code N P R S U W X Y Z All other 5 Meaning No Postal (International “Z”) Retry Service not Supported Unavailable Whole Zip Exact Match Yes Zip AVSADDR N N X X X N Y Y N X AVSZIP N Y X X X Y Y Y Y X Card Security Code Results The CVV2MATCH parameter returns Y. Normalized Results If you submit the transaction request parameter for card security code (that is. the CVV2 parameter). as described in the table below. Express Checkout for Payflow Pro 37 . The cardholder’s bank does not support this service.Transaction Responses Card Security Code Results TABLE 5. N. The CVV2MATCH parameter returns Y. TABLE 5. N. X. the cardholder’s bank returns a normalized Yes/No response in the CVV2MATCH response parameter. or a processor-specific response. or X.3 CVV2MATCH response values CVV2MATCH Value Y N X Description The submitted value matches the data on file for the card The submitted value does not match the data on file for the card.

5 Transaction Responses PNREF Value PayPal Card Security Code Results The table below shows the detailed results returned by the PayPal processor for card security codes. If you want to obtain the PayPal processor value. set the VERBOSITY parameter to MEDIUM. The PNREF in a transaction response tells you that your transaction is connecting to PayPal. The processor value is returned in the PROCCVV2 response parameter. and Voids (TRXTYPE=V). Credits (TRXTYPE=C). and transaction data purposes. The PNREF value is used as the ORIGID value (original transaction ID) value in reference transactions for Authorization (TRXTYPE=A) and Sale (TRXTYPE=S). N O T E : The PNREF is also referred to as the Transaction ID in PayPal Manager. A PNREF typically contains letters and numbers only. The PNREF value appears in the Transaction ID column in PayPal Manager reports.4 Card security code response code mapping PayPal Processor CVV2 Code M N P S U X All other PayPal Processor Code Description Match No Match Not Processed Service Not Supported Unavailable No Response PROCVV2MATCH Y N X X X X X PNREF Value The PNREF is a unique transaction identification number issued by PayPal that identifies the transaction for billing. The PNREF value is used as the ORIGID value (original transaction ID) in Delayed Capture transactions (TRXTYPE=D). TABLE 5. Inquiries (TRXTYPE=I). for example: VADE0B248932 ACRAF23DB3C4 N O T E : Printable characters also include symbols other than letters and numbers such as the question mark (?). reporting. 38 Express Checkout for Payflow Pro . PNREF Format The PNREF is a 12-character string of printable characters.

See the PayPal API documentation on Developer Central for detailed information on corrective actions. VENDOR is your merchant ID and USER is the same as VENDOR unless you created a Payflow Pro user. A value less than zero indicates that a communication error occurred. PARTNER. You are using a test (not active) account to submit a transaction to the live PayPal servers. no transaction is attempted. See the table below). The transaction is coming from an unknown IP address. and PASSWORD have been entered correctly.5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 0 1 RESPMSG and Explanation Approved User authentication failed. When interpreting RESULT values for the PayPal processor.Transaction Responses RESULT Values and RESPMSG Text 5 RESULT Values and RESPMSG Text The RESULT parameter and value is the first name-value pair returned in the response string. you should retry it. Verify that USER. A value greater than zero indicates a decline or error (except in the case of RESULT 104. See PayPal Manager online help for details on how to use Manager to update the allowed IP addresses. The response message (RESPMSG) provides a brief description for decline or error results. VENDOR. note the following: When RESULT=0. Sometimes a colon appears after the initial RESPMSG followed by more detailed information. warning information may be returned that is useful to the request application. TABLE 5. The exact wording of the RESPMSG (shown in bold) may vary. Contact merchant bank to verify. Error is caused by one or more of the following: Login information is incorrect. you must log in to the PayPal website to determine if the transaction actually went through. "Allowed IP Address" security feature implemented. Change the host address from the test server URL to the live server URL Express Checkout for Payflow Pro 39 . The value of RESULT indicates the overall status of the transaction attempt: A value of 0 (zero) indicates that no errors occurred and the transaction was approved. All fields are case sensitive. When RESULT=104. Invalid Processor information entered. RESULT Values for Transaction Declines or Errors For non-zero RESULT values. If the transaction does not appear in the History section. In this case. the response string includes a RESPMSG name-value pair.

Check the credit card number. See RESPMSG Not a transaction server Too many parameters or invalid stream Too many line items Client time-out waiting for response Declined. See RESPMSG Cannot find the customer reference number Invalid ABA number Invalid account number.5 Transaction Responses RESULT Values and RESPMSG Text TABLE 5. Error is caused by one or more of the following: You are trying to process a tender type such as Discover Card. Invalid information entered. Invalid merchant information. The transaction ID you entered for this transaction is not valid.5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 2 3 4 5 6 7 8 9 10 11 12 RESPMSG and Explanation Invalid tender type. but you are not set up with your merchant bank to accept this card type. Contact your bank account acquirer to resolve this problem. Contact your merchant bank to obtain an authorization and submit a manual Voice Authorization transaction. Referral. 13 19 20 22 23 24 25 40 Express Checkout for Payflow Pro .##” Do not include currency symbols or commas. Transaction type is not appropriate for this transaction. Processor does not recognize your merchant account information. have the customer call their card issuing bank to resolve. Check credit card number and re-submit. Invalid Host Mapping. Your merchant bank account does not support the following credit card type that was submitted. Use the format: “#####. expiration date. Contact your account holder to have Express Checkout added to your account. Invalid expiration date. You are trying to process an Express Checkout transaction when your account is not set up to do so. For example. If this does not resolve the problem. Check and re-submit. and transaction information to make sure they were entered correctly. Invalid or unsupported currency code Field format error. you cannot credit an authorization-only transaction Invalid amount format. Invalid transaction type. Transaction cannot be approved electronically but can be approved with a verbal authorization. Original transaction ID not found.

5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 26 RESPMSG and Explanation Invalid vendor account. See RESPMSG. Verify that USER. VENDOR is your merchant ID and USER is the same as VENDOR unless you created a Payflow Pro user.) Host not available Duplicate suppression time-out 5 27 28 29 30 31 32 33 34 35 36 37 50 51 99 100 101 102 103 104 105 106 107 Express Checkout for Payflow Pro 41 . VENDOR. you cannot credit an authorization. Insufficient partner permissions Insufficient user permissions Invalid XML document. Try your transaction again. Duplicate transaction Error in adding the recurring profile Error in modifying the recurring profile Error in canceling the recurring profile Error in forcing the recurring profile Error in reactivating the recurring profile OLTP Transaction failed Invalid recurring profile ID Insufficient funds available in account Exceeds per transaction limit General error. or that this transaction ID is for a creditable transaction.Transaction Responses RESULT Values and RESPMSG Text TABLE 5. All fields are case sensitive. (For example. PARTNER. Make sure you have not already credited this transaction. Credit error. This could be caused by an unrecognized XML tag or a bad XML format that cannot be parsed by the system. and PASSWORD have been entered correctly. Transaction type not supported by host Time-out value too small Processor not available Error reading response from host Timeout waiting for processor response. Login information is incorrect.

An authorization may still exist on the cardholder’s account. CSC validation failed. Merchant sale total will exceed the sales cap with current transaction. If not.5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 108 RESPMSG and Explanation Void error. Card Security Code (CSC) Mismatch. Either an attempt to capture a transaction that is not an authorization transaction type. ACH transactions only. then no values are returned for AVS or CSC. One or more of the following three failures occurred: An attempt was made to submit a transaction that failed to meet the security settings specified on the PayPal Manager Security Settings page. Failed to lock terminal number Failed merchant rule check. AVS validation failed. Address and ZIP code do not match. If the transaction exceeded the Maximum Amount security setting. try again later VPS Internal error. (The Batch field is set to a number greater than zero if the transaction has been settled). Make sure the transaction ID entered has not already been voided. Fraud Protection Services Filter — Declined by filters 109 110 111 112 113 114 115 116 117 118 120 121 122 125 42 Express Checkout for Payflow Pro . Failed AVS check.5 Transaction Responses RESULT Values and RESPMSG Text TABLE 5. ACH transactions only. or an attempt to capture an authorization transaction that has already been captured. An authorization may still exist on the cardholder’s account. System busy. See RESPMSG. The AVS return value should appear in the RESPMSG. your only recourse is a reversal (credit a payment or submit a payment for a credit) Time-out waiting for host response Referenced auth (against order) Error Capture error. If the transaction has already settled. then look at the Transaction Detail screen for this transaction to see if it has settled. The CSC return value should appear in the RESPMSG Invalid keywords found in string fields Attempt to reference a failed transaction Not enabled for feature Merchant sale total will exceed the credit cap with current transaction.

Transaction Responses RESULT Values and RESPMSG Text TABLE 5.5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 126 RESPMSG and Explanation Fraud Protection Services Filter — Flagged for review by filters I M P O R T A N T : RESULT value 126 indicates that a transaction triggered a fraud 5 filter. To eliminate RESULT 126. Buyer Authentication Service unavailable Buyer Authentication Service — Transaction timeout Buyer Authentication Service — Invalid client version Buyer Authentication Service — Invalid timeout value Buyer Authentication Service unavailable Buyer Authentication Service unavailable Buyer Authentication Service unavailable Buyer Authentication Service — Merchant is not enrolled for Buyer Authentication Service (3-D Secure) Express Checkout for Payflow Pro 43 . 127 128 132 133 150 151 200 201 600 601 1000 1001 1002 1003 1004 1011 1012 1013 1014 Fraud Protection Services Filter — Not processed by filters Fraud Protection Services Filter — Declined by merchant after being flagged for review by filters Card has not been submitted for update Data mismatch in HTTP retry request Issuing bank timed out Issuing bank unavailable Reauth error Order error Cybercash Batch Error Cybercash Query Error Generic host error. For more information. RESULT value 126 is intended to give you an idea of the kind of transaction that is considered suspicious to enable you to evaluate whether you can benefit from using the Fraud Protection Services. This is a generic message returned by your credit card processor. but a notice that the transaction is in a review status. see the fraud documentation for your payments solution. The RESPMSG will contain more information describing the error. turn the filters off. The transaction has been authorized but requires you to review and to manually accept the transaction before it will be allowed to settle. This is not an error.

5 Payflow Transaction RESULT Values and RESPMSG Text RESULT 1016 RESPMSG and Explanation Buyer Authentication Service — 3-D Secure error response received. Buyer Authentication Service — 3-D Secure error response is invalid. an error response was received. Instead of receiving a PARes response to a Validate Authentication transaction. An error response is received and the response is not well formed for a Validate Authentication transaction. Buyer Authentication Service — Invalid card type Buyer Authentication Service — Invalid or missing currency code Buyer Authentication Service — merchant status for 3D secure is invalid Buyer Authentication Service — Validate Authentication failed: missing or invalid PARES Buyer Authentication Service — Validate Authentication failed: PARES format is invalid Buyer Authentication Service — Validate Authentication failed: Cannot find successful Verify Enrollment Buyer Authentication Service — Validate Authentication failed: Signature validation failed for PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid amount in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid acquirer in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid Merchant ID in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid card number in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid currency code in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid XID in PARES Buyer Authentication Service — Validate Authentication failed: Mismatched or invalid order date in PARES Buyer Authentication Service — Validate Authentication failed: This PARES was already validated for a previous Validate Authentication transaction 1017 1021 1022 1023 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 44 Express Checkout for Payflow Pro .5 Transaction Responses RESULT Values and RESPMSG Text TABLE 5.

Either log in with your existing PayPal account or create a new account by clicking Sign Up. Complete the information in the Business Owner Contact Information section. On the Internet Merchant Account application. 6. 7.paypal. follow the procedure below to create one. 5. Choose a password you can remember. If your account is already set up.com/ and enter the following: – Partner Name: PayPal – Merchant login: yourcompanynametest Express Checkout for Payflow Pro 45 . 3. for example. Go to the following URL and click Continue: https://registration. Sign up for a Payflow Pro test account.paypal.6 Express Checkout Testing You can set up the testing of your integration using two methods. If you enter it incorrectly too many times. click Save and Exit. and click Continue. yourcompanynametest.com/productSelectionInit. you will be locked out. PayPal Manager account information: – Merchant Login: (Enter all lowercase characters. Complete the information in the Business Information section. Testing Your Integration Using the Sandbox Testing Your Integration Using the PayPal Simulator Testing Your Integration Using the Sandbox To set up the testing of your integration using the Sandbox: Create A Business Account Create a Payflow Test Account Link Your Payflow Pro Account to the Sandbox Create A Business Account If you do not already have a Payflow account. proceed to “Create a Payflow Test Account” on page 46 1.) – Password: (The password is case sensitive.do 2. go to https://manager. To test your login.) 4.

Enter the Subject as: Link Payflow Pro to Sandbox 3. If you have an existing Sandbox account.com Send Express Checkout redirects to: https://www. Provide the following: – Your Payflow Pro Merchant account login email address and password – The login email address and password of the Seller account you created in the Sandbox Test Environment 4. For Country.6 Express Checkout Testing Testing Your Integration Using the Sandbox – Password: (your password) Your account should show the following status message: Your account is currently in TEST status.sandbox. select United States. Be sure to: Send all test transaction requests as POSTs to the Payflow host address: https://pilotpayflowpro. click Sign Up Now and create a Sandbox Seller account. click Test Accounts. 4. Create a Payflow Test Account To create Payflow test account. 7. Click Create Test Account. log in to the Sandbox. Once you are logged into the PayPal Sandbox Test environment. select Seller. You can run only test transactions. 6.paypal.paypal. Click Show Advanced Options. allowing you to redirect Express Checkout transactions through the Sandbox environment. 8. For Account Type. Otherwise. follow the procedure below: 1. 3. Add a balance of 500 to the Seller account. Submit the ticket. follow the procedure below: 1. Link Your Payflow Pro Account to the Sandbox To link your Payflow Pro account to the Sandbox. Click Log Out. Your Merchant ID and Sandbox Seller account will be linked within 72 hours. Click the Contact Support tab.com/cgibin/webscr?cmd=_express-checkout&token=<ec-token> NOTE: You must be logged into the Sandbox before redirecting. 2. 5. Note the Seller’s login email address and password. 2. 46 Express Checkout for Payflow Pro .

Express Checkout Testing
Testing Your Integration Using the PayPal Simulator

6

You should also create a Buyer account in the Sandbox to make test Express Checkout purchases against your Seller account. Be sure to add a positive balance to the Buyer account at the time of creation.

Testing Your Integration Using the PayPal Simulator
To test your integration using the simulator, direct all test transactions to the Payflow host address for testing: https://pilot-payflowpro.paypal.com Transactions are processed through PayPal’s simulated payment network, enabling you to test the configuration and operation of your application or storefront—with no money changing hands.
N O T E : You

must activate your account and configure your application for live transactions in PayPal Manager before accepting real orders.

Express Checkout for Payflow Pro

47

6

Express Checkout Testing
Testing Your Integration Using the PayPal Simulator

48

Express Checkout for Payflow Pro

A

Express Checkout Parameter Reference
This reference describes all parameters that can be used with the Express Checkout payment solution. “Connection Parameter Descriptions” on page 49 “User Parameter Descriptions” on page 50 “Express Checkout Parameter Descriptions” on page 51 “Do Reauthorization Parameter Descriptions” on page 68 “Do Authorization Parameter Descriptions” on page 67 “Void Parameter Descriptions” on page 69 “Credit Parameter Descriptions” on page 70 “Delayed Capture Parameter Descriptions” on page 71

Connection Parameter Descriptions
Pass the connection parameters in the format and syntax required by the Payflow gateway and programming language that you are using. See your integration documentation for details.
TABLE A.1 Connection request parameters Parameter HOSTADDRESS HOSTPORT PARMLIST Description (Required) Payflow host name (Required) Use port 443. (Required) List of parameters that specify the payment information for the transaction. The quotation marks “ ” at the beginning and end are required. The following is an example:
"TRXTYPE=S&TENDER=C&PARTNER=Partner&VENDOR=vendor&USER=user& PWD=password&ACCT=5555555555554444&EXPDATE=0308&AMT=123.00"

The content of the PARMLIST varies by the type of transaction being processed. For example, a Void transaction requires a different set of parameters than a Sale. PROXYADDRESS PROXYPORT PROXYLOGON (Optional) Proxy server address. Use the PROXY parameters for servers behind a firewall. Your network administrator can provide the values. (Optional) Proxy server port. (Optional) Proxy server logon ID.

Express Checkout for Payflow Pro Reference Transactions

49

Express Checkout Parameter Reference
User Parameter Descriptions TABLE A.1 Connection request parameters Parameter PROXYPASSWORD Description (Optional) Proxy server logon password.

User Parameter Descriptions
All Payflow transaction requests require the user parameters described below.
TABLE A.2 User request parameters Parameter USER Description (Required) If you set up one or more additional users on the account, this value is the ID of the user authorized to process transactions. If, however, you have not set up additional users on the account, USER has the same value as VENDOR. Limitations: 64 alphanumeric, case-sensitive characters.Limitations: 64 alphanumeric, case-sensitive characters. (Required) Your merchant login ID that you created when you registered for the account. Limitations: 64 alphanumeric, case-sensitive characters.Limitations: 64 alphanumeric, case-sensitive characters. (Required) The ID provided to you by the authorized PayPal Reseller who registered you for the Payflow Pro service. Limitations: 12 alphanumeric, case-sensitive characters. (Required) The password that you defined while registering for the account. Limitations: Six- to thirty-two alphanumeric, case-sensitive characters.

VENDOR

PARTNER

PWD

50

Express Checkout for Payflow Pro Reference Transactions

95. See “Currency Codes” on page 73. N O T E : You must set CURRENCY set to one of the currency codes for any of the supported PayPal currencies. Limitations: One alpha character.Express Checkout Parameter Reference Express Checkout Parameter Descriptions Express Checkout Parameter Descriptions Set Express Checkout Request Parameter Descriptions TABLE A.000 USD in any currency. Limitations: Must not exceed $10.3 Set Express Checkout request parameters Parameter TRXTYPE Description (Required) How you want to obtain payment: A indicates that this payment is an Authorization subject to settlement with the Delayed Capture request O indicates that this payment is an Order subject to settlement with the Delayed Capture request S indicates that this is a final Sale for which you are requesting payment N O T E : You cannot set this value to S in the Set Express Checkout request and then change this value to A on the final Do Express Checkout Payment request. Limitations: One alpha character. Limitations: Character string with no maximum length. based currency.199. not 34.95 not 1. It is always P. Nine numeric characers plus decimal (. Nine numeric characters plus decimal. CURRENCY RETURNURL (Required) One of the supported currency codes.S. Limitations: Character string with no maximum length.” (Required) URL to which the customer’s browser is returned after choosing to pay. (Required) URL to which the customer is returned if the customer cancels the order. Do not include comma separators—use 1199. CANCELURL Express Checkout for Payflow Pro Reference Transactions 51 . Limitations: One alpha character.00. TENDER ACTION AMT (Required) The tender type (method of payment). No currency symbol. (Required) Is S to indicate this is a Set Express Checkout request. Specify the exact amount to the cent using a decimal point—use 34. (Required) Amount (US Dollars) U.) character.

BA_CUSTOM (Optional) Custom annotation field for your exclusive use with billing agreements. where n is a value from 0 to 9. See L_BILLINGTYPEn. (Optional) Describes the billing type for a PayPal account. The value is returned in a previous Set Express Checkout response. The possible values are: RecurringPayments Use this value to use the TOKEN returned by the Set Express Checkout response as a parameter in a request to create a Recurring Payments profile. Character length and limitations: A string.Recurring Payments Developer’s Guide for details. N O T E : If you pass L_BILLINGTYPEn and BILLINGTYPE. Limitations: 20-character alphanumeric string. See Website Payments Pro Payflow Edition . Character length and limitations: A string.3 Set Express Checkout request parameters Parameter TOKEN Description (Optional) Include this parameter to modify an existing Sale or Authorization request. (Optional) Describes the billing agreement for a PayPal account. Limitations: 255-character string. BILLINGTYPE also must be specified. n is a value in the range 0-9. Character length and limitations: 36 alphanumeric characters. See Website Payments Pro Payflow Edition . L_BILLINGAGREEMEN TDESCRIPTIONn BILLINGTYPE (Optional) Describes the billing type for a PayPal account. If BILLINGTYPE is specified. (Optional) Describes the billing type for a PayPal account. Each L_BILLINGTYPEn must have a corresponding description string (L_BILLINGAGREEMENTDESCRIPTIONn). the L_BILLINGTYPEn BILLINGTYPE parameter will be ignored. The possible values are: RecurringPayments Use this value to use the TOKEN returned by the Set Express Checkout response as a parameter in a request to create a Recurring Payments profile. BA_DESC L_NAMEn 52 Express Checkout for Payflow Pro Reference Transactions . See L_BILLINGTYPEn.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. n is a value in the range 0-9. BA_DESC also must be specified. n is a value in the range 0-9. Limitations: 255-character string (Optional) Line-item name. Character length and limitations: A string.Recurring Payments Developer’s Guide for details. If BA_DESC is specified.

) character. The line-item unit price can be a positive or a negative value but not 0.199.199. No currency symbol.) character. Limitations: 10-character integer. N O T E : You must set CURRENCY to one of the three-character currency L_QTYn ITEMAMT TAXAMT FREIGHTAMT codes for any of the supported PayPal currencies. Nine numeric characters plus decimal. L_COSTn (Required if L_QTYn is supplied) Cost of the line item. (Optional) Total shipping cost for this order.95 not 1. Limitations: Nine numeric characers plus decimal (. Limitations: Nine numeric characers plus decimal (.00.) character. not 34. (Required if L_COSTn is supplied) Line-item unit quantity.00. No currency symbol.95. Do not include comma separators—use 1199.00.95 not 1.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. (Required if L_TAXAMTn is specified) Sum of tax for all items in this order. not 34. not 34. Do not include comma separators—use 1199.199. Specify the exact amount to the cent using a decimal point—use 34. Specify the exact amount to the cent using a decimal point—use 34. Specify the exact amount to the cent using a decimal point—use 34.95 not 1. (Required if L_COSTn is specified) Sum of cost of all items in this order. No currency symbol. No currency symbol. L_TAXAMTn (Optional) Line-item tax amount. Do not include comma separators—use 1199. Specify the exact amount to the cent using a decimal point—use 34.199. Limitations: Nine numeric characers plus decimal (. N O T E : You must set CURRENCY to one of the three-character currency codes for any of the supported PayPal currencies. See CURRENCY in this table for details. Specify the exact amount to the cent using a decimal point—use 34. No currency symbol.00.) character.95 not 1.00.3 Set Express Checkout request parameters Parameter L_DESCn Description (Optional) Line-item description for each different item purchased such as hiking boots or cooking utensils. Limitations: 35-character string. Do not include comma separators—use 1199. not 34. not 34.199. Do not include comma separators—use 1199. N O T E : You can view line item information in the Transaction Details report in your PayPal merchant account.) character.95.95.95 not 1. Limitations: Nine numeric characers plus decimal (.95. Limitations: Nine numeric characers plus decimal (. Express Checkout for Payflow Pro Reference Transactions 53 .95.

(Optional) The expected maximum total amount of the complete order.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A.95 not 1. Specify the exact amount to the cent using a decimal point—use 34.3 Set Express Checkout request parameters Parameter HANDLINGAMT Description (Optional) Total handling cost for this order. Limitations: Nine-character alphanumeric string. (Optional) Free-form field for your own use such as a tracking number or other value you want PayPal to return in the Get Express Checkout Details response.00.199.95 not 1. the transaction ID (PNREF) will be submitted.) character. Limitations: 256-character alphanumeric string.95. (Optional) Total shipping insurance cost for this order.00. No currency symbol. No currency symbol. Limitations: Nine numeric characers plus decimal (.95 not 1.) character.199. Specify the exact amount to the cent using a decimal point—use 34. (Optional) Is 1 or 0 (default). Limitations: Nine numeric characers plus decimal (. Do not include comma separators—use 1199.) character. not 34. Specify the exact amount to the cent using a decimal point—use 34. No currency symbol. No currency symbol. not 34. N O T E : You must set CURRENCY to one of the three-character currency codes for any of the supported PayPal currencies. Do not include comma separators—use 1199. including shipping and tax charges. Specify the discount as a positive amount. Limitations: Nine numeric characers plus decimal (. not 34.) character.00. Limitations: 127-character alphanumeric string. Specify the exact amount to the cent using a decimal point—use 34. If 1.00. (Optional) Description of items the customer is purchasing. DISCOUNT (Optional) Shipping discount for this order. If you do not provide an invoice number. not 34. Do not include comma separators—use 1199. Limitations: Nine numeric characers plus decimal (. the buyer may enter a note in the Express Checkout flow to be returned by the responses to Get Express Checkout Details and Do Express Checkout Payment.95 not 1. Limitations: Numeric. (Optional) Merchant invoice number.95.95.95. INSURANCEAMT ALLOWNOTE MAXAMT ORDERDESC CUSTOM INVNUM 54 Express Checkout for Payflow Pro Reference Transactions .199. Do not include comma separators—use 1199.199.

Limitations: Four-character string. Setting this element overrides the setting you have specified in your Merchant Account Profile Limitations: One character. Limitations: Four-character string. (Optional) Is 1 or 0. Setting this element overrides the setting you have specified in your Merchant Account Profile.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. The value 1 indicates that on the PayPal pages. not the shipping address on file with PayPal for this customer. AT AU BE CA CH CN DE ES FR GB IT JP NL PL US REQBILLINGADDRESS REQCONFIRMSHIPPIN G NOSHIPPING ADDROVERRIDE LOCALECODE Express Checkout for Payflow Pro Reference Transactions 55 .3 Set Express Checkout request parameters Parameter PHONENUM Description Account holder’s telephone number. The value 1 indicates that you require that the customer’s shipping address on file with PayPal be a confirmed address. Limitations: 20-character string. Limitations: One character. The value 1 indicates that the PayPal pages should display the shipping address set by you in the shipping address (SHIPTO* parameters) passed to this Set Express Checkout request. The field mask is: xxx-xxx-xxxx (US numbers) +xxxxxxxxxxx (international numbers) (Optional) Is 1 or 0. no shipping address fields should be displayed whatsoever. (Optional) Is 1 or 0. The value 1 indicates that you require that the customer’s shipping address on file with PayPal be a confirmed address. (Optional) Locale of pages displayed by PayPal during Express Checkout Limitations: Two-character string. (Optional) Is 1 or 0.

PayPal uses this to pre-fill the PayPal membership sign-up portion of the PayPal login page. Limitations: 10-character string.3 Set Express Checkout request parameters Parameter PAGESTYLE Description (Optional) Sets the Custom Payment Page Style for payment pages associated with this button/link. Mail Stop 3. (Optional) Sets the border color around the header of the payment page. (Optional) Sets the background color for the payment page. Limitations: Six-character HTML hexadecimal color code in ASCII. (Optional) A URL for the image you want to appear at the top left of the payment page. Limitations: 30-character string. Example: Bldg. Limitations: 30-character alphanumeric string.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. (Optional) Sets the background color for the header of the payment page. HDRIMG HDRBORDERCOLOR HDRBACKCOLOR PAYFLOWCOLOR EMAIL SHIPTOFIRSTNAME SHIPTOLASTNAME SHIPTOSTREET SHIPTOSTREET2 SHIPTOCITY SHIPTOSTATE 56 Express Checkout for Payflow Pro Reference Transactions . (Optional) Ship-to last name. (Optional) Ship-to street address. (Optional) Ship-to state. which is 750 pixels wide by 90 pixels high. Limitations: 30-character alpha string. PageStyle corresponds to the HTML variable page_style for customizing payment pages The value is the same as the Page Style Name you chose when adding or editing the page style from the Profile subtab of the My Account tab of your PayPal account. PayPal recommends that you provide an image that is stored on a secure (https) server. The border is a two-pixel perimeter around the header space. (Optional) Ship-to first name. (Optional) Extended Ship-to street address. Limitations: 30-character alphanumeric string. The image has a maximum size of 750 pixels wide by 90 pixels high. Limitations: 127-character alphanumeric string. Limitations: Six-character HTML hexadecimal color code in ASCII. Limitations: Six-character HTML hexadecimal color code in ASCII. (Optional) Ship-to city. (Optional) Email address of the customer as entered during checkout. Limitations: 30-character string. 6. Limitations: 127-character string. Limitations: 40-character string.

The token expires after three hours.3 Set Express Checkout request parameters Parameter SHIPTOZIP SHIPTOCOUNTRY SHIPTOPHONENUM Description (Optional) Ship-to postal code. BAID RESULT RESPMSG Express Checkout for Payflow Pro Reference Transactions 57 . Limitations: 19-character string. (Optional) Ship-to country. Limitations: 16-character string. (Optional) Ship-to telephone number. Limitations: Two-character country code. Set Express Checkout Response Parameter Descriptions TABLE A.4 Set Express Checkout response parameters Parameter TOKEN Description A time-stamped value by which you identify to PayPal that you are processing this payment with Express Checkout. Limitations: 20-character string. Response value for the request. If you set TOKEN in the Set Express Checkout request.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. Limitations: 21 characters. the value of TOKEN in the response is identical to the value in the request. The billing agreement ID. Response message in case if any error occurs.

Limitations: One alpha character. Limitations: 127-character alphanumeric string. Limitations: One alpha character. Limitations: One alpha character. Email address of the customer as entered during checkout.6 Get Express Checkout Details response parameters Parameter TOKEN EMAIL PAYERID Description The value returned by Set Express Checkout response. TENDER ACTION TOKEN (Required) The tender type (method of payment). (Optional) Include this parameter to modify an existing Sale or Authorization request. 58 Express Checkout for Payflow Pro Reference Transactions .5 Get Express Checkout Details request parameters Parameter TRXTYPE Description (Required) How you want to obtain payment: A indicates that this payment is an Authorization subject to settlement with the Delayed Capture request O indicates that this payment is an Order subject to settlement with the Delayed Capture request S indicates that this is a final Sale for which you are requesting payment N O T E : You cannot set this value to S in the Set Express Checkout request and then change this value to A on the final Do Express Checkout Payment request. Unique PayPal customer account identification number. Get Express Checkout Details Response Parameter Descriptions TABLE A. Limitations: 13-character string. Limitations: 20-character alphanumeric string. The value is returned in a previous Set Express Checkout response. (Required) Is G to indicate this is a Get Express Checkout Details request. Limitations: 20-character alphanumeric string. It is always P.Express Checkout Parameter Reference Express Checkout Parameter Descriptions Get Express Checkout Details Request Parameter Descriptions TABLE A.

Specify the exact amount to the cent using a decimal point—use 34. which is represented as a positive value. Limitations: 30-character alphanumeric string. PayPal adds the negative balance to the transaction amount. not 34. send DISCOUNT INSURANCEAMT NOTE ADJUSTMENTAMT the amount as 1250 in the Set Express Checkout request and use the returned TOKEN in the Get Express Checkout Details request to see the ADJUSTMENTAMT response as a negative value.199. SHIPTOFIRSTNAME SHIPTOLASTNAME Ship-to first name.00.95 not 1. Do not include comma separators—use 1199. Specify the exact amount to the cent using a decimal point—use 34.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A.00. Values are: verified unverified Limitations: 10-character string. Express Checkout for Payflow Pro Reference Transactions 59 .199.95. A discount or gift certificate offered by PayPal to the buyer.95 not 1.) character.95 not 1. N O T E : To test this value as a negative amount agaist the simulator.199. Limitations: 30-character alphanumeric string. Shipping discount for this order. No currency symbol. Limitations: Nine numeric characers plus decimal (. Ship-to last name. Limitations: 255-character string. Do not include comma separators—use 1199.95. Do not include comma separators—use 1199. Is 0 (default) or 1.00. This amount will be represented by a negative amount. Specify the discount as a positive amount. If the buyer has a negative PayPal account balance. not 34. No currency symbol. Total shipping insurance cost for this order. The negative amount is returned for Payflow merchants. Limitations: Nine numeric characers plus decimal (. Limitations: Nine numeric characers plus decimal (.6 Get Express Checkout Details response parameters Parameter PAYERSTATUS Description Status of customer. Specify the exact amount to the cent using a decimal point—use 34. not 34. NOTE will contain the text entered by the buyer in the Express Checkout flow.95. If ALLOWNOTE is set to 1 in the Set Express Checkout request.) character. No currency symbol.) character.

Ship-to country. Limitations: 32 alphanumeric characters. Free-form field for your own use as set by you in the Set Express Checkout request. Ship-to postal code. If you do not provide an invoice number. Mail Stop 3. Limitations: Nine-character alphanumeric string. Ship-to state. Limitations: 127-character string. Limitations: Two-character country code. Limitations: 10-character string. Limitations: 40-character string. Extended Ship-to street address. Limitations: 30-character string. Customer’s business name. Merchant invoice number. Limitations: 16-character string. Limitations: 30-character string. Example: Bldg. 60 Express Checkout for Payflow Pro Reference Transactions .6 Get Express Checkout Details response parameters Parameter SHIPTOSTREET Description Ship-to street address. 6. the transaction ID (PNREF) will be submitted. The field mask is: xxx-xxx-xxxx (US numbers) +xxxxxxxxxxx (international numbers) Bill-to name. N O T E : The bill-to address details are returned returned only if SHIPTOSTREET2 SHIPTOCITY SHIPTOSTATE SHIPTOZIP SHIPTOCOUNTRY SHIPTOBUSINESS CUSTOM INVNUM PHONENUM BILLTONAME REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. If you include a shipping address and provide a value for the AddressOverride (ADDROVERRIDE) parameter. Account holder’s telephone number. Limitations: 256-character alphanumeric string. PayPal returns this same address in the Get Express Checkout Details response. Limitations: 20-character string. Ship-to city.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A.

COUNTRYNAME Bill-to country name. Limitations: 45 alphanumeric characters. Limitations: Four alphanumeric characters. STATE Bill-to state address. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. zip code or other country-specific postal code. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. COUNTRYCODE Bill-to country code. Limitations: 100 alphanumeric characters. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. STREET2 Second bill-to street address. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout.S. ZIP U.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. Limitations: 45 alphanumeric characters. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. Express Checkout for Payflow Pro Reference Transactions 61 . CITY Bill-to city address. Limitations: 10 alphanumeric characters.6 Get Express Checkout Details response parameters Parameter STREET Description Bill-to street. N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. Limitations: 100 alphanumeric characters.

N O T E : The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. Limitations: One alpha character. Limitations: One alpha character.7 Do Express Checkout Payment request parameters Parameter TRXTYPE Description (Required) How you want to obtain payment: A indicates that this payment is an Authorization subject to settlement with the Delayed Capture request O indicates that this payment is an Order subject to settlement with the Delayed Capture request S indicates that this is a final Sale for which you are requesting payment N O T E : You cannot set this value to S in the Set Express Checkout request and then change this value to A on the final Do Express Checkout Payment request. The values are: Y = confirmed N = unconfirmed The bill-to address details are returned only if REQBILLINGADDRESS is set to 1 in the call to Set Express Checkout. It is always P.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. (Required) Value returned by the Set Express Checkout response. Limitations: One alpha character. Response message in case if any error occurs.6 Get Express Checkout Details response parameters Parameter ADDRESSOWNER Description The eBay company that owns this bill-to address. Response value for the request. Limitations: 20-character string. 62 Express Checkout for Payflow Pro Reference Transactions . RESULT RESPMSG Do Express Checkout Payment Request Parameter Descriptions TABLE A. ADDRESSSTATUS Status of the bill-to address on file with PayPal. Limitations: One alpha character. TENDER TOKEN ACTION (Required) The tender type (method of payment). (Required) Is D to indicate this is a Set Express Checkout request.

L_NAMEn L_DESCn (Optional) Line-item name. (Optional) Your URL for displaying information about this transaction. The merchant invoice number is used for authorizations and settlements and. Specify the exact amount to the cent using a decimal point—use 34. as returned by Get Express Checkout Details response. (Required) Amount. Limitations: 127-character alphanumeric string. If you do not provide an invoice number. Limitations: 2048 alphanumeric characters. Character length and limitations: 36 alphanumeric characters. No currency symbol. will appear on your customer's credit card statement and your bank reconciliation report.7 Do Express Checkout Payment request parameters Parameter PAYERID Description (Required) Unique PayPal customer account identification number. Limitations: 256-character alphanumeric string. depending on your merchant bank. Limitations: 127-character alphanumeric string. Do not include comma separators—use 1199.95 not 1. Limitations: 13-character string. the transaction ID (PNREF) will be submitted. such as receipt. Limitations: Nine alphanumeric characters. if one exists.) character. (Optional) Your URL for receiving Instant Payment Notification (IPN) about this transaction. (Optional) Free-form field for your own use. (Optional) Merchant invoice number. Limitations: 35-character string. N O T E : You can view line item information in the Transaction Details report in your PayPal merchant account. N O T E : If you do not specify NotifyURL in the request.95. shipment tracking.00. This value is returned in the URL when the customer is redirected to your website. Limitations: 32 alphanumeric characters.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. the notification AMT ORDERURL ORDERDESC CUSTOM INVNUM BUTTONSOURCE NOTIFYURL URL from your Merchant Profile is used. (Optional) Line-item description for each different item purchased such as hiking boots or cooking utensils. or order details. (Optional) Identification code for use by third-party applications to identify transactions.199. not 34. Limitations: Nine numeric characers plus decimal (. Express Checkout for Payflow Pro Reference Transactions 63 . (Optional) Description of items the customer is purchasing.

199. not 34.199. Specify the exact amount to the cent using a decimal point—use 34.00.95. Specify the exact amount to the cent using a decimal point—use 34. (Required if L_COSTn is specified) Sum of cost of all items in this order. Limitations: Nine numeric characers plus decimal (.95. Specify the exact amount to the cent using a decimal point—use 34. Do not include comma separators—use 1199. See CURRENCY in this table for details. Limitations: Nine numeric characers plus decimal (.00. No currency symbol. (Required if L_TAXAMTn is specified) Sum of tax for all items in this order. Limitations: 10-character integer. (Optional) Total shipping cost for this order. not 34.00.95 not 1. L_TAXAMTn (Optional) Line-item tax amount.) character. No currency symbol. No currency symbol. Do not include comma separators—use 1199. Nine numeric characters plus decimal. 64 Express Checkout for Payflow Pro Reference Transactions .95. Limitations: Nine numeric characers plus decimal (. Do not include comma separators—use 1199. Limitations: Nine numeric characers plus decimal (. Specify the exact amount to the cent using a decimal point—use 34. not 34. N O T E : You must set CURRENCY to one of the three-character currency L_QTYn ITEMAMT TAXAMT FREIGHTAMT codes for any of the supported PayPal currencies.95. The line-item unit price can be a positive or a negative value but not 0.) character. Do not include comma separators—use 1199.) character.199.95. not 34. Limitations: Nine numeric characers plus decimal (.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. Do not include comma separators—use 1199. (Required if L_COSTn is supplied) Line-item unit quantity.95 not 1.00. No currency symbol.199. N O T E : You must set CURRENCY to one of the three-character currency codes for any of the supported PayPal currencies.7 Do Express Checkout Payment request parameters Parameter L_COSTn Description (Required if L_QTYn is supplied) Cost of the line item. No currency symbol.199. not 34.) character.) character.95 not 1.00. Specify the exact amount to the cent using a decimal point—use 34.95 not 1.95 not 1.

No currency symbol. PayPal returns this same address in the Get Express Checkout Details response. and SHIPTOCOUNTRY. Limitations: 30-character string. Limitations: 10-character string.00.95 not 1.95 not 1.199. Specify the exact amount to the cent using a decimal point—use 34.95. Specify the exact amount to the cent using a decimal point—use 34. Do not include comma separators—use 1199. Limitations: 30-character alphanumeric string (Optional) Ship-to street address.00. Do not include comma separators—use 1199. you also must pass SHIPTOSTREET.95.00. Example: Bldg. DISCOUNT (Optional) Shipping discount for this order.) character. Limitations: Nine numeric characers plus decimal (. INSURANCEAMT SHIPTOFIRSTNAME SHIPTOLASTNAME SHIPTOSTREET SHIPTOSTREET2 SHIPTOCITY SHIPTOSTATE Express Checkout for Payflow Pro Reference Transactions 65 .) character. If SHIPTOSTATE is passed. (Optional) Total shipping insurance cost for this order. not 34. If you include a shipping address and provide a value for the ADDROVERRIDE parameter. Do not include comma separators—use 1199. and SHIPTOCOUNTRY. Specify the exact amount to the cent using a decimal point—use 34. No currency symbol. 6. (Optional) Ship-to state. Limitations: 40-character string. Mail Stop 3. you also must pass SHIPTOSTREET. SHIPTOCITY. Limitations: Nine numeric characers plus decimal (. not 34. (Optional) Ship-to last name. SHIPTOZIP.7 Do Express Checkout Payment request parameters Parameter HANDLINGAMT Description (Optional) Total handling cost for this order.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. SHIPTOSTATE. (Optional) Ship-to city. Specify the discount as a positive amount.199. If SHIPTOCITY is passed.95 not 1. SHIPTOZIP. N O T E : You must set CURRENCY to one of the three-character currency codes for any of the supported PayPal currencies. Limitations: 30-character string. Limitations: Nine numeric characers plus decimal (. not 34.199. (Optional) Ship-to first name.) character. Limitations: 30-character alphanumeric string.95. No currency symbol. (Optional) Extended Ship-to street address.

7 Do Express Checkout Payment request parameters Parameter SHIPTOZIP Description (Optional) Ship-to postal code. Limitations: 20-character string. Processor charge for the transaction. you also must pass SHIPTOSTREET. PPREF PAYMENTTYPE FEEAMT 66 Express Checkout for Payflow Pro Reference Transactions .The payment is made with no delay. Returns one of the following values: instantonly . not 34. and SHIPTOZIP. Unique PayPal transaction ID. Do not include comma separators—use 1199. SHIPTOCITY. If the request ACTION was A (Authorization). any .8 Do Express Checkout Payment response parameters Parameter TOKEN Description A time-stamped value by which you identify to PayPal that you are processing this payment with Express Checkout.95 not 1.199. SHIPTOSTATE. The field mask is: xxx-xxx-xxxx (US numbers) +xxxxxxxxxxx (international numbers) SHIPTOCOUNTRY PHONENUM Do Express Checkout Payment Response Parameter Descriptions TABLE A. If SHIPTOZIP is passed. (Optional) Ship-to country. Limitations: 17-character string. Specify the exact amount to the cent using a decimal point—use 34. Limitations: 20-character string. you should store the value of PPREF if you need to research a specific transaction with PayPal. and SHIPTOCOUNTRY. SHIPTOCITY. SHIPTOSTATE.95. (Optional) Account holder’s telephone number. Limitations: 16-character string. you also must pass SHIPTOSTREET. If SHIPTOCOUNTRY is passed.) character.Express Checkout Parameter Reference Express Checkout Parameter Descriptions TABLE A. Limitations: Nine numeric characers plus decimal (. Limitations: 11 characters. Limitations: Two-character country code.00. No currency symbol.The payment may be made with no delay or the payment is pending (see PENDINGSTATUS).

PENDINGREASON RESULT RESPMSG Do Authorization Parameter Descriptions TABLE A. echeck = The payment is pending because it was made by an eCheck that has not yet cleared. other = The payment is pending for a reason other than those listed above. multi-currency = You do not have a balance in the currency sent. You must manually accept or deny this payment.8 Do Express Checkout Payment response parameters Parameter NOTE Description Is 0 (default) or 1. contact PayPal customer service. For more information. Limitations: 255-character string. intl = The payment is pending because you hold a non-U. Response value for the request. address = The payment is pending 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. go to the Preferences section of your Profile. Express Checkout for Payflow Pro Reference Transactions 67 . verify = The payment is pending because you are not yet verified. the value is A.Express Checkout Parameter Reference Do Authorization Parameter Descriptions TABLE A. account and do not have a withdrawal mechanism. You must manually accept or deny this payment from your Account Overview. Values are: none = No pending reason. If ALLOWNOTE is set to 1 in the Set Express Checkout request. You must verify your account before you can accept this payment. Response message in case if any error occurs. To change your preference. Limitations: One alpha character.9 Do Authorization request parameters Parameter TRXTYPE Description (Required) The type of transaction to perform. The reason the payment is pending. NOTE will contain the text entered by the buyer in the Express Checkout flow. For a Do Authorization. completed = The payment has been completed. and the funds have been added successfully to your account balance.S. and you do not have your Payment Receiving Preferences set to automatically convert and accept this payment.

9 Do Authorization request parameters Parameter TENDER ORIGID Description (Required) The tender type (method of payment). Response message in case if any error occurs.95 not 1. (Required) The tender type (method of payment). Limitations: One alpha character. (Required) Payflow transaction ID. Limitations: One alpha character. Limitations: 12 case-sensitive alphanumeric characters.199. not 34. which indicates that this payment is an Authorization or a Do Authorization subject to settlement with the Delayed Capture request. (Optional) Amount. No currency symbol. TENDER 68 Express Checkout for Payflow Pro Reference Transactions . the amount of the original transaction is sent in the Do Authorization request. It is always P. If you do not pass a value for AMT. Response value for the request. Limitations: One alpha character. Do Reauthorization Parameter Descriptions TABLE A. set this parameter to the value of the PNREF returned in the Do Express Checkout Payment response when Do Express Checkout Payment request was submitted with TRXTYPE=O.Express Checkout Parameter Reference Do Reauthorization Parameter Descriptions TABLE A.95. Limitations: 17-character string.) character. To authorize an Order.00. AMT TABLE A. It is always P.11 Do Reauthorization request parameters Parameter TRXTYPE Description (Required) How you want to obtain payment. Is A. Limitations: Nine numeric characers plus decimal (.10 Do Authorization response parameters Parameter PPREF RESULT RESPMSG Description Unique PayPal transaction ID. Do not include comma separators—use 1199. Specify the exact amount to the cent using a decimal point—use 34.

13 Void request parameters Parameter TRXTYPE TENDER ORIGID Description (Required) Type of transaction to perform. Void Parameter Descriptions TABLE A.11 Do Reauthorization request parameters Parameter ORIGID Description (Required) Payflow transaction ID. Limitations: 255-character string. Limitations: One alpha character. (Required) Payflow transaction ID. Limitations: 12 case-sensitive alphanumeric characters. (Required) Indicates whether this transaction is a Do Reauthorization. Response value for the request. Limitations: 12 case-sensitive alphanumeric characters. Set this parameter to the value of the PNREF returned in the original transaction response when Do Express Checkout Payment request was submitted with TRXTYPE=O. DOREAUTHORIZATION TABLE A. The value is V. which is the value returned in the PNREF in the response to the original transaction when: TRXTYPE=A or TRXTYPE=O. NOTE Express Checkout for Payflow Pro Reference Transactions 69 . Stores the response message.Express Checkout Parameter Reference Void Parameter Descriptions TABLE A.12 Do Reauthorization response parameters Parameter PPREF NOTE RESULT RESPMSG Description Unique PayPal transaction ID. Limitations: One alpha character. Response message in case if any error occurs. (Optional) An informal note about this settlement that is displayed to the customer in email and in the customer’s transaction history Limitations: 255-character string. The value is 1. (Required) The tender type (method of payment). It is always P. Limitations: 17-character string.

Limitations: 12 case-sensitive alphanumeric characters. not 34.95.95 not 1.199. Response value for the request. (Required) The tender type (method of payment). Limitations: 255 alphanumeric characers. Limitations: One alpha character. Do not include comma separators—use 1199. (Required) Payflow transaction ID. Limitations: 17-character string. Response value for the request. No currency symbol.16 Credit response parameters Parameter PPREF RESULT RESPMSG Description Unique PayPal transaction ID.) character. Response message in case if any error occurs. Set this parameter to the value of the PNREF returned in the original Authorization or Order Do Express Checkout Payment transaction response.00. AMT MEMO TABLE A. It is always P. The value is C. Limitations:Nine numeric characers plus decimal (. Response message in case if any error occurs. Limitations: One alpha character. (Optional) Required if the amount to credit differs from the original Sale or Delayed Capture amount. (Optional) Custom memo about the credit. Limitations: 17-character string.15 Credit request parameters Parameter TRXTYPE TENDER ORIGID Description (Required) Type of transaction to perform. Specify the exact amount to the cent using a decimal point—use 34.Express Checkout Parameter Reference Credit Parameter Descriptions TABLE A. 70 Express Checkout for Payflow Pro Reference Transactions .14 Void response parameters Parameter PPREF RESULT RESPMSG Description Unique PayPal transaction ID. Credit Parameter Descriptions TABLE A.

) character. Limitations:Nine numeric characers plus decimal (.00.17 Delayed Capture request parameters Parameter TRXTYPE TENDER ORIGID Description (Required) Type of transaction to perform. Do not include comma separators—use 1199. any . Express Checkout for Payflow Pro Reference Transactions 71 .18 Delayed Capture response parameters Parameter PPREF PAYMENTTYPE Description Unique PayPal transaction ID.95. (Optional) Indicates if this Delayed Capture transaction is the last capture you intend to make.95 not 1.The payment is made with no delay. AMT NOTE CAPTURECOMPLETE TABLE A. (Optional) An informal note about this settlement that is displayed to the customer in email and in the customer’s transaction history Limitations: 255-character string. Limitations: 11 characters. not 34. It is always P.199. No currency symbol. Limitations: One alpha character. Limitations: One alpha character. Set this parameter to the value of the PNREF returned in the original Authorization or Order Do Express Checkout Payment transaction response. The values are: Y (default) N If CAPTURECOMPLETE is Y. Type of payment. (Required) Payflow transaction ID. The value is D. any remaining amount of the original reauthorized transaction is automatically voided. (Optional) Required if the capture amount differs from the original Authorization amount. Limitations: 12 case-sensitive alphanumeric characters. Values are: instantonly .Express Checkout Parameter Reference Delayed Capture Parameter Descriptions Delayed Capture Parameter Descriptions TABLE A. Limitations: 17-character string. Limitations: 12-character alphanumeric string. (Required) The tender type (method of payment). Specify the exact amount to the cent using a decimal point—use 34.The payment may be made with no delay or the payment is pending.

72 Express Checkout for Payflow Pro Reference Transactions .Express Checkout Parameter Reference Delayed Capture Parameter Descriptions TABLE A.18 Delayed Capture response parameters Parameter RESULT RESPMSG Description Response value for the request. Response message in case if any error occurs.

S.B Code 36 124 756 203 208 978 826 344 348 376 392 484 578 554 985 752 702 840 Currency Codes The following currencies are supported for use in transactions. TABLE B. Dollar (default) Express Checkout for Payflow Pro 73 .1 Currencies and Currency Codes Currency Australian Dollar Canadian Dollar Swiss Franc Czech Koruna Danish Krone Euro Pound Sterling Hong Kong Dollar Hungarian Forint Israeli New Sheqel Japanese Yen Mexican Peso Norwegian Krone New Zealand Dollar Polish Zloty Swedish Krona Singapore Dollar U.

B Currency Codes 74 Express Checkout for Payflow Pro .

Country Code BELARUS Table 1: Country Codes Code BY BE BZ BJ BM BT BO BA BW BV BR IO BN BG BF BI KH CM CA CV KY BELGIUM BELIZE BENIN BERMUDA BHUTAN BOLIVIA BOSNIA AND HERZEGOVINA BOTSWANA BOUVET ISLAND BRAZIL BRITISH INDIAN OCEAN TERRITORY BRUNEI DARUSSALAM BULGARIA BURKINA FASO BURUNDI CAMBODIA CAMEROON CANADA CAPE VERDE CAYMAN ISLANDS AFGHANISTAN ÅLAND ISLANDS ALBANIA ALGERIA AMERICAN SAMOA ANDORRA ANGOLA ANGUILLA ANTARCTICA ANTIGUA AND BARBUDA ARGENTINA ARMENIA ARUBA AUSTRALIA AUSTRIA AZERBAIJAN BAHAMAS BAHRAIN BANGLADESH BARBADOS AF AX AL DZ AS AD AO AI AQ AG AR AM AW AU AT AZ BS BH BD BB 75 .C Country Country Codes N O T E : This table lists country codes defined by ISO 3166-1.

Country Codes Country Code Country Code CENTRAL AFRICAN REPUBLIC CHAD CHILE CHINA CHRISTMAS ISLAND COCOS (KEELING) ISLANDS COLOMBIA COMOROS CONGO CONGO. THE DEMOCRATIC REPUBLIC OF THE COOK ISLANDS COSTA RICA COTE D'IVOIRE CROATIA CUBA CYPRUS CZECH REPUBLIC DENMARK DJIBOUTI DOMINICA DOMINICAN REPUBLIC ECUADOR EGYPT EL SALVADOR CF TD CL CN CX CC CO KM CG CD EQUATORIAL GUINEA ERITREA ESTONIA ETHIOPIA FALKLAND ISLANDS (MALVINAS) FAROE ISLANDS FIJI FINLAND FRANCE FRENCH GUIANA FRENCH POLYNESIA FRENCH SOUTHERN TERRITORIES GABON GAMBIA GEORGIA GERMANY GHANA GIBRALTAR GREECE GREENLAND GRENADA GUADELOUPE GUAM GUATEMALA GUERNSEY GQ ER EE ET FK FO FJ FI FR GF PF TF GA GM GE DE GH GI GR GL GD GP GU GT GG CK CR CI HR CU CY CZ DK DJ DM DO EC EG SV 76 .

ISLAMIC REPUBLIC OF IRAQ IRELAND ISLE OF MAN ISRAEL ITALY JAMAICA JAPAN JERSEY JORDAN KAZAKHSTAN KENYA KIRIBATI GN GW GY HT HM VA HN HK HU IS IN ID IR IQ IE IM IL IT JM JP JE JO KZ KE KI KOREA. DEMOCRATIC KP PEOPLE'S REPUBLIC OF 77 . THE FORMER YUGOSLAV REPUBLIC OF MADAGASCAR MALAWI MALAYSIA MALDIVES MALI MALTA MARSHALL ISLANDS MARTINIQUE MAURITANIA MAURITIUS MAYOTTE MEXICO KR KW KG LA LV LB LS LR LY LI LT LU MO MK MG MW MY MV ML MT MH MQ MR MU YT MX KOREA. REPUBLIC OF KUWAIT KYRGYZSTAN LAO PEOPLE'S DEMOCRATIC REPUBLIC LATVIA LEBANON LESOTHO LIBERIA LIBYAN ARAB JAMAHIRIYA LIECHTENSTEIN LITHUANIA LUXEMBOURG MACAO MACEDONIA.Country Code Country Code GUINEA GUINEA-BISSAU GUYANA HAITI HEARD ISLAND AND MCDONALD ISLANDS HOLY SEE (VATICAN CITY STATE) HONDURAS HONG KONG HUNGARY ICELAND INDIA INDONESIA IRAN.

OCCUPIED PANAMA PAPUA NEW GUINEA PARAGUAY PERU PHILIPPINES PITCAIRN POLAND PORTUGAL PUERTO RICO QATAR REUNION ROMANIA RUSSIAN FEDERATION RWANDA SAINT HELENA SAINT KITTS AND NEVIS SAINT LUCIA SAINT PIERRE AND MIQUELON SAINT VINCENT AND THE GRENADINES SAMOA SAN MARINO PW PS PA PG PY PE PH PN PL PT PR QA RE RO RU RW SH KN LC PM VC WS SM 78 . FEDERATED STATES OF MOLDOVA. REPUBLIC OF MONACO MONGOLIA MONTSERRAT MOROCCO MOZAMBIQUE MYANMAR NAMIBIA NAURU NEPAL NETHERLANDS NETHERLANDS ANTILLES NEW CALEDONIA NEW ZEALAND NICARAGUA NIGER NIGERIA NIUE NORFOLK ISLAND NORTHERN MARIANA ISLANDS NORWAY OMAN PAKISTAN FM MD MC MN MS MA MZ MM NA NR NP NL AN NC NZ NI NE NG NU NF MP NO OM PK PALAU PALESTINIAN TERRITORY.Country Codes Country Code Country Code MICRONESIA.

Country Code Country Code SAO TOME AND PRINCIPE SAUDI ARABIA SENEGAL SERBIA AND MONTENEGRO SEYCHELLES SIERRA LEONE SINGAPORE SLOVAKIA SLOVENIA SOLOMON ISLANDS SOMALIA SOUTH AFRICA SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS SPAIN SRI LANKA SUDAN SURINAME SVALBARD AND JAN MAYEN SWAZILAND SWEDEN SWITZERLAND SYRIAN ARAB REPUBLIC TAIWAN. PROVINCE OF CHINA TAJIKISTAN ST SA SN CS SC SL SG SK SI SB SO ZA GS TANZANIA. UNITED REPUBLIC OF THAILAND TIMOR-LESTE TOGO TOKELAU TONGA TRINIDAD AND TOBAGO TUNISIA TURKEY TURKMENISTAN TURKS AND CAICOS ISLANDS TUVALU UGANDA UKRAINE TZ TH TL TG TK TO TT TN TR TM TC TV UG UA AE GB US UM UY UZ VU VE VN ES LK SD SR SJ SZ SE CH SY TW TJ UNITED ARAB EMIRATES UNITED KINGDOM UNITED STATES UNITED STATES MINOR OUTLYING ISLANDS URUGUAY UZBEKISTAN VANUATU VENEZUELA VIET NAM VIRGIN ISLANDS. BRIT.VG ISH 79 .

Country Codes Country Code VIRGIN ISLANDS.S. U. WALLIS AND FUTUNA WESTERN SAHARA YEMEN ZAMBIA ZIMBABWE VI WF EH YE ZM ZW 80 .

63 Israeli New Sheqel 73 J Japanese Yen 73 K Koruna 73 Krona 73 Krone 73 D Danish Krone 73 . 64.Index A ACTION parameter 12. 58. 63 Customer Support 7 CVV2MATCH parameter 37 Czech Koruna 73 I INVNUM parameter 54. 58 Euro 73 Express Checkout ACTION values 12 overview of process 9 Set Express Checkout example 12 Express Checkout flow 11 B BA_CUSTOM parameter 52 BA_DESC parameter 52 BAID parameter 57 BILLINGTYPE parameter 52 BILLTONAME parameter 60 BUTTONSOURCE parameter 63 F FEEAMT parameter 66 Forint 73 H HDRBACKCOLOR parameter 56 HDRBORDERCOLOR parameter 56 HDRIMG parameter 56 Hong Kong Dollar 73 Hungarian Forint 73 C Canadian Dollar 73 CANCELURL parameter 13. 51. 60. 63. 71 CITY parameter 61 COLOR parameter 56 CORRELATIONID parameter 36 COUNTRYCODE parameter 61 COUNTRYNAME parameter 61 currency code format 53. 70. 68. 54. 51 CAPTURECOMPLETE parameter 32. 71 application testing 47 Australian Dollar 73 AVSADDR parameter 62 DISCOUNT parameter 59 E EMAIL parameter 56. 65 currency codes 73 CURRENCY parameter 51 CUSTOM parameter 54. 62 ADDRESSOWNER parameter 62 ADDROVERRIDE parameter 55 ADJUSTMENTAMT parameter 59 AMT parameter 12 AMTparameter 51. 60.

15. 50 INVNUM 54. 63 L_BILLINGAGREEMENTDESCRIPTIONn 52 L_BILLINGTYPEn 52 L_COSTn 53 L_DESCn 53 L_NAMEn 52 L_QTYn 53 L_TAXAMTn 53. 64 LOCALECODE parameter 55 M MAXAMT parameter 54 MEMO parameter 70 Mexican Peso 73 N New Zealand Dollar 73 Norwegian Krone 73 NOSHIPPING parameter 55 NOTE parameter 59. 14. 63 CVV2MATCH 37 DISCOUNT 59 EMAIL 56. 15. 71 PAGESTYLE 56 PARMLIST 49 PARTNER 50 PAYERID 15.Index L L_BILLINGAGREEMENTDESCRIPTIONn parameter 52 L_BILLINGTYPEn parameter 52 L_COSTn parameter 53 L_DESCn parameter 53 L_NAMEn parameter 52 L_QTYn parameter 53 L_TAXAMTn parameter 53. 63 PAYERSTATUS 59 82 Express Checkout for Payflow Pro . 51. 71 CITY 61 COLOR 56 CORRELATIONID 36 COUNTRYCODE 61 COUNTRYNAME 61 CUSTOM 54. 63. 58. 71 P PAGESTYLE parameter 56 PARTNER parameter 50 PAYERID in RETURNURL 15 PAYERID parameter 58. 58. 70. 60. 64 LOCALECODE 55 MAXAMT 54 NOSHIPPING 55 NOTE 69. 70. 60. 51. 62 ADDRESSOWNER 62 ADDROVERRIDE 55 AMT 12. 67. 58 FEEAMT 66. 68. 70. 69. 63 PAYERSTATUS parameter 59 Payflow parameter CURRENCY 51 MEMO 70 Payflow parameters ACTION 12. 63 ORIGID parameter 68. 71 NOTIFYURL parameter 63 O operation testing 47 ORDERDESC parameter 54. 63 ORIGID 38. 69. 71 NOTIFYURL 63 ORDERDESC 54. 69. 68. 71 AVSADDR 62 BA_CUSTOM 52 BA_DESC 52 BAID 57 BILLINGTYPE 52 BILLTONAME 60 BUTTONSOURCE 63 CALCELURL 13 CANCELURL 51 CAPTURECOMPLETE 32. 67 HDRBACKCOLOR 56 HDRBORDERCOLOR 56 HDRIMG 56 HOSTADDRESS 49 HOSTPORT 49.

57. 39 RESULT 35. 60. 68. 71 PayPal-supported currencies 73 PENDINGREASON parameter 67 PHONENUM parameter 60 PNREF 35 format of value 38 PNREF value 38 Polish Zloty 73 Pound Sterling 73 PPREF parameter 36. 71 VENDOR 50 ZIP 61 Payflow parameters ADJUSTMENTAMT 59 Payflow parameters NOTE 59 Payflow Test Account 46 PAYMENTTYPE parameter 66. 62. Dollar 73 R REQBILLINGADDRESS parameter 55 RESPMSG parameter 36 RESPMSG value 39 V VENDOR parameter 50 Express Checkout for Payflow Pro 83 . 65. 51. 71 PROXYADDRESS 49. 65 SHIPTOLASTNAME 56. 71 PENDINGREASON 67 PNREF 35. 58. 68. 60. 70. 65 SHIPTOZIP 57. 70. 70. 38 PPREF 36. 69. 62. 59.Index PAYMENTTYPE 66. 65 SHIPTOLASTNAME parameter 56. 60. 60. 58. 68. 65 SHIPTOZIP parameter 57. 58. 65 SHIPTOPHONENUM 57 SHIPTOSTATE 56. 51 SHIPTOCITY 56. 59. 66 SHIPTOFIRSTNAME parameter 56. 65 SHIPTOSTREETparameter 56. 66 STATE 61 STREET2 61 TENDER 51. 60. 71 U U. 60. 66 SHIPTOFIRSTNAME 56. 70. 66 Singapore Dollar 73 STATE parameter 61 storefront testing 47 STREET 61 STREET2 parameter 61 Swedish Krona 73 Swiss Franc 73 T TENDER 62 TENDER parameter 51. 69. 57. 62. 58. 59. 65 SHIPTOCOUNTRY 57. 60. 15. 38. 60. 62.S. 71 RESULT 35 RESULT value 39 RETURNURL parameter 51 RETURNURLparameter 13 S sale transaction type 28 SHIPTOCITY parameter 56. 60. 68. 65 SHIPTOSTREET 56. 68 TOKEN 14. 65 SHIPTOSTREET2 56. 60. 60. 59. 66. 58. 66 transaction response PNREF parameter 38 RESPMSG parameter 39 RESULT parameter 39 transactions sale 28 TRXTYPE parameter 51. 65 SHIPTOCOUNTRY parameter 57. 65. 66 TRXTYPE 27. 65 SHIPTOSTREET2 parameter 56. 67. 69. 60. 50 PROXYLOGON 49 PROXYPASSWORD 50 PROXYPORT 49 REQBILLINGADDRESS 55 RESPMSG 36. 67. 39 RETURNURL 13. 58. 52. 69. 68 testing operation 47 TOKEN parameter 52. 65 SHIPTOPHONENUM parameter 57 SHIPTOSTATE parameter 56. 66.

Index Y Yen 73 Z ZIP parameter 61 Zloty 73 84 Express Checkout for Payflow Pro .

Sign up to vote on this title
UsefulNot useful