PayPal Payflow - 2009 - Link User's Guide

Payflow Link User’s GuideFor Professional Use OnlyCurrently only available in English.A usage Professional UniquementDisponible en Anglais uniquement

IntroductionWhat is Payflow Link?12 Payflow Link User’s GuideWhat is Payflow Link?Payflow Link is a secure, PayPal-hosted, HTTP-based Internet payment

Payflow Link User’s Guide 3IntroductionHow Payflow Link Works1How Payflow Link WorksYou insert a short bit of HTML text into your Web page. The code c

IntroductionHow Payflow Link Works14 Payflow Link User’s GuideHow it worksThe following steps describe how PayPal Express Checkout works with Payflow

Payflow Link User’s Guide 5IntroductionHow Payflow Link Works1Form 2: Order Form 3: ConfirmationThe Order form enables the customer to enter any addi

IntroductionHow Payflow Link Works16 Payflow Link User’s GuideForm 4: ReceiptReportingAlong with Payflow Link you also receive access to the PayPal Ma

Payflow Link User’s Guide 7IntroductionIntroduction to Integrating with Payflow Link1Introduction to Integrating with Payflow LinkYou follow these ste

IntroductionPayment Types, Credit Cards, and Processing Platforms Supported by Payflow Link18 Payflow Link User’s Guide– Merchant must use one of the

Payflow Link User’s Guide 9IntroductionPayment Types, Credit Cards, and Processing Platforms Supported by Payflow Link1Supported Processing PlatformsP

IntroductionPayment Types, Credit Cards, and Processing Platforms Supported by Payflow Link110 Payflow Link User’s Guide

Payflow Link User’s Guide 112Configuring Payflow LinkOnce you have registered for a Payflow Link account, your first step is to configure Payflow Link

Payflow Link User’s GuideDocument Number: 200004.en_US-200906© 2009 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, Inc.

Configuring Payflow LinkConfiguring Payflow Link Settings212 Payflow Link User’s GuideRequired Fields The fields listed in this section represent info

Payflow Link User’s Guide 13Configuring Payflow LinkConfiguring Payflow Link Settings2AV S The Address Verification Service (AVS) verifies the cardhol

Configuring Payflow LinkConfiguring Payflow Link Settings214 Payflow Link User’s Guide

Payflow Link User’s Guide 153Integrating Your Web Site with Payflow Link (Basic Integration)IMPORTANT: If you currently use Payflow Link and have adde

Integrating Your Web Site with Payflow Link (Basic Integration)Example of a Simple Integration316 Payflow Link User’s Guide<form method="POST&

Payflow Link User’s Guide 174Integrating Your Web Site with Payflow Link (Advanced Integration)IMPORTANT: If you currently use Payflow Link and added

Integrating Your Web Site with Payflow Link (Advanced Integration)Example of a Custom Integration418 Payflow Link User’s Guide<form method="PO

Payflow Link User’s Guide 195Testing Payflow LinkIn Chapter 3, “Integrating Your Web Site with Payflow Link (Basic Integration),” you entered HTML cod

Testing Payflow LinkTesting Credit Card Transactions520 Payflow Link User’s GuidePerforming Test TransactionsTo perform test transactions, perform the

Payflow Link User’s Guide 21Testing Payflow LinkTesting Credit Card Transactions5Table 5.2 lists the general guidelines for specifying amounts. PayPal

Payflow Link User’s Guide iiiContentsThis Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Testing Payflow LinkTesting Credit Card Transactions522 Payflow Link User’s Guide Alternative Methods for Generating Specific Result CodesIn some case

Payflow Link User’s Guide 23Testing Payflow LinkTesting Address Verification Service (AVS)5Testing Address Verification Service (AVS)The PayPal testin

Testing Payflow LinkTesting Card Security Code524 Payflow Link User’s GuideTesting Card Security CodeIf you submit a value for a card security code, t

Payflow Link User’s Guide 256Activating Payflow LinkOnce you have established your internet merchant account with a merchant bank, configured the Payf

Activating Payflow LinkActivating Your Payflow Account626 Payflow Link User’s GuideStep 2 Configure transactions to go to the live Payflow Link server

Payflow Link User’s Guide 277Managing Payflow LinkThis chapter describes how to use PayPal Manager to manage your Payflow Link account settings and tr

Managing Payflow LinkGenerating Reports728 Payflow Link User’s Guide

Payflow Link User’s Guide 298Integrating TeleCheck TransactionsIn addition to accepting credit cards, your Web site can accept TeleCheck electronic ch

Integrating TeleCheck TransactionsData That You Must Post if You Do Not Use Payflow Link’s Order Form830 Payflow Link User’s GuideEnabling Customers t

Payflow Link User’s Guide 31Integrating TeleCheck TransactionsTransaction Results Returned for TeleCheck Transactions8Transaction Results Returned for

Contentsiv Payflow Link User’s GuideVerify that the Transaction Process Mode is set to TEST . . . . . . . . . . . . . . . . 19Performi

Integrating TeleCheck TransactionsTesting TeleCheck Transactions832 Payflow Link User’s GuideTesting TeleCheck TransactionsUse the following test data

Payflow Link User’s Guide 33ATransaction ResponsesWhen a transaction is completed, PayPal returns transaction response information. PayPal Manager dis

Transaction ResponsesRESULT Codes and RESPMSG ValuesA34 Payflow Link User’s GuideRESULT Values for Transaction Declines or ErrorsFor non-zero Results,

Payflow Link User’s Guide 35Transaction ResponsesRESULT Codes and RESPMSG ValuesA13 Referral. Transaction cannot be approved electronically but can be

Transaction ResponsesRESULT Codes and RESPMSG ValuesA36 Payflow Link User’s Guide50 Insufficient funds available in account51 Exceeds per transaction

Payflow Link User’s Guide 37Transaction ResponsesRESULT Codes and RESPMSG ValuesA117 Failed merchant rule check. One or more of the following three fa

Transaction ResponsesRESULT Codes and RESPMSG ValuesA38 Payflow Link User’s Guide402 PIM Adapter Unavailable403 PIM Adapter stream error404 PIM Adapte

Payflow Link User’s Guide 39Transaction ResponsesRESULT Codes and RESPMSG ValuesARESULT Values for Communications ErrorsA RESULT value less than zero

Transaction ResponsesRESULT Codes and RESPMSG ValuesA40 Payflow Link User’s Guide-6 Parameter list format error: & in name-7 Parameter list format

Payflow Link User’s Guide 41Transaction ResponsesRESULT Codes and RESPMSG ValuesA-104 Unexpected transaction state-105 Invalid name value pair request

Payflow Link User’s Guide vContentsCollecting Customer Transaction Data, Option 1 . . . . . . . . . . . . . . . . . . . . . .

Transaction ResponsesRESULT Codes and RESPMSG ValuesA42 Payflow Link User’s GuideAVS Result CodesIMPORTANT: The AVS result is for advice only. Banks d

Payflow Link User’s Guide 43Transaction ResponsesAVS ResultsAAVS ResultsAny one of the following results can appear in the AVS Street Match and AVS ZI

Transaction ResponsesCard Security Code Result CodesA44 Payflow Link User’s GuideFIGURE A.1 Credit card security code locationsCard Security Code Resu

Payflow Link User’s Guide 45Transaction ResponsesCard Security Code Result CodesAProcessors and Credit Cards Supporting Card Security CodePayPal suppo

Transaction ResponsesCard Security Code Result CodesA46 Payflow Link User’s GuideCard-Not-Present EnvironmentIn a card-not-present environment, Americ

Payflow Link User’s Guide 47BSubmitting Transaction Data to the Payflow Link ServerThis chapter is intended for merchants with intermediate or advance

Submitting Transaction Data to the Payflow Link ServerCollecting Customer Transaction Data, Option 1B48 Payflow Link User’s GuideCollecting Customer T

Payflow Link User’s Guide 49Submitting Transaction Data to the Payflow Link ServerCollecting Customer Transaction Data, Option 1BFIGURE B.1 Order form

Submitting Transaction Data to the Payflow Link ServerCollecting Customer Transaction Data, Option 2B50 Payflow Link User’s GuideCollecting Customer T

Payflow Link User’s Guide 51Submitting Transaction Data to the Payflow Link ServerCollecting Customer Transaction Data, Option 2BData That You Must Po

Contentsvi Payflow Link User’s Guide

Submitting Transaction Data to the Payflow Link ServerOptional Transaction DataB52 Payflow Link User’s GuideOptional Transaction DataFor any transacti

Payflow Link User’s Guide 53Submitting Transaction Data to the Payflow Link ServerOptional Transaction DataBCUSTID This string type parameter is inten

Submitting Transaction Data to the Payflow Link ServerReturning Data to Your Web SiteB54 Payflow Link User’s GuideReturning Data to Your Web SiteYou c

Payflow Link User’s Guide 55Submitting Transaction Data to the Payflow Link ServerReturning Data to Your Web SiteBRESULT=0&AUTHCODE=010101&RES

Submitting Transaction Data to the Payflow Link ServerData Returned by the Post and Silent Post FeaturesB56 Payflow Link User’s GuideSilent PostThe Si

Payflow Link User’s Guide 57Submitting Transaction Data to the Payflow Link ServerData Returned by the Post and Silent Post FeaturesBValues Returned W

Submitting Transaction Data to the Payflow Link ServerData Returned by the Post and Silent Post FeaturesB58 Payflow Link User’s GuideValues Returned W

Payflow Link User’s Guide 59Submitting Transaction Data to the Payflow Link ServerParameters That Specify Payflow Link OperationBParameters That Speci

Submitting Transaction Data to the Payflow Link ServerParameters That Specify Payflow Link OperationB60 Payflow Link User’s Guide

Payflow Link User’s Guide 61CAbout the Confirmation Email MessagesYou have the option of sending order confirmation email messages to the customer, to

Payflow Link User’s Guide viiPrefaceThis DocumentPayflow Link User’s Guide is intended for merchants who will integrate Payflow Link with their e-comm

About the Confirmation Email MessagesExample Merchant Email MessageC62 Payflow Link User’s GuideExample Merchant Email MessageFIGURE C.2 Example merch

Payflow Link User’s Guide 63About the Confirmation Email MessagesFields Returned in the Confirmation Email MessageCTransaction InformationINVOICESHIPA

About the Confirmation Email MessagesFields Returned in the Confirmation Email MessageC64 Payflow Link User’s Guide

Payflow Link User’s Guide 65DPayflow Link Transaction TypesPayflow Link supports the following transaction types: TABLE D.1 Transaction typesType Cod

Payflow Link Transaction TypesD66 Payflow Link User’s Guide

Payflow Link User’s Guide 67EFrequently Asked QuestionsUsing Payflow Link with other ApplicationsCan I use Payflow Link with my existing shopping cart

Frequently Asked QuestionsE68 Payflow Link User’s GuideUsing Payflow LinkDoes Payflow Link allow me to customize the display of my order form?Yes. The

Payflow Link User’s Guide 69Frequently Asked QuestionsEI'm using Silent Post to retrieve transaction information. I'm also using the AVS sec

Frequently Asked QuestionsE70 Payflow Link User’s Guide

Payflow Link User’s Guide 71IndexIndexAaccountactivating Payflow Link 25Address Verification Service 42authorization transaction type 65AVS result

PrefaceCustomer Supportviii Payflow Link User’s Guidez Appendix D, “Payflow Link Transaction Types,” describes the two Payflow Link transaction types.

Index72 Payflow Link User’s GuideTTeleCheck transactions, testing 32tender types supported 8test transactions 20testingtransactions, credit card 1

Payflow Link User’s Guide 11IntroductionIMPORTANT: This document is intended for merchants who do not subscribe to PayPal’s Fraud Protection Services.